Skip to content

介绍

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

  • 🎯 指示器:清晰指示当前的轮播状态。
  • 📄 分页器:便于切换到指定页面。
  • 🔄 双向控制:实现多个轮播组件的联动操作。
  • 📦 轮播块:支持灵活的内容区块展示。
  • ♾️ 无限循环:实现无缝、连续的内容播放。
  • ⏯️ 自动播放:自动切换内容,无需手动操作。
  • 🖼️ 缩略图:通过缩略图形式快速预览内容。
  • 📜 滚动条:提供直观的导航方式。

特性

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

示例项目

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

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

文档网站

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

手机预览

wxalih5

Zebra 生态

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

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

贡献指南

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

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

交流群

为了更好地服务开发者社区,我们开设了官方 QQ 交流群,欢迎加入:

QQ群:947159437 点击加入

image

Released under the MIT License.