更新记录

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

• 蒸汽模式兼容：lines CSS 声明迁移为 <text> 的 :max-lines 属性（官方蒸汽模式方案），消除 Vapor 运行时与 CSS 编译器警告

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

• 精简 readme：移除内部开发向内容（设计说明 / 实现细节 / 平台差异实现等），只保留安装、用法、API、主题等用户文档

0.2.0（2026-08-07） 下载此版本

• 声明支持 iOS 端（APP-IOS）：声明式与命令式弹窗已在 iOS 真机验证，公共实现无需端差异处理；package.json 平台标记 ios 由 - 更新为 √
• Android、鸿蒙、Web、微信小程序行为保持不变

平台兼容性

uni-app x(4.25)

其他

nax-dialog

居中对话框（确认 / 告警）。

支持两种用法：

1. 声明式：页面里写 <nax-dialog v-model:show>，可插槽自定义内容
2. 命令式：全局挂一次宿主后，业务只调 naxDialog() / naxDialogAlert() / naxDialogConfirm()

自定义任意复杂弹层请直接用 nax-picker。

主题

通过 CSS 变量覆盖：

依赖

• nax-picker
• nax-ui-theme（可选，主题 token）

easycom 自动注册：页面内直接使用 <nax-dialog>。

声明式用法

<nax-button label="打开" @click="show = true"></nax-button>
<nax-dialog
  v-model:show="show"
  title="提示"
  content="确定执行该操作吗？"
  @confirm="onConfirm"
  @cancel="onCancel"
></nax-dialog>

const show = ref(false)

function onConfirm() {
  // 点确定
}

function onCancel() {
  // 点取消或遮罩关闭（需 maskClosable）
}

自定义内容

<nax-dialog v-model:show="show" title="协议" :show-cancel="true" confirm-text="同意">
  <view class="custom">
    <text>这里可以放自定义布局</text>
  </view>
</nax-dialog>

更复杂的居中/底部弹层请用 nax-picker。

命令式用法

1. 全局挂一次宿主

<nax-dialog />

与 toast 相同：挂在常驻根布局。
未挂宿主时回退 uni.showModal。

2. 业务只调方法

import {
  naxDialog as showNaxDialog,
  naxDialogAlert,
  naxDialogConfirm,
  hideNaxDialog
} from '@/uni_modules/nax-dialog/index.uts'

// 确认框（默认双按钮）
naxDialogConfirm({
  title: '删除',
  content: '删除后不可恢复',
  confirmType: 'error'
}).then((res) => {
  if (res.getBoolean('confirm') == true) {
    // 用户点了确定
  }
})

naxDialogConfirm({ title: '提示', content: '继续？' }).then((res) => {
  const action = res.getString('action') // confirm | cancel
})

// 告警（仅确定）
naxDialogAlert('保存成功')
naxDialogAlert({ title: '提示', content: '网络已恢复' })

// 通用入口
showNaxDialog({
  title: '提示',
  content: '自定义双按钮',
  showCancel: true
})

微信小程序端：若当前 SFC 同时挂载 <nax-dialog /> 并导入 naxDialog，请像上例一样给函数设置本地别名。naxDialog 会与组件标签映射到同一个驼峰名，导致 MP-WEIXIN 未注册宿主组件；声明式与命令式按钮都会表现为点击无反应。仅调用函数、不挂载宿主的业务页可继续直接导入 naxDialog。

asyncClose（异步关闭）

naxDialogConfirm({
  title: '提交',
  content: '确认提交？',
  asyncClose: true
}).then((res) => {
  if (res.getBoolean('confirm') == true) {
    // 请求中…结束后再关
    // hideNaxDialog()
  }
})

Props

事件

命令式 API

input 可为 string（content）或 object：

返回 Promise<UTSJSONObject>，字段同上。

插槽

与 nax-picker / toast 的关系