无需登录 数据私有 本地保存

PWA 安装提示管理器 - 自定义 A2HS 行为

38
0
0
0
快速预设模板

内置四种精心设计的安装提示模板,覆盖最常见的使用场景。经典横幅模板在页面底部展示简洁的安装提示条,适合不干扰用户浏览的场景;居中弹窗模板以模态框形式呈现,适合需要用户立即关注的场景;顶部通知模板从页面顶部滑入,适合轻量级提醒;iOS 引导模板专为 Safari 设计,通过步骤引导用户手动添加到主屏幕。每种模板均支持一键切换,方便开发者对比不同样式的效果,快速找到最适合自身产品的安装提示方案。

提示内容设置

支持完全自定义安装提示的所有文案内容,包括标题文字、安装按钮文案、详细描述、应用名称和图标文字。开发者可以根据品牌调性和目标用户群体调整文案风格,例如面向技术用户可以使用「安装 PWA 获取离线访问」,面向普通用户则可使用「添加到主屏幕,随时随地快速打开」。所有文案修改均实时反映在预览区域,确保最终效果符合预期。自定义文案能力让安装提示不再千篇一律,而是与品牌调性保持高度一致。

智能触发条件

提供五种触发方式,帮助开发者在最佳时机向用户展示安装提示。延迟触发允许设置页面加载后的等待时间,避免立即弹出干扰用户;滚动触发在用户浏览到页面一定深度后激活,表明用户已产生兴趣;访问次数触发基于用户的历史访问记录,仅对回头客展示提示;手动触发赋予开发者完全控制权,通过自定义按钮触发安装;立即触发适合特定场景下的即时提醒。冷却时间设置可防止频繁打扰已关闭提示的用户,建议设置为 24 至 48 小时。

外观与位置定制

提供丰富的外观定制选项,让安装提示与网站品牌风格保持一致。支持三种位置布局:底部横幅、居中弹窗和顶部横幅。主题色选择器允许精确匹配品牌色彩,按钮圆角调节从方形到完全圆形。可选的关闭按钮赋予用户控制权,应用图标展示增强品牌识别,动画效果让提示的出现和消失更加自然流畅。所有外观调整均通过滑块和色值输入完成,操作直观便捷,无需编写任何 CSS 代码即可获得专业级的视觉效果。

实时手机预览

内置手机模拟器预览区域,以 9:16 的比例真实还原安装提示在移动设备上的显示效果。预览区域包含模拟的浏览器地址栏和状态栏,开发者可以直观看到安装提示与页面内容的空间关系。所有配置修改(模板切换、文案调整、触发条件、外观样式)均实时同步到预览区域,无需刷新页面或切换视图。预览底部标注「模拟效果,实际表现因浏览器而异」,确保开发者对最终效果有合理预期,减少在真机测试前的反复调试。

代码生成与下载

基于开发者的选择和配置,自动生成完整的 JavaScript 代码片段。生成的代码包含安装提示的 DOM 创建逻辑、样式注入、触发条件处理、用户交互响应和 PWA 安装流程。代码结构清晰,包含必要的注释说明。支持一键复制代码到剪贴板,也支持下载为独立的 .js 文件。使用时只需通过 script 标签引入,确保已注册 Service Worker 且配置了 manifest.json 即可生效。代码不依赖任何第三方库,体积轻量,不影响页面加载性能。

PWA 状态检测

内置全面的 PWA 环境检测功能,一键诊断当前网站的 PWA 配置状态。检测项目包括:Service Worker 是否已注册并激活、manifest.json 文件是否可访问且配置正确、当前页面是否满足安装条件、浏览器是否支持 A2HS 功能。检测结果以清晰的图标和文字展示,帮助开发者快速定位配置问题。工具还提供 manifest.json 配置参考示例,包含 name、short_name、icons、start_url、display 等关键字段的正确写法,为开发者提供完整的配置参考。

iOS Safari 适配

针对 iOS Safari 不支持 beforeinstallprompt 事件的特殊情况,工具提供专门的 iOS 引导模板。该模板自动检测用户设备是否为 iOS,并生成相应的引导文案,告知用户通过 Safari 的分享菜单手动添加到主屏幕。引导内容包含清晰的步骤说明和视觉提示,有效降低 iOS 用户的理解成本。同时生成必要的 apple-mobile-web-app 相关 meta 标签配置建议,确保 PWA 在 iOS 设备上的最佳表现,让跨平台的安装体验更加统一和专业。