Carousel 走马灯
旋转木马,一组轮播的区域。
何时使用
- 当有一组平级的内容。
- 当内容空间不足时,可以用走马灯的形式进行收纳,进行轮播展现。
- 常用于一组图片或卡片轮播。
代码演示
基本
最简单的用法。
import React from 'react';
import ReactDOM from 'react-dom';
import { Carousel } from 'choerodon-ui';
function onChange(a, b, c) {
console.log(a, b, c);
}
ReactDOM.render(
<Carousel afterChange={onChange}>
<div><h3>1</h3></div>
<div><h3>2</h3></div>
<div><h3>3</h3></div>
<div><h3>4</h3></div>
</Carousel>,
document.getElementById('container'));
垂直
垂直显示。
import React from 'react';
import ReactDOM from 'react-dom';
import { Carousel } from 'choerodon-ui';
ReactDOM.render(
<Carousel vertical>
<div>
<h3 style={{ height: 150 }}>1</h3>
</div>
<div>
<h3 style={{ height: 150 }}>2</h3>
</div>
<div>
<h3 style={{ height: 150 }}>3</h3>
</div>
<div>
<h3 style={{ height: 150 }}>4</h3>
</div>
</Carousel>,
document.getElementById('container'),
);
渐显
切换效果为渐显。
import React from 'react';
import ReactDOM from 'react-dom';
import { Carousel } from 'choerodon-ui';
ReactDOM.render(
<Carousel effect="fade">
<div><h3>1</h3></div>
<div><h3>2</h3></div>
<div><h3>3</h3></div>
<div><h3>4</h3></div>
</Carousel>,
document.getElementById('container'));
自动切换
定时切换下一张。
import React from 'react';
import ReactDOM from 'react-dom';
import { Carousel } from 'choerodon-ui';
ReactDOM.render(
<Carousel autoplay>
<div><h3>1</h3></div>
<div><h3>2</h3></div>
<div><h3>3</h3></div>
<div><h3>4</h3></div>
</Carousel>,
document.getElementById('container'));
API
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
afterChange | 切换面板的回调 | function(current) | 无 |
autoplay | 是否自动切换 | boolean | false |
beforeChange | 切换面板的回调 | function(from, to) | 无 |
dots | 是否显示面板指示点 | boolean | true |
easing | 动画效果 | string | linear |
effect | 动画效果函数,可取 scrollx, fade | string | scrollx |
vertical | 垂直显示 | boolean | false |
方法
名称 | 描述 |
---|---|
goTo(slideNumber) | 切换到指定面板 |
next() | 切换到下一面板 |
prev() | 切换到上一面板 |
当前内容版权归 Choerodon UI 或其关联方所有,如需对内容或内容相关联开源项目进行关注与资助,请访问 Choerodon UI .