微信小程序之Swiper组件

Swiper

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

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