小程序swiper 滑块视图容器

属性名	类型	默认值	说明	最低版本
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

<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),
      })
    }
  }

})

小程序swiper 滑块视图容器

swiper-item

相关推荐