更新记录

0.0.3（2026-05-07）

优化

• 收敛 demo 视觉风格，移除大面积渐变、强阴影和偏宣传化文案，改为订单编辑场景，展示组件在真实业务页面里的组合方式。
• demo 补充订单摘要指标、处理记录和底部固定操作栏，截图场景更接近实际业务页面。
• readme 补充组件库特性、平台兼容性和按场景归类的组件清单，提升插件市场详情完整度。
• readme 和上架说明补充 HBuilderX、uni-app、uni-app x、Android、iOS 的兼容性版本说明。
• 调整按钮、标签、徽标、加载组件的布局写法，减少 inline-flex 等跨端表现不稳定的 CSS。
• zb-space 移除对 CSS gap 的依赖，改用子元素外边距，提升 App 和小程序端兼容性。
• zb-button 自定义色样式改用 backgroundColor，提升小程序和 App 端样式兼容性。

修复

• 修复 zb-input 多根节点问题，改为单根节点结构，兼容 Vue2 和更严格的跨端编译。
• 修复 zb-input 密码输入对 type=password 的依赖，改为使用原生 password 属性。
• 修复 zb-badge 使用 Number.isNaN 在旧运行环境下可能不兼容的问题。
• zb-toast 同时补充 Vue2 beforeDestroy 和 Vue3 beforeUnmount 清理逻辑。
• zb-safe-area 增加 constant() 兜底写法，兼容部分旧 iOS WebView。

兼容

• 调整插件最低版本声明：uni-app 降至 ^3.0.0，uni-app x 降至 ^4.0.0，减少不必要的版本限制。

0.0.1（2026-05-01）

• 新增基础组件：按钮、输入框、列表单元格、弹层、确认弹窗、Toast、Loading。
• 新增表单基础组件、空状态、标签、徽标、安全区、间距和分割线。

平台兼容性

uni-app(5.08)

uni-app x(5.08)

其他

基础 UI 组件库

zhuanz-uibasic 是一套轻量基础 UI 组件，适合在 uni-app 项目中搭建常见表单、列表和反馈页面。

特性

• 覆盖 16 个常用组件，包含表单录入、列表展示、反馈提示和状态展示。
• 支持 Vue2 / Vue3，兼容 H5、App Vue、微信小程序、支付宝小程序等常见端。
• 样式克制，适合后台、订单、资料编辑、设置页等业务场景。
• 组件依赖少，适合按 uni_modules 方式直接引入。

兼容性版本

平台兼容性

uni-app

uni-app x

安装

将插件目录放入项目：

uni_modules/zhuanz-uibasic

组件清单

示例

<template>
  <view>
    <zb-button text="提交" type="primary" @click="submit" />
    <zb-input v-model="name" placeholder="请输入昵称" clearable />
    <zb-cell title="订单状态" value="已完成" arrow />
  </view>
</template>

说明

Demo 说明

pages/index 使用订单编辑场景展示组件组合，包括订单摘要、客户表单、资料列表、处理记录、底部操作栏、确认弹窗和轻提示。

0.0.3 兼容性优化

• zb-input 改为单根节点结构，兼容 Vue2 和更严格的跨端编译。
• zb-space 不再依赖 CSS gap，改用子元素外边距。
• 组件样式减少 inline-flex、强渐变、强阴影等跨端表现不稳定或偏装饰化的写法。
• 插件最低版本声明调整为 uni-app ^3.0.0、uni-app x ^4.0.0。

0.0.2 增强点

• zb-button 新增 icon、color、loadingText，支持自定义主题色、按钮图标和加载文案。
• zb-input 新增 prefix、suffix、align、readonly、confirmType，支持前后缀、右对齐、只读和确认事件。
• zb-tag 新增 closable 和 close 事件。
• zb-modal 新增 confirmLoading 和 loadingText，支持确认按钮加载态。

常用 API

zb-button

zb-input

zb-modal

当前定位为基础 UI 组件库，不包含复杂业务表单校验。