更新记录

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

• 修复 Android 端无蒙层 Toast 的 center 与 top 定位偏上问题：center 改为按屏幕高度定位，top 下移至 128px；有蒙层与无蒙层路径均使用 APP-ANDROID 隔离，iOS、鸿蒙、Web 和小程序保持原有行为。

平台兼容性

uni-app x(4.25)

其他

nax-toast

nax-ui 轻提示（uni-app x / uvue）。

推荐用法：函数式调用，业务页面不写 Toast DOM。

接入

1. 全局挂载一次宿主

在根布局或长期存活的页面挂一次（整个 App 只需一处）：

<nax-toast />

uni-app x 的 App.uvue 通常不渲染 template。请挂在自定义根布局、Tab 根页，或业务页面栈中会存活的壳页面。
注意：上一页的宿主一般不会盖到当前页上，所以「全局一次」应挂在真正常驻的根布局，而不是指望页面栈底层页。

2. 业务页只调方法

import {
  naxToast as showNaxToast,
  hideNaxToast,
  naxToastSuccess,
  naxToastError,
  naxToastLoading
} from '@/uni_modules/nax-toast/index.uts'

showNaxToast('操作成功')
showNaxToast({ title: '保存成功', type: 'success' })
naxToastSuccess('已提交')
naxToastError('网络异常')
naxToastLoading('提交中…')
// 手动关闭（loading 常用）
hideNaxToast()

未挂载宿主时，会回退到 uni.showToast，保证基础可用。

微信小程序端：若当前 SFC 同时挂载 <nax-toast /> 并导入 naxToast，请像上例一样给函数设置本地别名。naxToast 会与组件标签映射到同一个驼峰名，导致 MP-WEIXIN 未注册宿主组件并回退到不支持 position 的 uni.showToast。仅调用函数、不挂载宿主的业务页可继续直接导入 naxToast。

API

naxToast(input)

• 微信小程序：position: 'top' 会依据状态栏与胶囊位置计算导航栏底部，并额外下移 16px，避免覆盖自定义导航栏（MP-WEIXIN）。

hideNaxToast()

立即关闭当前提示。

快捷方法

• naxToastSuccess(title)
• naxToastError(title)
• naxToastWarning(title)
• naxToastInfo(title)
• naxToastLoading(title?, overlay?)

宿主组件 props

依赖

• nax-icon（类型图标 / loading）
• nax-ui-theme（可选 token）

主题 Token（改默认背景）

在 nax-theme 节点或全局 CSS 覆盖：

.nax-theme {
  --nax-toast-bg: rgba(0, 0, 0, 0.85);
  --nax-toast-color: #ffffff;
  --nax-toast-bg-success: #18a058;
  --nax-toast-bg-error: #d03050;
  --nax-toast-bg-warning: #f0a020;
  --nax-toast-bg-info: #2080f0;
}

• 默认文案 / loading：半透明黑（--nax-toast-bg）
• success / error / warning / info：使用对应语义色底
• 单次调用优先 bg，覆盖主题与 type 底色
• 鸿蒙 / App：背景请用实色 hex（如 #18a058）。rgba(...)、嵌套 var() 在 ucss 下可能失效；组件内部默认与 type 色已改为实色 hex + inline 写入