Element React 中文文档 Element-React Carousel 走马灯

2024-02-25 开发教程 Element React 中文文档 匿名 0

在有限空间内,循环播放同一类型的图片、文字等内容

基础用法

适用广泛的基础用法

结合使用CarouselCarousel.Item标签就得到了一个走马灯。幻灯片的内容是任意的,需要放在Carousel.Item标签中。默认情况下,在鼠标 hover 底部的指示器时就会触发切换。通过设置trigger属性为click,可以达到点击触发的效果。

render() {
return (
<div className="demo-1 small">
<div className="block">
<span className="demonstration">默认 Hover 指示器触发</span>
<Carousel height="150px">
{
[1,2,3,4].map((item, index) => {
return (
<Carousel.Item key={index}>
<h3>{item}</h3>
</Carousel.Item>
)
})
}
</Carousel>
</div>
<div className="block">
<span className="demonstration">Click 指示器触发</span>
<Carousel trigger="click" height="150px">
{
[1,2,3,4].map((item, index) => {
return (
<Carousel.Item key={index}>
<h3>{item}</h3>
</Carousel.Item>
)
})
}
</Carousel>
</div>
</div>
)
}

指示器

可以将指示器的显示位置设置在容器外部

indicator-position属性定义了指示器的位置。默认情况下,它会显示在走马灯内部,设置为outside则会显示在外部;设置为none则不会显示指示器。

render() {
return (
<div className="demo-2 medium">
<Carousel indicatorPosition="outside">
{
[1,2,3,4].map((item, index) => {
return (
<Carousel.Item key={index}>
<h3>{item}</h3>
</Carousel.Item>
)
})
}
</Carousel>
</div>
)
}

切换箭头

可以设置切换箭头的显示时机

arrow属性定义了切换箭头的显示时机。默认情况下,切换箭头只有在鼠标 hover 到走马灯上时才会显示;若将arrow设置为always,则会一直显示;设置为never,则会一直隐藏。

render() {
return (
<div className="demo-3 medium">
<Carousel interval="5000" arrow="always">
{
[1,2,3,4].map((item, index) => {
return (
<Carousel.Item key={index}>
<h3>{item}</h3>
</Carousel.Item>
)
})
}
</Carousel>
</div>
)
}

卡片化

当页面宽度方向空间空余,但高度方向空间匮乏时,可使用卡片风格

type属性设置为card即可启用卡片模式。从交互上来说,卡片模式和一般模式的最大区别在于,可以通过直接点击两侧的幻灯片进行切换。

render() {
return (
<div className="demo-4 medium">
<Carousel interval="4000" type="card" height="200px">
{
[1,2,3,4,5,6].map((item, index) => {
return (
<Carousel.Item key={index}>
<h3>{item}</h3>
</Carousel.Item>
)
})
}
</Carousel>
</div>
)
}

扁平卡片化

统一卡片大小

type属性设置为flatcard即可启用扁平卡片模式。从交互上来说,卡片模式和一般模式的最大区别在于,可以通过直接点击两侧的幻灯片进行切换。

render() {
return (
<div className="demo-4 medium">
<Carousel interval="4000" type="flatcard" height="200px">
{
[1,2,3,4,5,6].map((item, index) => {
return (
<Carousel.Item key={index}>
<h3>{item}</h3>
</Carousel.Item>
)
})
}
</Carousel>
</div>
)
}

Carousel Attributes

参数说明类型可选值默认值
height走马灯的高度number300
initialIndex初始状态激活的幻灯片的索引,从 0 开始number0
trigger指示器的触发方式stringclick
autoplay是否自动切换booleantrue
interval自动切换的时间间隔,单位为毫秒number3000
indicatorPosition指示器的位置stringoutside/none
arrow切换箭头的显示时机stringalways/hover/neverhover
type走马灯的类型stringcard/flatcard

Carousel Events

事件名称说明回调参数
onChange幻灯片切换时触发目前激活的幻灯片的索引,原幻灯片的索引

Carousel Methods

方法名说明参数
setActiveItem手动切换幻灯片需要切换的幻灯片的索引,从 0 开始;或相应 Carousel.Itemname属性值
prev切换至上一张幻灯片
next切换至下一张幻灯片

Carousel-Item Attributes

参数说明类型可选值默认值
name幻灯片的名字,可用作 setActiveItem的参数string