Carousel 走马灯

旋转木马,一组轮播的区域。

何时使用

  • 当有一组平级的内容。
  • 当内容空间不足时,可以用走马灯的形式进行收纳,进行轮播展现。
  • 常用于一组图片或卡片轮播。

代码演示

基本

最简单的用法。

Carousel走马灯 - 图1

  1. import React from 'react';
  2. import ReactDOM from 'react-dom';
  3. import { Carousel } from 'choerodon-ui';
  4. function onChange(a, b, c) {
  5. console.log(a, b, c);
  6. }
  7. ReactDOM.render(
  8. <Carousel afterChange={onChange}>
  9. <div><h3>1</h3></div>
  10. <div><h3>2</h3></div>
  11. <div><h3>3</h3></div>
  12. <div><h3>4</h3></div>
  13. </Carousel>,
  14. document.getElementById('container'));

垂直

垂直显示。

Carousel走马灯 - 图2

  1. import React from 'react';
  2. import ReactDOM from 'react-dom';
  3. import { Carousel } from 'choerodon-ui';
  4. ReactDOM.render(
  5. <Carousel vertical>
  6. <div>
  7. <h3 style={{ height: 150 }}>1</h3>
  8. </div>
  9. <div>
  10. <h3 style={{ height: 150 }}>2</h3>
  11. </div>
  12. <div>
  13. <h3 style={{ height: 150 }}>3</h3>
  14. </div>
  15. <div>
  16. <h3 style={{ height: 150 }}>4</h3>
  17. </div>
  18. </Carousel>,
  19. document.getElementById('container'),
  20. );

渐显

切换效果为渐显。

Carousel走马灯 - 图3

  1. import React from 'react';
  2. import ReactDOM from 'react-dom';
  3. import { Carousel } from 'choerodon-ui';
  4. ReactDOM.render(
  5. <Carousel effect="fade">
  6. <div><h3>1</h3></div>
  7. <div><h3>2</h3></div>
  8. <div><h3>3</h3></div>
  9. <div><h3>4</h3></div>
  10. </Carousel>,
  11. document.getElementById('container'));

自动切换

定时切换下一张。

Carousel走马灯 - 图4

  1. import React from 'react';
  2. import ReactDOM from 'react-dom';
  3. import { Carousel } from 'choerodon-ui';
  4. ReactDOM.render(
  5. <Carousel autoplay>
  6. <div><h3>1</h3></div>
  7. <div><h3>2</h3></div>
  8. <div><h3>3</h3></div>
  9. <div><h3>4</h3></div>
  10. </Carousel>,
  11. document.getElementById('container'));

API

参数说明类型默认值
afterChange切换面板的回调function(current)
autoplay是否自动切换booleanfalse
beforeChange切换面板的回调function(from, to)
dots是否显示面板指示点booleantrue
easing动画效果stringlinear
effect动画效果函数,可取 scrollx, fadestringscrollx
vertical垂直显示booleanfalse

方法

名称描述
goTo(slideNumber)切换到指定面板
next()切换到下一面板
prev()切换到上一面板

更多参数可参考:https://github.com/akiran/react-slick