在 React、Next.js 或 Vue 应用中安装
在应用公共布局中安装聊天组件,使页面跳转时保留对话。
本页内容
React、Next.js 和 Vue 应用经常在不完整刷新浏览器的情况下切换页面。小组件代码应放在应用的公共布局中,让聊天窗口不会随页面切换而消失。先从小组件 → 安装复制代码,并在允许的网站中添加应用域名。以下代码放置步骤适合交给网站开发者。聊天设置见网站小组件。
代码放在哪里
将完整片段只插入一次,放在页面切换时仍保留的应用公共布局中:
- Next.js App Router:根
app/layout.tsx的<head>中,或使用strategy="afterInteractive"的Script组件。 - Next.js Pages Router:
pages/_document.tsx的<Head>中。 - Vue + Vite 或 Vue Router:项目根目录
index.html的<head>中。Nuxt 项目请交由开发者加入应用公共布局。 - React Create React App:
public/index.html的<head>中。React + Vite:根目录index.html的<head>中。
不要放在单个页面里;路由跳转时应用可能连同打开的聊天一起移除该页面。
如何检查安装
发布修改,打开聊天并通过应用菜单跳到另一页,确认聊天窗口和当前对话仍在。随后发送消息,并在管理页面确认收到。再从小组件 → 安装对已发布页面运行检查安装,结果说明见自动诊断。
为什么只插入一次
切换页面时,打开的聊天应保持原样,因此加载脚本要放在不会被路由移除的公共布局,而不是单页。加载器通过 window.mybot = window.mybot || {} 保留已有会话,重复加载不会创建第二个小组件。但应用如果把聊天所在页面移除,未保存的界面状态仍可能丢失,无需每次跳转都重新运行脚本。
常见问题
- 不要再把片段重复放入单页;路由跳转可能连同聊天一起移除它。
- Next.js 的
Script加载器使用strategy="afterInteractive",而不是"beforeInteractive",避免阻塞首次渲染。 - 发布后清理服务器或 CDN 页面缓存,否则访客可能继续看到没有脚本的旧页面。