# 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

success返回对象示例:

{
  errMsg: "enableLeaveConfirm:ok"
}
1
2
3
最后更新于 : 2/22/2023, 4:59:54 PM