diff --git a/docs/component/swiper.md b/docs/component/swiper.md index 29138433db93ce1f853bb577db537510ccdd1e7c..43f8322c241af60ef73019fb2c7acbadaaf2f115 100644 --- a/docs/component/swiper.md +++ b/docs/component/swiper.md @@ -23,11 +23,12 @@ |acceleration|Boolean|false|当开启时，会根据滑动速度，连续滑动多屏|支付宝小程序| |disable-programmatic-animation|Boolean|false|是否禁用代码变动触发 swiper 切换时使用动画。|支付宝小程序| |display-multiple-items|Number|1|同时显示的滑块数量|支付宝小程序不支持| -|skip-hidden-item-layout|Boolean|false|是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息|5+App、微信小程序| -|disable-touch|Boolean|false|是否禁止用户 touch 操作|支付宝小程序| -|touchable|Boolean|true|是否监听用户的触摸事件|头条小程序| +|skip-hidden-item-layout|Boolean|false|是否跳过未显示的滑块布局，设为 true 可优化复杂情况下的滑动性能，但会丢失隐藏状态滑块的布局信息|5+App、微信小程序| +|disable-touch|Boolean|false|是否禁止用户 touch 操作|App 2.5.5+、H5 2.5.5+、支付宝小程序| +|disable-touch|Boolean|false|是否禁止用户 touch 操作|App 2.5.5+、H5 2.5.5+、支付宝小程序、头条小程序（只在初始化时有效，不能动态变更）| +|touchable|Boolean|true|是否监听用户的触摸事件，只在初始化时有效，不能动态变更|头条小程序（uni-app 2.5.5+ 推荐统一使用 disable-touch）| |easing-function|String|default|指定 swiper 切换缓动动画类型，有效值：default、linear、easeInCubic、easeOutCubic、easeInOutCubic|微信小程序| -|@change|EventHandle||current 改变时会触发 change 事件，event.detail = {current: current, source: source}|| +|@change|EventHandle||current 改变时会触发 change 事件，event.detail = {current: current, source: source}|| |@transition|EventHandle||swiper-item 的位置发生改变时会触发 transition 事件，event.detail = {dx: dx, dy: dy}|5+App、H5、微信小程序、支付宝小程序、头条小程序、QQ小程序| |@animationfinish|EventHandle||动画结束时会触发 animationfinish 事件，event.detail = {current: current, source: source}|头条小程序不支持| @@ -48,7 +49,7 @@ change 事件返回 detail 中包含一个 source 字段，表示导致变更的 - 注意：其中只可放置 ```` 组件，否则会导致未定义的行为。 - 如果遇到current、current-item-id属性设置不生效的问题参考：[组件属性设置不生效解决办法](/use?id=%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98) - banner图的切换效果和指示器的样式，有多种风格可自定义，可在[uni-app插件市场](https://ext.dcloud.net.cn/search?q=%E8%BD%AE%E6%92%AD)搜索 -- swiper在App的vue中、百度支付宝头条QQ小程序中，不支持内嵌video、map等原生组件。在微信基础库2.4.4起和App nvue2.1.5起支持内嵌原生组件。竖向的swiper内嵌视频可实现抖音、映客等视频垂直拖动切换效果。 +- swiper在App的vue中、百度支付宝头条QQ小程序中，不支持内嵌video、map等原生组件。在微信基础库2.4.4起和App nvue2.1.5起支持内嵌原生组件。竖向的swiper内嵌视频可实现抖音、映客等视频垂直拖动切换效果。 - 同时监听 change transition，开始滑动时触发transition, 放开手后，在ios平台触发顺序为 transition... change，Android/微信小程序/支付宝为 transition... change transition... #### swiper-item