Element UI参考手册
组件
Carousel 走马灯
Carousel 走马灯
在有限空间内,循环播放同一类型的图片、文字等内容
基础用法
适用广泛的基础用法
结合使用el-carousel
和el-carousel-item
标签就得到了一个走马灯。幻灯片的内容是任意的,需要放在el-carousel-item
标签中。默认情况下,在鼠标 hover 底部的指示器时就会触发切换。通过设置trigger
属性为click
,可以达到点击触发的效果。
<template>
<div class="block">
<span class="demonstration">默认 Hover 指示器触发</span>
<el-carousel height="150px">
<el-carousel-item v-for="item in 4" :key="item">
<h3>{{ item }}</h3>
</el-carousel-item>
</el-carousel>
</div>
<div class="block">
<span class="demonstration">Click 指示器触发</span>
<el-carousel trigger="click" height="150px">
<el-carousel-item v-for="item in 4" :key="item">
<h3>{{ item }}</h3>
</el-carousel-item>
</el-carousel>
</div>
</template>
<style>
.el-carousel__item h3 {
color: #475669;
font-size: 14px;
opacity: 0.75;
line-height: 150px;
margin: 0;
}
.el-carousel__item:nth-child(2n) {
background-color: #99a9bf;
}
.el-carousel__item:nth-child(2n+1) {
background-color: #d3dce6;
}
</style>
指示器
可以将指示器的显示位置设置在容器外部
indicator-position
属性定义了指示器的位置。默认情况下,它会显示在走马灯内部,设置为outside
则会显示在外部;设置为none
则不会显示指示器。
<template>
<el-carousel indicator-position="outside">
<el-carousel-item v-for="item in 4" :key="item">
<h3>{{ item }}</h3>
</el-carousel-item>
</el-carousel>
</template>
<style>
.el-carousel__item h3 {
color: #475669;
font-size: 18px;
opacity: 0.75;
line-height: 300px;
margin: 0;
}
.el-carousel__item:nth-child(2n) {
background-color: #99a9bf;
}
.el-carousel__item:nth-child(2n+1) {
background-color: #d3dce6;
}
</style>
切换箭头
可以设置切换箭头的显示时机
arrow
属性定义了切换箭头的显示时机。默认情况下,切换箭头只有在鼠标 hover 到走马灯上时才会显示;若将arrow
设置为always
,则会一直显示;设置为never
,则会一直隐藏。
<template>
<el-carousel :interval="5000" arrow="always">
<el-carousel-item v-for="item in 4" :key="item">
<h3>{{ item }}</h3>
</el-carousel-item>
</el-carousel>
</template>
<style>
.el-carousel__item h3 {
color: #475669;
font-size: 18px;
opacity: 0.75;
line-height: 300px;
margin: 0;
}
.el-carousel__item:nth-child(2n) {
background-color: #99a9bf;
}
.el-carousel__item:nth-child(2n+1) {
background-color: #d3dce6;
}
</style>
卡片化
当页面宽度方向空间空余,但高度方向空间匮乏时,可使用卡片风格
将type
属性设置为card
即可启用卡片模式。从交互上来说,卡片模式和一般模式的最大区别在于,可以通过直接点击两侧的幻灯片进行切换。
<template>
<el-carousel :interval="4000" type="card" height="200px">
<el-carousel-item v-for="item in 6" :key="item">
<h3>{{ item }}</h3>
</el-carousel-item>
</el-carousel>
</template>
<style>
.el-carousel__item h3 {
color: #475669;
font-size: 14px;
opacity: 0.75;
line-height: 200px;
margin: 0;
}
.el-carousel__item:nth-child(2n) {
background-color: #99a9bf;
}
.el-carousel__item:nth-child(2n+1) {
background-color: #d3dce6;
}
</style>
Carousel Attributes
参数 |
说明 |
类型 |
可选值 |
默认值 |
---|---|---|---|---|
height |
走马灯的高度 |
string |
— |
— |
initial-index |
初始状态激活的幻灯片的索引,从 0 开始 |
number |
— |
0 |
trigger |
指示器的触发方式 |
string |
click |
— |
autoplay |
是否自动切换 |
boolean |
— |
true |
interval |
自动切换的时间间隔,单位为毫秒 |
number |
— |
3000 |
indicator-position |
指示器的位置 |
string |
outside/none |
— |
arrow |
切换箭头的显示时机 |
string |
always/hover/never |
hover |
type |
走马灯的类型 |
string |
card |
— |
Carousel Events
事件名称 |
说明 |
回调参数 |
---|---|---|
change |
幻灯片切换时触发 |
目前激活的幻灯片的索引,原幻灯片的索引 |
Carousel Methods
方法名 |
说明 |
参数 |
---|---|---|
setActiveItem |
手动切换幻灯片 |
需要切换的幻灯片的索引,从 0 开始;或相应 el-carousel-item的 name 属性值 |
prev |
切换至上一张幻灯片 |
— |
next |
切换至下一张幻灯片 |
— |
Carousel-Item Attributes
参数 |
说明 |
类型 |
可选值 |
默认值 |
---|---|---|---|---|
name |
幻灯片的名字,可用作 setActiveItem 的参数 |
string |
— |
— |
label |
该幻灯片所对应指示器的文本 |
string |
— |
— |
组件相关
Element UI 是一套采用 Vue 2.0 作为基础框架实现的组件库,一套为开发者、设计师和产品经理准备的基于 Vue 2.0 的组件库,提供了配套设计资源,帮助网站快速成型