您当前的位置: 首页 >  xiangzhihong8 微信小程序

微信小程序之Swiper组件

xiangzhihong8 发布时间:2018-06-10 21:33:50 ,浏览量:4

Swiper

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

属性名类型说明支持版本
indicator-dotsBoolean是否显示面板指示点
indicator-colorColor指示点颜色1.1.0
indicator-active-colorColor选中的指示点颜色1.1.0
currentNumber当前所在滑块的 index1.1.0
autoplayBoolean是否自动切换
current-item-idString当前所在滑块的 item-id ,不能与 current 被同时指定1.9.0
intervalNumber自动切换时间间隔
durationNumber滑动动画时长
circularBoolean是否采用衔接滑动
verticalBoolean滑动方向是否为纵向
previous-marginString前边距,可用于露出前一项的一小部分,接受 px 和 rpx 值 1.9.0
next-marginString后边距,可用于露出后一项的一小部分,接受 px 和 rpx 值 1.9.0
display-multiple-itemsNumber同时显示的滑块数量1.9.0
skip-hidden-item-layoutBoolean是否跳过未显示的滑块布局,设为 true 可优化复杂情况下的滑动性能,但会丢失隐藏状态滑块的布局信息1.9.0
bindchangeEventHandlecurrent 改变时会触发 change 事件,event.detail = {current: current, source: source}
bindanimationfinishEventHandle动画结束时会触发 animationfinish 事件,event.detail 同上1.9.0

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

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

当然,作为一个容器控件,还需要和子组件搭配使用才能起到效果,而就是需要的子组件。

swiper-item

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

属性名类型说明支持版本
item-idString该 swiper-item 的标识符1.9.0

实例

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

            
关注
打赏
查看更多评论