Carousel 走马灯

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

基础用法

动态模糊 2.6.0

添加动态模糊以给走马灯注入活力和流畅性。

指示器

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

切换箭头

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

自动高度

当 carousel <code>的<code> height 设置为 auto时， carousel 的高度将根据子内容的高度自动设置

卡片模式

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

垂直排列

默认情况下，方向 direction 为水平 horizontal。通过设置 direction 为 vertical 来让走马灯在垂直方向上显示。

Carousel Attributes

属性名	说明	类型	可选值	默认值
height	carousel 的高度	string	—	—
initial-index	初始状态激活的幻灯片的索引，从 0 开始	number	—	0
trigger	指示器的触发方式	string	hover/click	hover
autoplay	是否自动切换	boolean	—	true
interval	自动切换的时间间隔，单位为毫秒	number	—	3000
indicator-position	指示器的位置	string	outside/none	—
arrow	切换箭头的显示时机	string	always/hover/never	hover
type	carousel 的类型	string	card	—
loop	是否循环显示	boolean	-	true
direction	展示的方向	string	horizontal/vertical	horizontal
pause-on-hover	鼠标悬浮时暂停自动切换	boolean	-	true
motion-blur 2.6.0	添加动态模糊以给走马灯注入活力和流畅性。	boolean	-	false

Carousel Events

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

Carousel Methods

方法名	说明	参数
setActiveItem	手动切换幻灯片	需要切换的幻灯片的索引，从 0 开始；或相应 `el-carousel-item` 的 `name` 属性值
prev	切换至上一张幻灯片	—
next	切换至下一张幻灯片	—

Carousel Slots

插槽名	说明	子标签
-	自定义默认内容	Carousel-Item

Carousel-Item Attributes

属性名	说明	类型	可选值	默认值
name	幻灯片的名字，可用作 `setActiveItem` 的参数	string	—	—
label	该幻灯片所对应指示器的文本	string	—	—

Carousel-Item Slots

插槽名	说明
—	自定义默认内容

源代码

组件 • 文档

贡献者

Collapse 折叠面板