更新记录

3.0.2（2025-01-17） 下载此版本

2025-01-17

重要更新 ✨

在组件内部实现中，props 的声明方式已发生调整。这一变化并不影响开发者的使用方法。

此前的实现方式：

withDefaults(defineProps<propsType>(), { ... })

现已更改为传统形式：

defineProps({...})

此次变更涉及以下组件：

• z-swiper
• z-swiper-item
• z-navigation
• z-pagination
• z-scrollbar

该调整旨在提升对 JavaScript 项目的兼容性与友好性。

Bug 修复 ⚙️

• fix(swiper)：⚙️ 修复 小程序中使用特殊切换效果时，transitionend不执行的问题 by @Tanch in #0777fce。
• fix(swiper)：⚙️ 修复 当开启autoplay时，设置delay为0，小程序出现requestAnimationFrame相关异常 by @Tanch in #c9cca9c。
• fix(swiper)：⚙️ 修复 在弹窗中使用swiper时，小程序无法正常计算宽度与高度的问题 by @Tanch in #c40f96。 小程序在弹窗中使用swiper时，需提前设置width,height。具体可参考文档： 小程序在弹窗 popup 中使用 swiper 时的加载问题。

文档更新 ✅

• docs: ✅ 组件文档新增Template 模板 by @Tanch in #57。

3.0.1（2025-01-05） 下载此版本

2025-01-05

Bug 修复 ⚙️

• fix(swiper)：⚙️ 修复 因touchstart touchmove 事件的passive修饰符引起的App端无法滑动的问题 by @Ru1ers in #55，close #52。
• fix(swiper-native)：⚙️ 修复 virtual 模式下二次赋值时，页面不更新的问题 by @Ru1ers in #56。
• fix(swiper)：⚙️ 修复 使用切换效果时，swiperSlideOffset 获取不准确的问题 by @Ru1ers in #56。

文档更新 ✅

• docs: ✅ 组件文档新增Playground 集成codesandbox by @Ru1ers in #53。

3.0.0（2025-01-01） 下载此版本

2025-01-01

重要更新 ✨

zebra-swiper 组件已基于vue3 + TypeScript重构。

zebra-swiper3.0已不再兼容vue2，同时，2.x版本非重大问题，将不再继续维护，且不再提供新功能。得益于vue3的proxy代理机制，zebra-swiper组件在性能上得到较大提升。

有关从2.x迁移至3.0的详细内容，请参考文档从 2.x 迁移。

3.0版本主要做出一下重大变更：

• 1.参数传递的结构性调整
• 2.事件监听机制的优化
• 3.v-model 的使用调整
• 4.loop 逻辑的深度重构
• 5.模块化按需引入

新功能 ✨

• feat(swiper)：✨ zebra-swiper 组件基于vue3 + TypeScript重构 by @Ru1ers in #33。

文档更新 ✅

• docs: ✅ 组件文档基于vitepress重构 by @Ru1ers in #33。3.0文档提供更为完善的使用方法，以及更直观的展现方式。

其他更改

• ci: ⚡ 新增文档自动构建github-page流程。
• ci: ⚡ 新增文档自动上传服务器流程。
• ci: ⚡ 新增组件自动发布github-release流程。

平台兼容性

ZebraSwiper

基于uniapp，兼容多端的高性能轮播组件库，支持多种复杂的 3D 轮播效果。

🔥 文档网站     🚀 zebraUI组件库

介绍

zebra-swiper 是一款兼容多端的高性能轮播组件库，支持多种复杂的 3D 轮播效果。它不仅具备丰富的内置功能，还为开发者提供了极大的灵活性，以适应复杂场景的需求。

特性

• 🧩 多端兼容：全面支持小程序、H5 和 App 平台，实现跨平台一致性。
• 🧩 TypeScript支持：提供完整的TypeScript支持。
• 🎨 创意自定义：通过 creative 特性，开发者可以定制具有独特表现力的轮播效果。
• ⚡ 流畅性能：即使在数据量巨大的情况下，利用virtual特性依然能够实现丝滑的滚动体验。
• 🔧 扩展性强：通过监听特定事件，可以轻松集成和扩展自定义插件模块。
• 🏗️ 模块化设计：功能独立分离，按需加载，确保最小化代码体积。

安装

详细安装方法，可参考文档

npm 方式

# npm
npm i @zebra-ui/swiper

# pnpm
pnpm add @zebra-ui/swiper

easycom方式引入：

// pages.json

{
  "easycom": {
    "autoscan": true,
    "custom": {
      "^z-(.*)": "@zebra-ui/swiper/components/z-$1/z-$1.vue"
    }
  },
 "pages": [...],
 "globalStyle": {...}
}

通过 uni_modules 安装

zebra-swiper已经在uniapp的插件市场发布。

如果使用的IDE为HbuilderX，则可以通过uniapp的插件市场进行项目导入。

uniapp提供了uni_modules自动引入，使用此方法不需要再单独对组件进行引入。

详细安装及使用方法，可参考文档

文档网站

访问以下链接以获取完整的组件库文档和使用指南：

• 📘 zebra-swiper 官方文档
• 📘 zebra-swiper GitHub Pages（备用地址）

示例项目

以下是 zebra-swiper 官方提供的一些示例项目，开发者可以根据需求快速上手：

• 📂 normal：使用 HbuilderX 创建的示例项目，通过 uni_modules 引入 zebra-ui。
• 📂 cli：基于 VSCode 创建，通过 pnpm 引入 zebra-ui 的示例项目。

Zebra 生态

Zebra 官方还维护了多个相关项目，为开发者提供了多样化的工具：

• 🛠️ zebra-ui：基于 UniApp 的多端兼容组件库，采用 Vue 3 + TypeScript + Script Setup 构建。
• 🎨 zebra-color：轻量级、全平台兼容的颜色选择器。
• 🌐 zebra-axios：专为 UniApp 设计的 Axios 适配器，兼容小程序、H5 和 App。

贡献指南

zebra-swiper 目前仍处于初期开发阶段，我们非常欢迎开发者参与项目的完善和优化。您可以通过以下方式为社区做出贡献：

• 🔄 提交 PR：修复问题或添加新功能。
• 🐛 提交 Issues：报告使用中的问题或提出改进建议。
• 🤝 加入 Zebra 团队：与我们一同探索和推进开源项目的发展。

手机预览

预览

交流群

QQ群：947159437 点击加入