Carousel 走马灯

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

基础用法

结合 el-carouselel-carousel-item 标签,你就得到一个走马灯。 每个幻灯片的内容都是完全可定制的,你只需要把它放在 el-carousel-item 标签中。 默认情况下,当鼠标悬停在指示器上时,走马灯会切换。 将 trigger 设置为 click,走马灯只会在指示器被点击时切换。

当指示器悬停时切换(默认)
点击指示器时切换

动态模糊 2.6.0

添加动态模糊,为走马灯注入活力和平滑感。

启用动态模糊可以增强走马灯的活力和平滑感。 默认情况下,motion-blur 参数被设置为 false,激活此功能可以提供视觉上引人入胜的体验。

动态模糊切换(默认)

垂直效果

指示器

指示器可以显示在走马灯外部

indicator-position 属性决定了指示器的位置。 默认情况下,它们在走马灯内部,将 indicator-position 设置为 outside 会将它们移到外部;将 indicator-position 设置为 none 会隐藏指示器。

切换箭头

你可以定义箭头的显示时机

arrow 属性决定了箭头的显示时机。 默认情况下,当鼠标悬停在走马灯上时出现。 将 arrow 设置为 alwaysnever 可以永久显示/隐藏箭头。

自动高度

carouselheight 设置为 auto 时,carousel 的高度将根据 carousel item 的高度自动设置。

每个走马灯项目有不同的高度

卡片模式

当页面足够宽但高度有限时,你可以为走马灯激活卡片模式

type 设置为 card 可以激活卡片模式。 除了外观,卡片模式和普通模式最大的区别在于,在卡片模式下,点击两侧的幻灯片可以直接切换走马灯。

垂直布局

默认情况下,directionhorizontal。 通过将 direction 设置为 vertical,让走马灯以垂直方向显示。

普通垂直布局

卡片垂直布局

名称描述类型默认值
高度走马灯的高度string''
initial-index初始激活幻灯片的索引(从0开始)number0
trigger指示器的触发方式枚举悬浮时
autoplay是否自动循环播放幻灯片booleantrue
interval自动循环的间隔,单位为毫秒number3000
indicator-position指示器的位置枚举''
arrow箭头的显示时机枚举悬浮时
type走马灯的类型枚举''
card-scale 2.7.8当类型为 card 时,次要卡片的缩放比例number0.83
loop循环显示项目booleantrue
direction显示方向枚举horizontal
pause-on-hover悬停时暂停自动播放booleantrue
motion-blur 2.6.0为走马灯注入活力和平滑感booleanfalse
名称描述类型
change当活动幻灯片切换时触发,它有两个参数,一个是新活动幻灯片的索引,另一个是旧活动幻灯片的索引Function
名称描述子标签
default自定义默认内容Carousel-Item
方法描述类型
activeIndex 2.7.8活动幻灯片的索引number
setActiveItem手动切换幻灯片,要切换到的幻灯片的索引,从0开始;或相应 el-carousel-itemnameFunction
prev切换到上一张幻灯片Function
next切换到下一张幻灯片Function
名称描述类型默认值
名称项目的名称,可以在 setActiveItem 中使用string''
label相应指示器的文本内容string / number''
名称描述
default自定义默认内容

来源

组件样式文档

贡献者