swiper 滑块视图容器
收藏我的收藏
收藏基础库 1.0.0 开始支持本组件。
属性说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
indicator-dots | boolean | false | 否 | 是否显示面板指示点。 | 1.0.0 |
indicator-color | Color | rgba(0, 0, 0, .3) | 否 | 指示点颜色。 | 1.0.0 |
indicator-active-color | Color | rgba(0, 0, 0, 0) | 否 | 当前选中的指示点颜色。 | 1.0.0 |
autoplay | boolean | false | 否 | 是 否自动切换。 | 1.0.0 |
current | number | 0 | 否 | 当前选中滑块的索引。 | 1.0.0 |
current-item-id | string | "" | 否 | 当前选中滑块的组件 id，不能与 current 属性同时指定。 | 1.0.0 |
interval | number | 5000 | 否 | 自动切换时间间隔（ms）。 | 1.0.0 |
previous-margin | string | "" | 否 | 前边距，可以用露出前一项的一小部分，支持 px 和 rpx，默认单位是 px。 | 1.0.0 |
next-margin | string | "" | 否 | 后边距，可用于露出后一项的一小部分，支持 px 和 rpx，默认单位是 px。 | 1.0.0 |
display-multiple-items | number | 1 | 否 | 同时显示的滑块数量。 | 1.0.0 |
duration | number | 500 | 否 | 滑动动画时长（ms）。 | 1.0.0 |
circular | boolean | false | 否 | 是否循环播放（首尾衔接）。 | 1.0.0 |
vertical | boolean | false | 否 | 滑块放置方向是否为竖直。 | 1.0.0 |
easing-function | string | "default" | 否 | 2.51.0 | |
bindchange | EventHandle | | 否 | current 改变时触发。 | 1.0.0 |
bindanimationfinish | EventHandle | | 否 | 动画结束时会触发 animationfinish 事件。 | 1.0.0 |
bindtransition | EventHandle | | 否 | swiper-item 产生位移时触发 transition 事件。 | 1.20.0 |
easing-function 的合法值
值 | 说明 | 最低支持版本 |
default | 默认缓动函数 | 2.45.0 |
linear | 线性动画 | 2.45.0 |
easeInCubic | 缓入动画 | 2.45.0 |
easeOutCubic | 缓出动画 | 2.45.0 |
easeInOutCubic | 缓入缓出动画 | 2.45.0 |
bindchange 事件对象的 detail
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
current | number | 当前选中滑块的索引 | 1.0.0 |
source | string | 触发事件的原因 | 1.0.0 |
bindanimationfinish 事件对象的 detail
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
current | number | 当前选中滑块的索引 | 1.0.0 |
source | string | 触发事件的原因 | 1.0.0 |
source 的合法值
bindtransition 事件对象的 detail
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
dx | number | x 方向位移 | 1.20.0 |
dy | number | y 方向位移 | 1.20.0 |
扫码体验
代码示例
Bug & Tip
- •Tip：如果在
bindchange 的回调函数中使用setData来改变 current 值，请在使用前检测source字段判断是否由用户划动引起，避免出现setData重复调用的情况。
