| 属性名 | 类型 | 默认值 | 说明 | 最低版本 |
|---|---|---|---|---|
| indicator-dots | Boolean | false | 是否显示面板指示点 | |
| indicator-color | Color | rgba(0, 0, 0, .3) | 指示点颜色 | 1.1.0 |
| indicator-active-color | Color | #000000 | 当前选中的指示点颜色 | 1.1.0 |
| autoplay | Boolean | false | 是否自动切换 | |
| current | Number | 0 | 当前所在滑块的 index | |
| current-item-id | String | "" | 当前所在滑块的 item-id ，不能与 current 被同时指定 | 1.9.0 |
| interval | Number | 5000 | 自动切换时间间隔 | |
| duration | Number | 500 | 滑动动画时长 | |
| circular | Boolean | false | 是否采用衔接滑动 | |
| vertical | Boolean | false | 滑动方向是否为纵向 | |
| previous-margin | String | "0px" | 前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值 | 1.9.0 |
| next-margin | String | "0px" | 后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值 | 1.9.0 |
| display-multiple-items | Number | 1 | 同时显示的滑块数量 | 1.9.0 |
| skip-hidden-item-layout | Boolean | false | 是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息 | 1.9.0 |
| bindchange | EventHandle | current 改变时会触发 change 事件，event.detail = {current: current, source: source} | ||
| bindanimationfinish | EventHandle | 动画结束时会触发 animationfinish 事件，event.detail 同上 | 1.9.0 |
从 1.4.0 开始，change事件返回detail中包含一个source字段，表示导致变更的原因，可能值如下：
autoplay自动播放导致swiper变化；touch用户划动引起swiper变化；- 其他原因将用空字符串表示。
注意：其中只可放置<swiper-item/>组件，否则会导致未定义的行为。
swiper-item
仅可放置在<swiper/>组件中，宽高自动设置为100%。
| 属性名 | 类型 | 默认值 | 说明 | 最低版本 |
|---|---|---|---|---|
| item-id | String | "" | 该 swiper-item 的标识符 | 1.9.0 |
示例代码：
pasting
<!-- autoplay:是否自动切换 current:当前所在滑块的index circular:是否采用衔接滑动 indicator-dots:是否显示面板指示点 -->
<swiper indicator-dots="{{banner.length>0}}" autoplay="true" current="{{currentSwiper}}" circular="true" class="zwt_swiper">
<block wx:for="{{banner}}" >
<swiper-item bindtap="webfn" data-url="{{item.link}}">
<image src="{{item.pic}}" mode="aspectFit" class='slide-image' />
</swiper-item>
</block>
</swiper>
let app = getApp();
Page({
data: {
currentSwiper: 0,
banner: [{
"pic": "http://src.leju.com/imp/imp/deal/d9/d4/e/80fa4f5075848ec36393afc0fdd_p46_mk48.jpeg",
"link": "https://m.leju.com/news-bj-6450614724957876758.html"
},
{
"pic": "http://src.leju.com/imp/imp/deal/26/4b/1/5a319403d781e609820990a7237_p46_mk48.jpeg",
"link": "https://m.leju.com/news-bj-6448801379690787539.html"
},
{
"pic": "http://src.leju.com/imp/imp/deal/8e/51/2/d7b2358a9a424edbb3c1acbad6a_p46_mk48.jpeg",
"link": "https://m.leju.com/news-bj-6448446556718019431.html"
}
]
},
// H5跳转
webfn: function (e) {
var url = e.currentTarget.dataset.url;
if (url) {
wx.navigateTo({
url: '/pages/webhtml/webhtml?url=' + encodeURIComponent(url),
})
}
}
})
