更新记录

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

• 微信小程序：修复宿主页同时使用 <nax-dialog /> 与同名导入 naxDialog 时的编译命名冲突；示例通过 MP-WEIXIN 条件编译使用本地函数别名，确保声明式实例与命令式宿主正常注册，点击可打开对话框。Web 与 App 端行为保持不变。

平台兼容性

uni-app x(4.25)

其他

nax-dialog

居中对话框（确认 / 告警）。内部薄封装 nax-picker（position=center）。

支持两种用法：

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

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

依赖

• 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 的关系