更新记录

2025.0715.2200（2025-07-15） 下载此版本

• 增加轮播项移动时发送事件

2025.0714.2025（2025-07-14） 下载此版本

• 优化调整数据变更时的响应

2025.0707.0950（2025-07-07） 下载此版本

• 优化任意移出方向效果

平台兼容性

云端兼容性

uni-app(4.75)

uni-app x(4.75)

zy-carousel

属性 props

• aspect: String
  • 轮播盒宽高比例配置
  • 默认 16/9
• items: Record<string, any>[]
  • 轮播数据
  • 默认 []
• moveMode: 'lr' | 'tb' | 'any'
  • 轮播方向（左右或上下或任意）
  • 默认 lr（左右）
• moveDuration: Number
  • 移动时常（ms）
  • 默认 600
• moveInterval: Number
  • 自动轮播间隔（ms）
  • 默认 3000，0 停止播放
• indicatorPosition: 'none' | 'top' | 'bottom' | 'left' | 'right'
  • 指示器位置
  • 默认 none
• indicatorDefaultColor: String
  • 指示器默认颜色
  • 默认 #ccc
• indicatorActiveColor: String
  • 指示器激活颜色
  • 默认 #000
• indicatorReadonly: Boolean
  • 指示器是否为只读（只读时，点击无效）
  • 默认 false
• indexesDeep: Number
  • 计算数据项的索引值深度，计算结果为 { nexts: [1,2,3], prevs: [4,5,1] }
  • 默认 1, < 1 等同于不计算

事件 emits

• itemClick: (item : typeof props.items[0], index : number) => void 数据项点击事件