更新记录

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

• 修复暗黑模式下加载、失败与空图片占位文字因浅色背景与亮色文字叠加而不可见的问题
• Web、Android、iOS 与小程序端的占位背景改为跟随 --nax-color-bg-secondary，文字跟随 --nax-color-text-secondary
• 鸿蒙端通过 APP-HARMONY 显式解析暗色主题背景、文字与图标 token，变量不可用时回退到可读的浅色组合；默认图标尺寸保持 20px

平台兼容性

uni-app x(4.25)

其他

nax-image

nax-ui 图片组件（uni-app x / uvue）。

基于原生 image 封装，提供统一尺寸/圆角 API，以及加载中与加载失败占位。

安装

uni_modules/nax-image

依赖：

uni_modules/nax-icon

easycom 自动生效。

推荐同时安装主题包

uni_modules/nax-ui-theme

并在 App.uvue 引入：

@import "@/uni_modules/nax-ui-theme/theme/default.css";

页面根节点加 class="nax-theme"。

依赖

安装 theme 后仍需：App.uvue @import + 应用 layout/页面 一处 class="nax-theme"。详见 uni_modules/nax-ui-theme/readme.md（L0/L1/L2）。

基础用法

<nax-image
  src="https://example.com/a.jpg"
  width="120"
  height="120"
  shape="round"
></nax-image>

加载 / 失败占位

默认开启 showLoading / showError。可用插槽自定义：

<nax-image src="https://example.com/a.jpg" width="160" height="120">
  <template #loading>
    <text>加载中…</text>
  </template>
  <template #error>
    <text>图片走丢了</text>
  </template>
</nax-image>

懒加载

<nax-image
  src="https://example.com/a.jpg"
  lazy-load
  width="100%"
  height="180"
></nax-image>

Props

Events

Slots

主题