微信小程序之Swiper组件_微信小程序 swiper 滑动时添加事件

Swiper

Swiper是一个滑块容器类组件，主要提供如下的一些属性。

说明：从 1.4.0 版本开始，change事件返回detail中包含一个source字段，表示导致变更的原因，可能值如下：

• autoplay：自动播放导致swiper变化；
• touch：用户划动引起swiper变化；
• 其他原因将用空字符串表示。

当然，作为一个容器控件，还需要和子组件搭配使用才能起到效果，而<swiper-item/>就是需要的子组件。

swiper-item

swiper-item组件的主要属性如下：

实例

下面是官方提供的一个实例，可以在小程序开发工具中预览。
涉及的核心代码有：
swiper.wxml

<swiper indicator-dots="{{indicatorDots}}"
  autoplay="{{autoplay}}" interval="{{interval}}" duration="{{duration}}">
  <block wx:for="{{imgUrls}}">
    <swiper-item>
      <image src="{{item}}" class="slide-image" width="355" height="150"/>
    </swiper-item>
  </block>
</swiper>
<button bindtap="changeIndicatorDots"> indicator-dots </button>
<button bindtap="changeAutoplay"> autoplay </button>
<slider bindchange="intervalChange" show-value min="500" max="2000"/> interval
<slider bindchange="durationChange" show-value min="1000" max="10000"/> duration
1
2
3
4
5
6
7
8
9
10
11
12

swiper.js

Page({
  data: {
    imgUrls: [
      'http://img02.tooopen.com/images/20150928/tooopen_sy_143912755726.jpg',
      'http://img06.tooopen.com/images/20160818/tooopen_sy_175866434296.jpg',
      'http://img06.tooopen.com/images/20160818/tooopen_sy_175833047715.jpg'
    ],
    indicatorDots: false,
    autoplay: false,
    interval: 5000,
    duration: 1000
  },
  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
    })
  }
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

最终的效果如下：

Swiper实现引导页

在移动开发中，我们经常使用ViewPager（Android）和UIScrollView（ios）来实现引导页面，效果如下。

在微信小程序中，借助Swiper和swiper-item组件，我们可以很轻松的实现上面的效果。实现上面的效果主要会用到下面几个文件。

guide.wxml

<swiper indicator-active-color='#fff'  indicator-dots="true">
        <block wx:for="{{imgs}}" wx:for-index="index" wx:key="swiperItem" wx:for-item="item" >
          <swiper-item class="swiper-items"  >
            <image class="swiper-image" src="{{item}}"></image>
            <button class="button-img" bindtap="start" wx:if="{{index == imgs.length - 1}}" >立即体验</button>
          </swiper-item>
        </block>
    </swiper>
1
2
3
4
5
6
7
8

涉及到的样式guide.wxss：

swiper {
      position: absolute;
      height: 100%;
      width: 100%;
    }

    .swiper-image {
      height: 100%;
      width: 100%;
      opacity:0.9;
    }

    .button-img{   
       position: relative;
       bottom: 120px;
       height: 40px;
       width: 120px;
       opacity:0.6;
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

其次是，guide.wxml页面中页面所需要的数据，在guide.js文件的data节点添加如下数据。

data: {
    imgs: [
      "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2522069454.jpg",
      "https://img1.doubanio.com/view/photo/s_ratio_poster/public/p2522778567.jpg",
      "https://img3.doubanio.com/view/photo/s_ratio_poster/public/p2523516430.jpg",
    ],

    img: "http://img.kaiyanapp.com/7ff70fb62f596267ea863e1acb4fa484.jpeg",
  },
1
2
3
4
5
6
7
8
9

当然，当点击“立即体验”按钮后，会跳转到新的页面去，我们可以在js文件中添加相关的跳转逻辑。