# 更新记录

# 2.2.5（2022-11-10）

2022-11-10

Feat

cards卡片切换效果新增perSlideRotate，perSlideOffset参数用于控制卡片的偏移距离及旋转角度。
微信小程序中默认使用虚拟节点渲染，即virtualHost: true。

Fix

修复pagination选项开启后，动态控制swiper禁用或启用报错的问题。
修复支付宝小程序 3D 样式失效的问题。

# 2.2.4（2022-09-23）

2022-09-23

Feat

新增noSwiping参数控制是否禁止触摸。当禁止触摸开启时，不可通过滑动切换。可通过自动切换，slideTo等方法切换。

Fix

修复vue3下app触摸无效的问题。
新增触摸事件touchcancel。

# 2.2.3（2022-07-26）

2022-07-26

Feat

卡片切换效果cards新增rotate参数，用于控制卡片切换时是否发生旋转。

Fix

修复微信小程序使用zebra-swiper时，页面无法滚动。
修复app报错toJSON的问题。
修复swiper在vue3中无法自动播放的问题。

# 2.2.2（2022-07-01）

2022-07-01

Feat

兼容PC浏览器端。
初步兼容VUE3。

Fix

修复使用zebra-swiper时，页面无法滚动。（zebra-swiper将不再默认阻止事件冒泡）。

# 2.2.1（2022-03-31）

2022-03-31

Feat

新增changeDirection方法，该方法用于动态改变 swiper 方向。
z-swiper-item新增swiperItemWidth swiperItemHeight 属性，用于在 swiper 无法正确获取宽高的情况下设置 swiper 的宽高（如快手小程序）。

Fix

消除快手小程序 itemPropWxs 的警告。

# 2.2.0（2022-03-21）

2022-03-21

本次更新调整了组件的整体架构及组件入口逻辑。主要为性能优化，不涉及新功能。

不兼容性更新：

z-swiper 的 customStyle 由字符串类型更改为 Object 类型（与z-swiper-item保持一致）。
z-swiper-item 删除了加载的效果。

Fix

修复因数据改变而无法正确触发更新的问题。
修复方法 disable enable 提示未定义的问题。

Perf

组件首次渲染速度优化。
loop 模式处理数据后才开始加载 swiper，确保数据的一致性。
部分同步方法更改为异步，体验更流畅。

# 2.1.4（2022-03-05）

2022-03-05

Feat

高级案例加入开屏页。点击预览 (opens new window)

Fix

修复百度小程序高度计算错误的问题。

# 2.1.3（2022-03-03）

2022-03-03

Feat

新增高级案例模块。
高级案例加入环游地球。点击预览 (opens new window)
微信小程序，qq 小程序使用 wxs 赋值样式。

# 2.1.2（2022-03-02）

2022-03-02

本次改版涉及所有开启 loop 的功能。请更新后删除手动拼接的数据。

Feat

loop 无限循环模式无需再手动拼接数据。

# 2.1.1（2022-03-01）

2022-03-01

Fix

修复字节小程序轮播内容不显示的问题。
修复字节小程序获取位置信息错误的问题。

Docs

文档新增事件。

# 2.1.0（2022-02-27）

2022-02-27

更新须知

使用组件时，需在 z-swiper 标签上以 v-model 的形式传入 list 数据，也就是要循环的列表数据，该属性为强制性，不加会导致意外错误。例：

之前的方式：

<z-swiper>
        <z-swiper-item v-for="(item,index) in list" :key="index">
		<image class="image" :src="item" mode="aspectFill">
		</image>
	</z-swiper-item>
</z-swiper>

现在的方式：

<z-swiper v-model="list"> //这里传入的需和下方循环的保持一致
	<z-swiper-item v-for="(item,index) in list" :key="index">
		<image class="image" :src="item" mode="aspectFill">
		</image>
	</z-swiper-item>
</z-swiper>

这个操作也为 swiper 接管数据操作铺垫，对后续很多新功能非常有用，也为 loop 无限循环的痛点提供了解决方案。

Fix

修复数据为空时报错。
修复请求数据时 swiper 提前初始化的问题。

Feat

新增滚动条功能。

# 2.0.1（2022-02-25）

2022-02-25

Fix

修复插槽内容 class 样式不生效问题。

Feat

新增缩略图功能。

# 2.0.0（2022-02-24）

2022-02-24

Feat

该版本为破坏性改版，无法兼容 1.0。
代码重构，使用模块化将功能分割，大幅提升性能，方便后续维护。
全面对标 swiper 组件，并实现全端兼容。小程序也可实现炫酷的轮播效果。
所有切换效果全部支持 loop 无限循环。
新增全景切换效果。
新增轮播块功能，可自定义显示数量。
新增进度条指示器。

# 1.0.7（2022-01-25）

2022-01-25

Feat

新增轮播切换器功能，可使用默认切换或自定义切换。
示例项目新增切换器的使用及自定义切换器。

# 1.0.6（2022-01-24）

2022-01-24

Chore

示例项目新增指示器的使用及自定义指示器。

# 1.0.5（2022-01-21）

2022-01-21

Docs

README.md 新增手机预览，包含微信，支付宝小程序码，H5 二维码。

# 1.0.4（2022-01-20）

2022-01-20

Style

示例项目首页 px 统一修改为 rpx。

# 1.0.3（2022-01-19）

2022-01-19

Fix

修复轮播设置为纵向时，高度错误的问题。
修复在百度小程序中样式错乱的问题。

# 1.0.2（2022-01-18）

2022-01-18

Docs

README.md 新增 gif 预览图
修复因未知原因引起的 uni_modules 组件上传错误的问题。

# 1.0.1（2022-01-14）

2022-01-14

Feature

新增 zebra-swiper, zebra-swiper-item 组件。
新增多种 3D 切换效果。包括渐变，方块，3D 流，翻转，卡片，创意性等多种切换效果。
新增示例项目，包含多种切换效果示例。

← 常见问题