swiper

2020-02-11 18:42 更新
基礎(chǔ)庫 1.0.0 開始支持本組件。

滑塊視圖容器,其中只可放置 swiper-item 組件,否則會導(dǎo)致未定義的行為。


屬性說明

屬性類型默認值必填說明最低支持版本
indicator-dotsbooleanfalse是否顯示面板指示點1.0.0
indicator-colorstringrgba(0, 0, 0, .3)指示點顏色1.0.0
indicator-active-colorstringrgba(0, 0, 0, 0)當(dāng)前選中的指示點顏色1.0.0
autoplaybooleanfalse是否自動切換1.0.0
currentnumber0當(dāng)前選中滑塊的 index1.0.0
current-item-idstring""當(dāng)前選中滑塊的組件 id,不能與 current 屬性同時指定1.0.0
intervalnumber5000自動切換時間間隔1.0.0
previous-marginstring""前邊距,可用于露出前一項的一小部分,接受 px 和 rpx 值1.0.0
next-marginstring""后邊距,可用于露出后一項的一小部分,接受 px 和 rpx 值1.0.0
display-multiple-itemsnumber1同時顯示的滑塊數(shù)量1.0.0
durationnumber500滑動動畫時長1.0.0
circularbooleanfalse是否循環(huán)播放(首尾銜接)1.0.0
verticalbooleanfalse滑塊放置方向是否為豎直1.0.0
bindchangeeventhandlecurrent 改變時會觸發(fā) change 事件,event.detail = {current, source}1.0.0
bindanimationfinisheventhandle動畫結(jié)束時會觸發(fā) animationfinish 事件,event.detail = {dx, dy}1.0.0
bindtransitioneventhandleswiper-item 產(chǎn)生位移時觸發(fā) transition 事件,event.detail = {dx, dy}1.20.0

change 事件的 source 字段表示導(dǎo)致改變的原因,有如下值:

  • autoplay:自動播放導(dǎo)致 swiper 變化
  • touch: 用戶劃動導(dǎo)致 swiper 變化
  • 空字符串:其他原因


效果示例


代碼示例

<view class="page-section">
  <swiper
    indicator-dots="{{indicatorDots}}"
    autoplay="{{autoplay}}"
    interval="{{interval}}"
    duration="{{duration}}"
  >
    <block tt:for="{{background}}">
      <swiper-item>
        <view class="swiper-item {{item}}"></view>
      </swiper-item>
    </block>
  </swiper>
</view>
<view class="page-section">
  <view class="ttui-cells">
    <view class="ttui-cell">
      <view class="ttui-cell__bd">指示點</view>
      <view class="ttui-cell__ft">
        <switch checked="{{indicatorDots}}" bindchange="changeIndicatorDots" />
      </view>
    </view>
    <view class="ttui-cell">
      <view class="ttui-cell__bd">自動播放</view>
      <view class="ttui-cell__ft">
        <switch checked="{{autoplay}}" bindchange="changeAutoplay" />
      </view>
    </view>
  </view>
</view>
Page({
  data: {
    background: ["demo-text-1", "demo-text-2", "demo-text-3"],
    indicatorDots: true,
    vertical: false,
    autoplay: false,
    interval: 2000,
    duration: 500
  },
  changeIndicatorDots: function(e) {
    this.setData({
      indicatorDots: !this.data.indicatorDots
    });
  },
  changeAutoplay: function(e) {
    this.setData({
      autoplay: !this.data.autoplay
    });
  },
  intervalChange: function(e) {
    this.setData({
      interval: e.detail.value
    });
  },
  durationChange: function(e) {
    this.setData({
      duration: e.detail.value
    });
  }
});


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號