Carousel 走马灯
在有限空间内,循环播放同一类型的图片、文字等内容
基础用法
结合 el-carousel
和 el-carousel-item
标签,你就得到一个走马灯。 每个幻灯片的内容都是完全可定制的,你只需要把它放在 el-carousel-item
标签中。 默认情况下,当鼠标悬停在指示器上时,走马灯会切换。 将 trigger
设置为 click
,走马灯只会在指示器被点击时切换。
动态模糊 2.6.0
添加动态模糊,为走马灯注入活力和平滑感。
启用动态模糊可以增强走马灯的活力和平滑感。 默认情况下,motion-blur
参数被设置为 false
,激活此功能可以提供视觉上引人入胜的体验。
指示器
指示器可以显示在走马灯外部
indicator-position
属性决定了指示器的位置。 默认情况下,它们在走马灯内部,将 indicator-position
设置为 outside
会将它们移到外部;将 indicator-position
设置为 none
会隐藏指示器。
切换箭头
你可以定义箭头的显示时机
arrow
属性决定了箭头的显示时机。 默认情况下,当鼠标悬停在走马灯上时出现。 将 arrow
设置为 always
或 never
可以永久显示/隐藏箭头。
自动高度
当 carousel
的 height
设置为 auto
时,carousel
的高度将根据 carousel item
的高度自动设置。
卡片模式
当页面足够宽但高度有限时,你可以为走马灯激活卡片模式
将 type
设置为 card
可以激活卡片模式。 除了外观,卡片模式和普通模式最大的区别在于,在卡片模式下,点击两侧的幻灯片可以直接切换走马灯。
垂直布局
默认情况下,direction
是 horizontal
。 通过将 direction
设置为 vertical
,让走马灯以垂直方向显示。
Carousel API
Carousel 属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
高度 | 走马灯的高度 | string | '' |
initial-index | 初始激活幻灯片的索引(从0开始) | number | 0 |
trigger | 指示器的触发方式 | 枚举 | 悬浮时 |
autoplay | 是否自动循环播放幻灯片 | boolean | true |
interval | 自动循环的间隔,单位为毫秒 | number | 3000 |
indicator-position | 指示器的位置 | 枚举 | '' |
arrow | 箭头的显示时机 | 枚举 | 悬浮时 |
type | 走马灯的类型 | 枚举 | '' |
card-scale 2.7.8 | 当类型为 card 时,次要卡片的缩放比例 | number | 0.83 |
loop | 循环显示项目 | boolean | true |
direction | 显示方向 | 枚举 | horizontal |
pause-on-hover | 悬停时暂停自动播放 | boolean | true |
motion-blur 2.6.0 | 为走马灯注入活力和平滑感 | boolean | false |
Carousel 事件
名称 | 描述 | 类型 |
---|---|---|
change | 当活动幻灯片切换时触发,它有两个参数,一个是新活动幻灯片的索引,另一个是旧活动幻灯片的索引 | Function |
Carousel 插槽
名称 | 描述 | 子标签 |
---|---|---|
default | 自定义默认内容 | Carousel-Item |
Carousel Exposes
方法 | 描述 | 类型 |
---|---|---|
activeIndex 2.7.8 | 活动幻灯片的索引 | number |
setActiveItem | 手动切换幻灯片,要切换到的幻灯片的索引,从0开始;或相应 el-carousel-item 的 name | Function |
prev | 切换到上一张幻灯片 | Function |
next | 切换到下一张幻灯片 | Function |
Carousel-Item API
Carousel-Item 属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
名称 | 项目的名称,可以在 setActiveItem 中使用 | string | '' |
label | 相应指示器的文本内容 | string / number | '' |
Carousel-Item 插槽
名称 | 描述 |
---|---|
default | 自定义默认内容 |