Swiper属性全解析:快速掌握滑块视图核心配置!(2.3补充细节,详细文档在uniapp官网)

本文精讲Swiper所有属性,无需繁琐说明,直接上干货!


📌 基础显示控制

属性 类型 默认值 说明
indicator-dots Boolean false 是否显示面板指示点
indicator-color Color rgba(0, 0, 0, .3) 指示点颜色
indicator-active-color Color #000000 当前选中指示点颜色

🔄 自动播放设置

属性 类型 默认值 说明
autoplay Boolean false 是否自动切换
interval Number 5000 自动切换时间间隔(ms)
circular Boolean false 是否循环播放

🎯 滑动控制属性

属性 类型 默认值 说明
current Number 0 当前所在滑块的index
duration Number 500 滑动动画时长(ms)
vertical Boolean false 是否纵向滑动
disable-touch Boolean false 是否禁止用户触摸操作

👀 视觉布局特效

属性 类型 默认值 说明 平台限制
previous-margin String 0px 前边距,露出前一项部分内容 部分平台不支持
next-margin String 0px 后边距,露出后一项部分内容 部分平台不支持
display-multiple-items Number 1 同时显示的滑块数量 部分平台不支持

💡 高级功能属性

属性 类型 默认值 说明 平台
acceleration Boolean false 根据滑动速度连续滑动多屏 支付宝
active-class String - swiper-item可见时的class 支付宝
changing-class String - 滑动过程中的可见class 支付宝

📢 事件监听处理

事件 触发时机 返回值
@change current改变时 {current, source}
@transition 位置改变时 {dx, dy}
@animationfinish 动画结束时 {current, source}

⚠️ 重要提醒

  • previous-marginnext-margin:app-nvue、抖音、飞书小程序不支持
  • display-multiple-items:app-nvue、支付宝、小红书小程序不支持
  • 使用前请确认目标平台的兼容性!

💡 收藏本文,开发时随时查阅!如有疑问欢迎留言讨论~

相关推荐
Emily156853598702 小时前
Emerson 1C31129G03 Analog Input Module
java·开发语言·前端·plc·emerson·1c31129g03·input module
Ai-_Man3 小时前
希望大家能推荐一款软件,可以直接把文心生成的代码变流程图,提高办公效率
人工智能·ai·小程序·流程图
To_OC7 小时前
面试被问了三回三栏布局,这次我终于把 BFC 那层窗户纸捅破了
前端·css·面试
To_OC7 小时前
啃完 TS 工具类型我发现:Pick 和 Omit 原来就是一层窗户纸
前端·面试·typescript
Chengbei118 小时前
DSH渗透测试插件dsh-pentest全新升级!适配DeepSeek Harness,可视化探索链路,一键搭建轻量化AI渗透测试环境。
人工智能·web安全·网络安全·微信·小程序·系统安全·安全架构
风月说与山鬼9 小时前
三、大括号语法
前端·react.js
kyriewen9 小时前
我把最常踩的8个CORS跨域报错整理了一遍——第8个去年还不存在
前端·javascript
Csvn9 小时前
🕰️ 闭包 + setTimeout 的 5 个经典陷阱:为什么定时器看到的永远不是最新的值?
前端
lilian23310 小时前
Harmony os 技术实战|拼豆制图27:用单字符编码承载 50 张 70×70 图纸
前端·数据库·华为·harmonyos