# enableLeaveConfirm
当某个页面返回或关闭时设置二次弹窗提示。
使用场景举例:当前页面为编辑页面且用户尚未保存所作更改时,可提示用户是否继续留在当前页面。
注意事项:
当前页面指的是调用bz.enableLeaveConfirm时小程序栈顶页面,与API在哪个页面实例调用无关,bz.disableLeaveConfirm同理。 例如,在页面A的异步接口中执行bz.enableLeaveConfirm操作,但异步接口执行结束后,此时用户已操作跳转至页面B,那么此时该接口生效页面为页面B。故尽量避免异步回调等case下使用,若无法避免,可在执行前对页面名称进行校验。
# 支持说明
应用能力 | Android | iOS | PC | 预览效果 |
---|---|---|---|---|
小程序 | 3.6.0 | 3.6.0 | 3.8.0 | 扫码预览 用BoosHi扫码或PC端点击 |
网页应用 | 待开发 | 待开发 | 待开发 | 待补充 |
# 输入
继承标准对象输入,扩展属性描述:
名称 | 数据类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
effect | string[] | 是 | 指定生效场景 "back": 点击返回(Android支持系统返回键;iOS不支持滑动关闭操作) "close": 点击关闭 | |
title | string | 否 | 提示 | 指定弹窗标题,最长16个字符。 |
content | string | 否 | 确认要退出页面吗? | 指定弹窗内容,最长80个字符。 |
confirmText | string | 否 | 确定 | 确定按钮的文案,最长8个字符。 |
cancelText | string | 否 | 取消 | 取消按钮的文案,最长8个字符。 |
# 输出
继承标准对象输出,无扩展属性
# 示例代码
bz.enableLeaveConfirm({
effect: ["close", "back"],
title: "提示",
content: "确认要退出页面吗?",
confirmText: "确定",
cancelText: "取消",
success(res) {
console.log(JSON.stringify(res));
},
fail(res) {
console.log(`enableLeaveConfirm fail: ${JSON.stringify(res)}`);
}
})
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
success
返回对象示例:
{
errMsg: "enableLeaveConfirm:ok"
}
1
2
3
2
3