• swiper
  • swiper-item
    • Bug & Tip

    swiper

    滑块视图容器。

    属性名类型默认值说明
    indicator-dotsBooleanfalse是否显示面板指示点
    indicator-colorColorrgba(0, 0, 0, .3)指示点颜色
    indicator-active-colorColor#000000当前选中的指示点颜色
    autoplayBooleanfalse是否自动切换
    currentNumber0当前所在滑块的 index
    current-item-idString""当前所在滑块的 item-id ，不能与 current 被同时指定
    intervalNumber5000自动切换时间间隔
    durationNumber500滑动动画时长
    circularBooleanfalse是否采用衔接滑动
    verticalBooleanfalse滑动方向是否为纵向
    previous-marginString"0px"前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值
    next-marginString"0px"后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值
    display-multiple-itemsNumber1同时显示的滑块数量
    skip-hidden-item-layoutBooleanfalse是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
    bindchangeEventHandlecurrent 改变时会触发 change 事件，event.detail = {current: current, source: source}
    bindtransitionEventHandleswiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy}
    bindanimationfinishEventHandle动画结束时会触发 animationfinish 事件，event.detail 同上

    change事件返回detail中包含一个source字段，表示导致变更的原因，可能值如下：

    • autoplay 自动播放导致swiper变化；
    • touch 用户划动引起swiper变化；
    • 其他原因将用空字符串表示。注意：其中只可放置<swiper-item/>组件，否则会导致未定义的行为。

    swiper-item

    仅可放置在<swiper>组件中，宽高自动设置为100%。

    属性名类型默认值说明
    item-idString""该 swiper-item 的标识符
    1. <swiper
    2.   indicator-dots="{{indicatorDots}}"
    3.   autoplay="{{autoplay}}"
    4.   interval="{{interval}}"
    5.   duration="{{duration}}"
    6. >
    7.   <block qq:for="{{imgUrls}}">
    8.     <swiper-item>
    9.       <image src="{{item}}" class="slide-image" width="355" height="150" />
    10.     </swiper-item>
    11.   </block>
    12. </swiper>
    13. <button bindtap="changeIndicatorDots">indicator-dots</button>
    14. <button bindtap="changeAutoplay">autoplay</button>
    15. <slider bindchange="intervalChange" show-value min="500" max="2000" />
    16. interval
    17. <slider bindchange="durationChange" show-value min="1000" max="10000" />
    18. duration
    1. Page({
    2.   data: {
    3.     imgUrls: [
    4.       'https://img02.tooopen.com/images/20150928/tooopen_sy_143912755726.jpg',
    5.       'https://img06.tooopen.com/images/20160818/tooopen_sy_175866434296.jpg',
    6.       'https://img06.tooopen.com/images/20160818/tooopen_sy_175833047715.jpg'
    7.     ],
    8.     indicatorDots: false,
    9.     autoplay: false,
    10.     interval: 5000,
    11.     duration: 1000
    12.   },
    13.   changeIndicatorDots(e) {
    14.     this.setData({
    15.       indicatorDots: !this.data.indicatorDots
    16.     })
    17.   },
    18.   changeAutoplay(e) {
    19.     this.setData({
    20.       autoplay: !this.data.autoplay
    21.     })
    22.   },
    23.   intervalChange(e) {
    24.     this.setData({
    25.       interval: e.detail.value
    26.     })
    27.   },
    28.   durationChange(e) {
    29.     this.setData({
    30.       duration: e.detail.value
    31.     })
    32.   }
    33. })
    Bug & Tip
    • tip: 如果在 bindchange 的事件回调函数中使用 setData 改变 current 值，则有可能导致 setData 被不停地调用，因而通常情况下请在改变 current 值前检测 source 字段来判断是否是由于用户触摸引起。