Slider 轮播图
轮播组件,就是以幻灯片的方式,在页面中横向展示诸多内容的组件。
何时使用
- 轮播内容相互独立,前后在内容以及数据上都不存在逻辑关系。
- 单图轮播:该样式通常用于承载运营 banner,是一个位置相对固定的模块。
- 多图轮播:单元信息浏览。
组件示例
组件属性
| 属性 | 说明 | 类型 | 默认值 | 
|---|---|---|---|
| animation | 用于选择轮播项动效类型,slide:左右滑动、fade:渐变 | 'slide' | 'fade' | 'slide' | 
| arrowDirection  | 控制箭头展示方向 | 'hoz' |'ver' | 'hoz' | 
| arrowPosition | 用于控制箭头位置 | 'inner' | 'outer' | 'inner' | 
| arrowSize | 用于控制箭头大小 | 'medium' | 'large' | 'medium' | 
| arrows | 是否开启轮播项箭头 | boolean | true | 
| autoplay | 用于选择是否自动播放轮播项 | boolean | false | 
| autoplaySpeed | 轮播项自动播放速度,单位:ms | number | 3000 | 
| centerMode | 是否开启居中模式 | boolean | false | 
| diyContents | 用于输入自定义模式数据,仅isDiy设置为true时生效 | any[] | [] | 
| diyContentsRender | 用于渲染自定义模式渲染函数,仅isDiy设置为true时生效 | (item: any, index: number) => ReactNode |  -  | 
| dots | 是否开启导航锚点 | boolean | true | 
| dotsDirection | 导航锚点显示位置 | 'hoz' | 'ver' | 'hoz' | 
| focusOnSelect | 用于多图轮播时,点击选中后自动居中 | boolean | false | 
| images | 用于配置轮播项 | [] | |
| isDiy | 用于开启自定义模式 | boolean | false | 
| lazyLoad | 是否开启懒加载模式 | boolean | false | 
| margin | 用于控制轮播项间距 | number | 10 | 
| slideDirection | 用于控制轮播方向 | 'hoz' | 'ver' | 'hoz' | 
| slideImageHeight | 轮播图高度,单位为px或设置% | string | '300px' | 
| slideImageHeightAuto | 开启轮播项高度自适应(图片时会保持长宽比) | boolean | false | 
| slideImageWidth | 用于设置轮播项宽度 | string | '100%' | 
| slidesToScroll | 用于控制同时滑动的轮播项数量 | number | 1 | 
| slidesToShow | 用于控制同时展示的轮播项数量,当type 属性为multi时生效 | number | 2 | 
| speed | 轮播速度,单位: ms | number | 500 | 
| triggerType | 锚点导航触发方式 | 'click' | 'hover' | 'click' | 
| type | 用于配置轮播方式,single:单项轮播、multi:多项轮播 | 'single' | 'multi' | 'single' |