更新记录

0.2.0（2026-09-04） 下载此版本

  • value prop 支持 number 类型（[String, Number]）：数字值直接渲染（含 0）；hasValue 数字直接视为有值（仅空串为无值）

0.1.5（2026-08-18） 下载此版本

  • 蒸汽模式（VUE3-VAPOR）兼容修复：nax-cell-group inset 模式组头内缩的 1 条下级选择器规则用 CSS 条件编译隔离，消除 "Invalid selector" 警告；VDOM/Web/小程序行为不变
  • 蒸汽模式兼容：lines CSS 声明改回 <text> 的 :max-lines 属性（官方蒸汽模式方案），消除 Vapor 运行时与 CSS 编译器警告

0.1.3（2026-08-14） 下载此版本

  • readme 统一主题小节：通过 CSS 变量覆盖表格（button 风格），补充组件可覆盖的主题 Token
查看更多

平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

其他

多语言 暗黑模式 宽屏模式
× √ ×

nax-cell

单元格与单元格组。

用法

<nax-cell-group title="设置">
  <nax-cell title="个人资料" is-link @click="onProfile"></nax-cell>
  <nax-cell icon="settings" title="系统设置" value="已开启" is-link></nax-cell>
  <nax-cell title="昵称" label="用于展示" value="Nax"></nax-cell>
</nax-cell-group>

<nax-cell-group title="卡片样式" inset>
  <nax-cell title="消息通知" is-link></nax-cell>
  <nax-cell title="隐私" is-link></nax-cell>
</nax-cell-group>

<!-- inset 外框：none 无边框 / horizontal 仅上下 / vertical 仅左右 -->
<nax-cell-group title="无左右边框" inset inset-border="horizontal">
  <nax-cell title="仅上下描边" is-link></nax-cell>
</nax-cell-group>

nax-cell Props

属性 类型 默认 说明
title string '' 左侧标题
label string '' 标题下方说明
value string / number '' 右侧内容（支持数字类型，如余额 0）
icon string '' 左侧 nax-icon 名
is-link boolean false 展示右侧箭头
arrow boolean false 同 is-link（兼容）
border boolean true 底部分割线；组内受 group.border 控制
disabled boolean false 禁用
required boolean false 标题旁必填星号
center boolean false 垂直居中
clickable boolean false 无箭头时也显示按压态
size string md sm / md / lg
icon-color string '' 左侧图标色
title-color string '' 标题色
value-color string '' 右侧值颜色
custom-class string '' 根节点扩展 class

nax-cell 事件

事件 说明
click 点击（disabled 不触发）

nax-cell 插槽

名称 说明
icon 自定义左侧图标
title 自定义标题
label 自定义说明
value 自定义右侧值
right 右侧扩展（如 switch）
right-icon 右侧图标区
default 标题区额外内容

nax-cell-group Props

属性 类型 默认 说明
title string '' 分组标题
inset boolean false 圆角卡片内嵌
insetBorder string all inset 外框：all / none / horizontal / vertical
border boolean true 子 cell 底部分割线
custom-class string '' 根节点扩展 class

nax-cell-group 插槽

名称 说明
default 放置 nax-cell
title 自定义分组标题

主题

通过 CSS 变量覆盖：

Token 用途
--nax-color-bg 背景色
--nax-color-bg-hover 按压/悬停背景色
--nax-color-border 边框色
--nax-color-divider 分割线色
--nax-color-error 错误色
--nax-color-text 主文字色
--nax-color-text-secondary 次要文字色

依赖

  • nax-icon
  • nax-ui-theme（可选，提供 --nax-* token）

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。