用途
本技能用于指导网页应用调用懒猫 Android 客户端注入的 JavaScript Bridge。当业务需要控制 Android 壳的底部 Snackbar、底部提示,或需要关闭、恢复下载完成提示等宿主级提示时,可参考本技能。触发场景通常包括:底部提示、底部 Snackbar、下载提示、下载完成提示、关闭或恢复宿主提示、lzc_toast、setSnackBarEnabled()。
主要能力
核心接口为 lzc_toast.setSnackBarEnabled,由 Android WebView 宿主以 lzc_toast 名称注入,调用参数为布尔值:
lzc_toast.setSnackBarEnabled(false) // 禁止宿主 Snackbar
lzc_toast.setSnackBarEnabled(true) // 恢复宿主 Snackbar
该接口只控制宿主壳的 Snackbar 显示开关,不会改变网页自己的 Toast、Snackbar 或其他 UI。关闭后,宿主对 lzc_toast.showSnake(...) 和下载完成提示的显示请求会直接忽略;默认状态为开启。
使用方式
调用前必须做能力检测,避免网页在非 Android 环境报错:
if (globalThis.lzc_toast && typeof globalThis.lzc_toast.setSnackBarEnabled === 'function') {
globalThis.lzc_toast.setSnackBarEnabled(false)
}
这是 Android @JavascriptInterface 暴露的方法,调用应在页面加载完成后进行;不要把它当作跨平台标准 API 或持久化设置。需要恢复提示时显式传入 true。页面刷新或宿主生命周期重建后的状态不应假定由网页持久化。
适用场景
适用于需要在懒猫 Android WebView 壳内,对宿主级底部提示进行开关控制的网页应用,例如按业务时机关闭或恢复宿主 Snackbar 与下载完成提示。
限制
仅适用于懒猫 Android WebView 壳;普通浏览器、桌面端、iOS 和未注入该桥的 WebView 不提供此接口。该状态不是应用配置文件或服务端配置,而是修改宿主内存中的 Snackbar 开关,因此不具备持久化特性。其他平台兼容性与配置方式暂未提供。