更新记录

0.1.2（2026-07-31） 下载此版本

  • 修复 Android（APP-ANDROID）ComputedRef cannot be cast to java.lang.Void：容器改为提供同步的 Ref 状态，子项以同类型 ref(...) 默认值注入，避免 null 被推断为 Void。
  • Web、iOS、HarmonyOS 与小程序保持既有的 computed 注入行为。

平台兼容性

uni-app x(4.25)

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

其他

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

nax-grid

宫格布局：由 nax-grid 容器 + nax-grid-item 子项组成。

用法

<nax-grid :col="3" @click="onGridClick">
  <nax-grid-item v-for="(item, i) in list" :key="i" :index="'' + i">
    <nax-icon name="home" size="22"></nax-icon>
    <text class="grid-text">{{ item }}</text>
  </nax-grid-item>
</nax-grid>

无边框 + 间距：

<nax-grid :col="4" :border="false" gap="8">
  <nax-grid-item>...</nax-grid-item>
</nax-grid>

Props · Grid

属性 类型 默认 说明
col number 3 列数，最小 1
border boolean true 是否显示网格边框
align string left 不满一行时对齐：left / center / right
gap string 0 子项间距；纯数字按 px
hover boolean true 是否启用按压反馈
custom-class string '' 根节点扩展 class

Props · GridItem

属性 类型 默认 说明
index string '' 点击回传值；空则按挂载顺序自动编号
disabled boolean false 禁用点击
custom-class string '' 根节点扩展 class

Events

组件 事件 说明
grid click 点击子项；参数为 index（string）
grid-item click 点击自身；参数为 index（string）

推荐在 nax-grid 上统一监听 click；需要单项逻辑时可同时监听 item。

边框与间距

  • border=true 且 gap=0：经典九宫格连线（父上/左 + 子右/下）
  • border=true 且 gap>0：子项独立描边 + 圆角卡片感
  • border=false：纯内容格，可用 gap 控制疏密

主题 Token

  • --nax-color-bg
  • --nax-color-bg-hover
  • --nax-color-divider / --nax-color-border
  • --nax-color-text / --nax-color-text-secondary
  • --nax-radius-md
  • --nax-opacity-disabled

依赖

  • nax-ui-theme（可选，提供统一 token）

隐私、权限声明

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

无

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

无

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

无

许可协议

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

暂无用户评论。