组件总览

50 个独立组件包 + 1 个主题包，全部基于 uni-app x / uvue 实现，easycom 自动注册。

基础组件

组件	说明
nax-button	通用按钮。色系与层级参考 ：基础 / 次要 / 次次要 / 次次次要 / 虚线 / 禁用。
nax-text	文本 Text：主题色 / 字号 / 省略 / 加粗 / 装饰 / 模式格式化（价格、手机号、姓名、日期、链接）等。
nax-icon	字体图标。
nax-space	间距容器。横向/纵向排列子项并统一间距。配合 nax-space-item 使用。
nax-line	纯线条（布局分隔）。横/竖、粗细、虚线、语义色；默认走 --nax-color-divider。
nax-divider	内容分割线（可带文字）。与 nax-line 分工：line 只画纯线，本组件负责「文案分隔」。
nax-tag	标签。能力对齐 Tag：类型 / 尺寸 / 边框 / 圆角 / 可关闭 / 可选中。
nax-badge	徽标。
nax-avatar	头像。能力对齐 Avatar：尺寸 / 形状 / 图片 / 文字 / 描边 / 失败回退。

布局组件

组件	说明
nax-cell	单元格。设置项 / 列表行基础。对齐 CellItem + 清单 API。
nax-card	内容卡片。标题 / 额外操作 / 封面 / 页脚插槽，主题 token 背景与边框。
nax-grid	宫格容器。配合 nax-grid-item 使用。
nax-steps	步骤条容器。list 数据驱动或配合 nax-step 组合使用。
nax-list	滚动列表壳：内部 scroll-view 触底加载 + 下拉刷新 + 空/错/底态。虚拟列表见 nax-virtual-list。
nax-virtual-list	固定行高虚拟列表。App 端 spacer 窗口裁剪；Web/小程序固定总高 + translateY（规避滚动锚定连滚）。iOS/鸿蒙滚动合并更新 + scrollend 同步事件。
nax-swipe-action	滑动操作。左滑露出右侧操作按钮；可与 nax-swipe-action-group 互斥展开。
nax-swiper	轮播。基于原生 swiper 封装。

表单组件

组件	说明
nax-input	单行输入框。（不含 select / textarea / idcard）。
nax-search	搜索框。
nax-textarea	多行文本域。
nax-select	列选择器（底部弹层 + picker-view）。
nax-calendar	日历选择器。功能主要对齐 Calendar：单选 / 范围、弹层 / 页面内联、节假日与打卡标记。
nax-datetime-picker	时间选择器（底部弹层 + picker-view）。对齐 DatetimePicker 主能力。
nax-keyboard	自定义键盘：数字 / 车牌号 / 身份证；支持乱序、遮罩弹层与长按退格
nax-switch	开关。用于二选一场景。
nax-slider	滑动选择器。用于表单中选择某一区间值。
nax-checkbox	复选框。可单独使用（v-model 布尔）或置于 nax-checkbox-group 内。
nax-radio	单选框。可单独使用（v-model 布尔）或置于 nax-radio-group 内。
nax-number-box	步进器。用于数量加减
nax-rate	评分。星型满意度评分。
nax-upload	上传。主能力：选图/预览/删除/状态；实际上传在 afterRead 中由业务完成。
nax-form	表单容器。管理 model / rules，提供校验与重置。功能主要对齐 Form。

反馈组件

组件	说明
nax-transition	轻量进退场过渡。预设 fade / slide-up / slide-down / slide-left / slide-right / zoom / fade-up。
nax-loading	局部/区块加载指示。App 端用原生 animate 旋转；Web/小程序用 CSS 动画。
nax-progress	进度条。线形 / 圆形统一入口；props 管行为，外观走 type/size + CSS 变量。
nax-skeleton	骨架屏。头像/标题/段落占位；loading 控制骨架与真实内容切换。
nax-overlay	全屏遮罩层（弹层底层）。半透明蒙层 + 可选默认插槽内容；支持淡入淡出。
nax-picker	通用弹出容器，支持自定义内容；可从底部 / 中间 / 左侧 / 右侧弹出。
nax-popup	压窗屏 / 页面级弹层。
nax-toast	轻提示宿主。全局挂载一次后，业务通过 naxToast() 命令式调用。
nax-dialog	居中对话框：声明式 v-model:show + 命令式 naxDialog()/naxDialogAlert()/naxDialogConfirm()。
nax-action-sheet	底部动作面板：标准操作列表 + 取消。薄封装 nax-picker。
nax-alert	警告提示条（页面内常驻）。能力对齐 AlertTips：类型 / 标题 / 描述 / 图标 / 可关闭 / light|solid。
nax-notice-bar	滚动通告栏，支持 NoticeBar 的水平衔接、水平步进、垂直步进、主题、图标和关闭操作。

导航组件

组件	说明
nax-nav-bar	自定义顶部导航栏。状态栏安全区 + fixed 占位 + 返回栈兜底；微信小程序预留胶囊右侧空间。
nax-tabbar	自定义底部标签栏。图标字体优先、图片次之；轻量徽标；fixed + 占位 + 安全区。
nax-tabs	顶部标签导航。list + v-model；可滚动/均分；指示条；徽标/红点/禁用。内容区由业务自管。
nax-dropdown	筛选栏式下拉菜单容器。配合 nax-dropdown-item；默认单选列表 + 自定义插槽面板。

展示组件

组件	说明
nax-image	图片。基于原生 image 封装，支持加载中 / 失败占位。
nax-empty	空状态。无数据 / 失败 / 搜索无结果等占位。