小程序开发基础-swiper 滑块视图容器

小编 / 达叔小生git

参考官方文档：https://developers.weixin.qq.com/miniprogram/dev/component/github

小程序开发基础-swiper 滑块视图容器

根据官方文档，在本身的程序上运行，并打进代码的效果图，swiper滑块视图容器，是用来展现图片，控制图片的小程序

swiper为滑块视图容器，其实就是轮播图的效果。微信小程序

代码中indicator-dots="{{indicatorDots}}"的效果是用来显示指示点的，就是图片中下方的小圆圈。微信

autoplay="{{autoplay}}"为是否能够自动切换的效果，若是不设置，那就只有一张图片显示到界面中。xss

current="0"为当前显示在哪一个滑块，为啥为0，由于默认值为0，可知从零开始算起嘛。ide

interval="{{interval}}"为自动切换时间的间隔，表示每张图片显示到它设定的时间就开始切换到下一个视图即图片，若是设定为3000即3秒，那么图片展现到3秒后，进入到下一个图片。函数

duration="{{duration}}"为滑动动画时长，怎么理解呢？就是第一张图片切换到第二张图片的时长，即第一张滑出，第二张滑入到完，所用的时间长而已。oop

circular="{{circular}}"为是否采用衔接滑动，怎么理解呢？衔接？若是这个属性不设定，那么若是轮播图是三张图片，第一张展现到第三张即最后展现完，它会返回到第一张，那样的效果会很差看。若是设定了该属性，且为true的话，那么展现完后，直接进入到第一张图的界面。布局

<!--index.wxml-->
<swiper indicator-dots="{{indicatorDots}}" autoplay="{{autoplay}}" interval="{{interval}}" duration="{{duration}}" circular='{{circular}}' current="0">
// 用于展现轮播图效果
  <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

swiper的属性

属性	说明
indicator-dots	表示显示面板的指示点，图片下的小圆圈
indicator-color	表示指示点的颜色
indicator-active-color	表示当前选中的指示点颜色
autoplay	表示为是否自动切换
current	表示当前所在的滑块 `index`
current-item-id	当前所在滑块的 `item-id`，不能与`current`被同时指定
interval	表示自动切换时间间隔
duration	表示为滑动动画时长
circular	表示是否采用衔接滑动
previous-margin	表示前边距，用于露出前一项的一小部分，接受 `px` 和 `rpx` 值，就是在整块模板中露出前一项的一小部分
next-margin	表示后边距，与上述同理
display-multiple-items	表示显示的滑块数量，就是显示多少张图在界面上，默认为`1`，若是定位`2`，那么就两张图片设定在界面上，界面各自分一半
skip-hidden-item-layout	表示是否跳过未显示的滑块布局，设为 `true` 可优化复杂状况下的滑动性能，但会丢失隐藏状态滑块的布局信息
bindchange	`current` 改变时会触发 `change` 事件，`event.detail = {current: current, source: source}`
bindanimationfinish	动画结束时会触发 `animationfinish` 事件，`event.detail` 同上

//index.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: true,
    circular: true,
    autoplay: true,
    interval: 2000,
    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
    })
  }
})

在js中图片资源来源于官方文档，四种改变效果函数，changeIndicatorDots（显示指示点），changeAutoplay（是否自动轮播），intervalChange（展现效果时长），durationChange（切换时间时长）

/**index.wxss**/
.slide-image{
  width: 100%;
}

wxss只是让图片宽度占满父元素而已。

注意事项

检测 source 字段判断是否因为用户触摸引发 ^ v ^

开源github分享

Wechat_small_program_Share 微信小程序分享🙈 Github 欢迎 Star、Fork

结语

本文主要讲解 小程序开发基础-swiper 滑块视图容器
下面我将继续对其余知识深刻讲解，有兴趣能够继续关注
小礼物走一走 or 点赞