码迷,mamicode.com
首页 > 其他好文 > 详细

【swiper】 组件说明

时间:2018-11-01 11:56:53      阅读:1682      评论:0      收藏:0      [点我收藏+]

标签:anim   swipe   str   优化   空字符串   and   原型   rcu   布局   

swiper 滑块视图容器,其原型如下:

 1 <swiper
 2   indicator-dots="[Boolean]"
 3   indicator-color="[Color]"
 4   indicator-active-color="[Color]"
 5   autoplay="[Boolean]"
 6   current="[Number]"
 7   current-item-id="[String]"
 8   interval="[Number]"
 9   duration="[Number]"
10   circular="[Boolean]"
11   vertical="[Boolean]"
12   previous-margin="[String]"
13   next-margin="[String]"
14   display-multiple-items="[Number]"
15   skip-hidden-item-layout="[Boolean]"
16   bindchange="[EventHandle]"
17   bindanimationfinish="[EventHandle]"
18 >
19   <swiper-item item-id="[String]"><!-- 数据内容 --></swiper-item>
20 </swiper>

 

<swiper>组件属性说明:

属性 是否必需 类型 默认值 说明
indicator-dots Boolean false 是否显示面板指示点,默认不显示(分页小圆点)
indicator-color Color rgba(0, 0, 0, .3) 指示点颜色
indicator-active-color Color #000000 当前选中的指示点颜色
autoplay Boolean false 是否自动切换
current Number 0 当前所在滑块的 index
current-item-id String   当前所在滑块的 item-id ,不能与 current 被同时指定
interval Number 5000 自动切换时间间隔
duration Number 500 滑动动画时长
circular Boolean false 是否采用衔接滑动(播到最后时再从第一个开始)
vertical Boolean false 滑动方向是否为纵向
previous-margin String 0px 前边距,可用于露出前一项的一小部分,接受 px 和 rpx 值
next-margin String 0px 后边距,可用于露出后一项的一小部分,接受 px 和 rpx 值
display-multiple-items Number 1 同时显示的滑块数量(比如可以在一屏内显示二个swiper-item,但翻屏时还是一屏一翻)
skip-hidden-item-layout Boolean false 是否跳过未显示的滑块布局,设为 true 可优化复杂情况下的滑动性能,但会丢失隐藏状态滑块的布局信息
bindchange EventHandle  

current 改变时会触发 change 事件

EventHandle函数自带参数event

event.detail = {current: current, source: source}

event.detail.source返回滑块变更的原因,可能值如下:

1) ‘autoplay‘ 自动播放导致swiper变化;

2) ‘touch‘ 用户划动引起swiper变化;

3) 空字符串,表示其他原因。

bindanimationfinish EventHandle   动画结束时会触发,EventHandle函数参数同bindchange

 

<swiper-item>组件属性说明:

属性 是否必须 类型 默认值 说明
item-id String   该 swiper-item 的标识符

 

注意事项:

1)swiper由<swiper>、<swiper-item>两部份组成。

2) swiper内只可放置<swiper-item/>组件,否则会导致未定义的行为。

3)swiper-item组件仅可放置在swiper内,宽高自动设置为100%。

4)如果在 bindchange 的事件回调函数中使用 setData 改变 current 值,则有可能导致 setData 被不停地调用,因而通常情况下请在改变 current 值前检测 source 字段来判断是否是由于用户触摸引起。

【swiper】 组件说明

标签:anim   swipe   str   优化   空字符串   and   原型   rcu   布局   

原文地址:https://www.cnblogs.com/wm218/p/9887285.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!