Sard Uniapp：基于Uniapp和Vue3的多端UI组件库

Sard Uniapp 是一套基于 Uniapp 和 Vue3 框架开发的兼容多端的 UI 组件库，支持 H5、小程序和 App（不支持 nvue 或 uvue），旨在提供高质量、易用的移动端 UI 解决方案。

特性

• 丰富组件：提供 102+ 个高质量组件，覆盖移动端主流场景，满足多样化开发需求。
• 多端兼容：一套代码可同时开发 H5、小程序和 App，提高开发效率，降低维护成本。
• 按需引入：支持 Tree Shaking，允许仅引入所需组件，优化打包体积和性能。
• 完整文档：提供详尽的文档和案例展示，便于快速上手和深入学习。
• 类型安全：使用 TypeScript 编写，提供完整的类型定义，增强代码可靠性和开发体验。
• 主题定制：支持定制主题、国际化、暗黑模式和宽屏模式，适应不同场景和用户偏好。
• 零依赖：不依赖第三方 npm 包，保持轻量级和独立性。
• 高测试覆盖率：单元测试覆盖率超过 80%，保障组件的稳定性和可靠性。

平台兼容性

Sard Uniapp 兼容 uni-app 4.11 版本，支持 Vue2 和 Vue3，在 Chrome、Safari、Android、iOS、鸿蒙等平台运行良好。同时，它兼容微信小程序、支付宝小程序、抖音小程序、百度小程序、快手小程序、京东小程序、QQ小程序、飞书小程序等主流小程序平台，确保广泛的应用覆盖。

更新记录

版本 1.25.5（2025-11-30）

• Bug 修复：修复 image 组件动态展示时无法获取正确尺寸的问题。
• 新功能：
  • Cascader 级联组件新增多选功能，增强数据选择灵活性。
  • 新增对鸿蒙系统的兼容支持。
  • 引入阻止页面滚动功能，有效解决弹窗中的滚动穿透问题。

版本 1.25.4（2025-11-22）

• 新功能：*-input 类组件新增 input 前置/后置插槽，提供更灵活的输入框定制能力。

版本 1.25.3（2025-11-12）

• Bug 修复：修复 iOS 微信端水印渲染失败问题，提升跨平台一致性。

更多历史更新和详细日志，请参考项目的官方更新记录。

如何维护与贡献

开发环境设置

• 前提条件：需要 Node.js 20 或更高版本，建议使用 pnpm 包管理器和 VSCode 编辑器以获得最佳体验。
• 克隆仓库：通过 git clone https://github.com/sutras/sard-uniapp.git 获取源代码。
• 安装依赖：运行 npm install 安装项目依赖。
• 运行开发：执行 npm run dev 启动本地开发服务器，访问生成的链接可查看文档和演示。

常见流程

• 测试：运行 npm run test 执行单元测试，确保代码质量。
• 构建组件库：使用 npm run build 打包组件，生成发布文件。
• 发布：通过 npm run release 发布到 npm，并结合 HBuilderX 发布到 uni-app 插件市场。

项目还提供了详细的维护流程，包括修复问题、新增组件和打包安卓包等步骤，具体可参考项目文档中的说明。这些流程帮助贡献者规范操作，确保项目的持续健康发展。

开源协议

Sard Uniapp 基于 MIT 协议开源，允许用户自由地使用、修改、分发和商业化，促进开源社区的协作与创新。

如需了解更多信息、查看完整文档或参与贡献，请访问 Sard Uniapp 的官方文档站点和 GitHub 仓库。