不二如是 发表于 2018-6-12 14:40:10

035 ∞ 视图容器:swiper

本帖最后由 不二如是 于 2018-6-12 14:40 编辑

http://xxx.fishc.com/forum/201805/02/171248f4zdsipf6d4qjnjl.png

上一讲我们搞定了scroll-view,本次来看swiper。

swiper 滑块视图容器,即轮播组件。

稍后我们会制作一个轮播图,在线调用Lorem Picsum。

Lorem Picsum教程,参看:实用Tips - 32 - 超好用的#贴图网站 |【Lorem Picsum】

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 开始支持,低版本需做兼容处理。)


index.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(持续时长)

index.js:
Page({
data: {
    imgUrls: [
      'https://picsum.photos/500?image=1027',
      'https://picsum.photos/500?image=1026',
      'https://picsum.photos/500?image=1025'
    ],
    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
    })
}
})


如果在 bindchange 的事件回调函数中使用 setData 改变 current 值。

则有可能导致 setData 被不停地调用,因而通常情况下:
请在改变 current 值前检测 source 字段来判断是否是由于用户触摸引起。



课后作业


1、根据注释提示写出对应的代码:
//小程序中要创建滑块视图容器(轮播)可以使用什么组件?

//swiper中通过什么元素可以设置滑块?




答案:
**** Hidden Message *****



如果有收获,别忘了评分{:10_281:} :

http://xxx.fishc.com/forum/201709/19/094516hku92k2g4kefz8ms.gif

这位鱼油,如果喜欢小程序,请订阅 专辑☞(传送门)(不喜欢更要订阅{:10_297:} )

http://xxx.fishc.com/forum/201803/21/151715umqz1qoywp11wjbq.gif

一笙彤 发表于 2020-7-6 15:38:24

0
页: [1]
查看完整版本: 035 ∞ 视图容器:swiper