swiper

滑块视图容器。

属性名类型默认值说明
indicator-dotsBooleanfalse是否显示面板指示点
indicator-colorColorrgba(0, 0, 0, .3)指示点颜色
indicator-active-colorColor#000000当前选中的指示点颜色
autoplayBooleanfalse是否自动切换
currentNumber0当前所在滑块的 index
current-item-idString""当前所在滑块的 item-id ，不能与 current 被同时指定
intervalNumber5000自动切换时间间隔
durationNumber500滑动动画时长
circularBooleanfalse是否采用衔接滑动
verticalBooleanfalse滑动方向是否为纵向
previous-marginString"0px"前边距，可用于露出前一项的一小部分，接受 px 和 rpx 值
next-marginString"0px"后边距，可用于露出后一项的一小部分，接受 px 和 rpx 值
display-multiple-itemsNumber1同时显示的滑块数量
skip-hidden-item-layoutBooleanfalse是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息
bindchangeEventHandlecurrent改变时会触发 change 事件，event.detail = {current: current, source: source}
bindanimationfinishEventHandle动画结束时会触发 animationfinish 事件，event.detail 同上

change 事件返回 detail 中包含一个 source 字段，表示导致变更的原因，可能值如下：

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

swiper-item

仅可放置在 <swiper/> 组件中，宽高自动设置为 100%。

属性名类型默认值说明
item-idString""该 swiper-item 的标识符

示例代码：

  1. <!--swiper.jxml-->
  2. <swiper
  3.     indicator-dots
  4.     indicator-color="rgba(0,0,0,.5)"
  5.     indicator-active-color="#000"
  6.     current="{{current}}"
  7.     interval="5000"
  8.     duration="500"
  9. >
  10.   <block jd:for="{{background}}" jd:key="*this">
  11.      <swiper-item item-id="{{'swiperItem' + index}}">
  12.          <view current-item-id="item" class="swiper-item {{item}}"></view>
  13.      </swiper-item>
  14.   </block>
  15. </swiper>

swiper - 图1

Bug & Tip

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