swiper

您所在的位置:网站首页 标签canvas的有效属性 swiper

swiper

2023-08-12 10:28| 来源: 网络整理| 查看: 265

# swiper

基础库 1.0.0 开始支持,低版本需做兼容处理。

微信 Windows 版:支持

微信 Mac 版:支持

渲染框架支持情况:Skyline (使用最新 Nighly 工具调试)、WebView

# 功能描述

滑块视图容器。其中只可放置swiper-item组件,否则会导致未定义的行为。

# 通用属性 属性 类型 默认值 必填 说明 最低版本 indicator-dots boolean false 否 是否显示面板指示点 1.0.0 indicator-color color rgba(0, 0, 0, .3) 否 指示点颜色 1.1.0 indicator-active-color color #000000 否 当前选中的指示点颜色 1.1.0 autoplay boolean false 否 是否自动切换 1.0.0 current number 0 否 当前所在滑块的 index 1.0.0 interval number 5000 否 自动切换时间间隔 1.0.0 duration number 500 否 滑动动画时长 1.0.0 circular boolean false 否 是否采用衔接滑动 1.0.0 vertical boolean false 否 滑动方向是否为纵向 1.0.0 display-multiple-items number 1 否 同时显示的滑块数量 1.9.0 easing-function string "default" 否 指定 swiper 切换缓动动画类型 2.6.5 合法值 说明 default 默认缓动函数 linear 线性动画 easeInCubic 缓入动画 easeOutCubic 缓出动画 easeInOutCubic 缓入缓出动画 bindchange eventhandle 否 current 改变时会触发 change 事件,event.detail = {current, source} 1.0.0 bindtransition eventhandle 否 swiper-item 的位置发生改变时会触发 transition 事件,event.detail = {dx: dx, dy: dy}。Skyline 仅支持非 worklet 的组件方法作为回调。 2.4.3 bindanimationfinish eventhandle 否 动画结束时会触发 animationfinish 事件,event.detail 同上。Skyline 仅支持非 worklet 的组件方法作为回调。 1.9.0 # Skyline 特有属性 属性 类型 默认值 必填 说明 最低版本 scroll-with-animation boolean true 否 改变 current 时使用动画过渡 2.29.0 cache-extent number 0 否 缓存区域大小,值为 1 表示提前渲染上下各一屏区域(swiper 容器大小) 2.29.0 worklet:onscrollstart worklet 否 滑动开始时触发,仅支持 worklet 作为回调。event.detail = {dx: dx, dy: dy} worklet:onscrollupdate worklet 否 滑动位置更新时触发,仅支持 worklet 作为回调。event.detail = {dx: dx, dy: dy} worklet:onscrollend worklet 否 滑动结束时触发,仅支持 worklet 作为回调。event.detail = {dx: dx, dy: dy} # WebView 特有属性 属性 类型 默认值 必填 说明 最低版本 previous-margin string "0px" 否 前边距,可用于露出前一项的一小部分,接受 px 和 rpx 值 1.9.0 next-margin string "0px" 否 后边距,可用于露出后一项的一小部分,接受 px 和 rpx 值 1.9.0 snap-to-edge boolean false 否 当 swiper-item 的个数大于等于 2,关闭 circular 并且开启 previous-margin 或 next-margin 的时候,可以指定这个边距是否应用到第一个、最后一个元素 2.12.1 # change事件 source 返回值

从 1.4.0 开始,change事件增加 source字段,表示导致变更的原因,可能值如下:

autoplay 自动播放导致swiper变化; touch 用户划动引起swiper变化; 其它原因将用空字符串表示。 # Bug & Tip tip: 如果在 bindchange 的事件回调函数中使用 setData 改变 current 值,则有可能导致 setData 被不停地调用,因而通常情况下请在改变 current 值前检测 source 字段来判断是否是由于用户触摸引起。 tip: 在 mac 小程序上,若当前组件所在的页面或全局开启了 enablePassiveEvent 配置项,该内置组件可能会出现非预期表现(详情参考 enablePassiveEvent 文档) # 示例代码

在开发者工具中预览效果



【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3