uni.showmodal 的 success 回调中不能无条件调用 uni.setclipboarddata,需先判断平台:h5 用 navigator.clipboard.writetext(),小程序/app 用 uni.setclipboarddata,并处理异常与边界情况。

uni.showModal 里不能直接写复制逻辑
很多人一上来就往 success 回调里塞 uni.setClipboardData,结果 H5 端报错 API `setClipboardData` is not yet implemented,App 和小程序却正常——这是因为 H5 平台不支持该 API,但 uni.showModal 本身是跨端的,它不会帮你拦截平台差异。
真正要做的,是在用户点「确定」后、再判断当前平台是否支持复制,不支持就跳过或给提示,而不是硬塞一个必报错的调用。
- 别在
uni.showModal的success里无条件执行uni.setClipboardData - 先用
uni.getSystemInfoSync().platform拿到当前平台,值为"h5"、"mp-weixin"、"app"等 - H5 端得换方案:用
navigator.clipboard.writeText()(需 HTTPS 或 localhost) - 微信小程序和 App 可继续用
uni.setClipboardData,更稳定
复制前弹确认框的完整写法(含平台适配)
下面这段代码能跑通 H5、微信小程序、App 三端,且不会在 H5 报错:
copy(value) {
uni.showModal({
content: `确定复制:“${value}”?`,
confirmText: '复制',
success: (res) => {
if (res.confirm) {
const platform = uni.getSystemInfoSync().platform;
if (platform === 'h5') {
// H5 必须用原生 Clipboard API,且页面需安全上下文
navigator.clipboard.writeText(value)
.then(() => {
uni.showToast({ title: '复制成功', icon: 'none' });
})
.catch(() => {
uni.showToast({ title: '复制失败,请手动长按粘贴', icon: 'none' });
});
} else {
// 小程序 / App 用 uni API
uni.setClipboardData({
data: value,
success: () => {
uni.showToast({ title: '复制成功', icon: 'none' });
},
fail: () => {
uni.showToast({ title: '复制失败', icon: 'none' });
}
});
}
}
}
});
}
注意两个关键点:
-
navigator.clipboard.writeText在非 HTTPS 页面(比如本地 file:// 协议)会直接 reject,H5 环境下务必确保部署在 HTTPS 或localhost - 不要省略
fail或catch分支,否则用户点确定后没反应,会以为功能坏了
为什么不用 uni.confirm?
uni.confirm 是 uni.showModal 的语法糖,底层一样,参数也基本一致。但它没有 cancelColor、confirmColor 等样式控制项,UI 更死板;更重要的是,它的返回结构和 uni.showModal 完全一致(res.confirm / res.cancel),没额外价值。
直接用 uni.showModal 更可控,比如你可以把 showCancel: false,做成单按钮“确认复制”样式,避免用户误点取消。
- 想隐藏取消按钮?加
showCancel: false - 想改按钮颜色?用
confirmColor: '#1890ff'(H5 和微信小程序都支持) - 想改标题字体大小?不行,
uni.showModal不支持自定义样式,只能靠平台默认
容易被忽略的边界情况
实际项目里,以下三点经常漏掉,导致线上出问题:
- 传入的
value是null或undefined时,uni.showModal.content会显示"null"字符串,而不是空内容——建议提前String(value || '') - 长文本(比如超 200 字)在某些安卓机上可能触发系统弹窗截断,建议加省略:
content: `确定复制:“${value.slice(0, 50)}${value.length > 50 ? '...' : ''}”?` - 用户快速连点复制按钮,可能触发多次
uni.showModal,造成弹窗堆叠——加个节流,比如用let copying = false锁住
平台兼容性这事,不是写完就能交差的;弹窗看着简单,但每多一个平台,就要多一层判断。别指望 uni-app 自动兜底。











