/* 右下角浮标(弱化入口,替代原「帮助中心」「问题反馈」导航页)。 - 帮助中心:按当前语言跳转(zh→zh-cn / en→en-us)。 - 问题反馈:跳转飞书问题收集表单。链接与 hover 气泡文案(aria-label)按当前路径语言实时判定,兼容 SPA 切换语言。位置由 positionFabs() 按右侧目录/内容的实际位置动态计算,始终避开滚动条: · 目录右侧空隙够 → 放目录右侧,距目录滚动条约 16px(宽屏,气泡朝右) · 目录右侧空隙不够 → 落到内容与目录之间的空隙(中等宽度,避开目录滚动条) · 无右侧目录 → 距视口右缘 24px(窄屏/宽表页) 样式见 style.css .subotiz-fab / #subotiz-help-fab / #subotiz-feedback-fab。 */ (function () { var FEEDBACK_URL = "https://shoplazza.feishu.cn/share/base/form/shrcnj1R0DeUzxxplU5LNsFVAbc"; var HELP_EN = "https://help.subotiz.com/hc/en-us"; var HELP_ZH = "https://help.subotiz.com/hc/zh-cn"; var LABELS = { help: { zh: "帮助中心", en: "Help Center" }, feedback: { zh: "问题反馈", en: "Issue Feedback" }, }; var ICON_FEEDBACK = ''; var ICON_HELP = ''; var GAP_SB = 16; // 距滚动条 var GAP_VP = 24; // 距视口右缘 var FAB_W = 40; // 浮标宽度 var TIP_W = 100; // 气泡预留宽度(用于判断能否朝右) function lang() { return /^\/en(\/|$)/.test(location.pathname) ? "en" : "zh"; } // 计算浮标右偏移与气泡方向,写入 :root 变量 / data 属性 function positionFabs() { var vw = document.documentElement.clientWidth; // 不含页面滚动条 var toc = document.querySelector("#table-of-contents"); var rightPx, tipRight = false; if (toc && toc.offsetParent !== null && toc.getBoundingClientRect().width > 0) { var r = toc.getBoundingClientRect(); var gutter = vw - r.right; // 目录右侧到视口右缘 if (gutter >= FAB_W + GAP_SB + GAP_VP) { // 空隙够:放目录右侧,浮标左缘距目录滚动条 GAP_SB rightPx = gutter - GAP_SB - FAB_W; tipRight = rightPx >= TIP_W; // 浮标右侧还够放气泡才朝右 } else { // 空隙不够:落到内容与目录之间的空隙,浮标右缘距目录左缘 GAP_SB rightPx = vw - r.left + GAP_SB; } } else { // 无右侧目录:锚到内容列(content-container)右缘,即有目录时目录所在的右缘, // 保证浮标位置和有目录时一致,不会在宽屏被甩到视口最右。 var cc = document.querySelector("#content-container"); var cr = cc ? cc.getBoundingClientRect().right : vw - GAP_VP; var cgutter = vw - cr; if (cgutter >= FAB_W + GAP_SB + GAP_VP) { rightPx = cgutter - GAP_SB - FAB_W; // 贴内容列右缘 GAP_SB tipRight = rightPx >= TIP_W; } else { rightPx = GAP_VP; // 窄屏:内容列已接近视口边,回落到距视口 GAP_VP } } var root = document.documentElement; root.style.setProperty("--subotiz-fab-right", rightPx + "px"); root.setAttribute("data-fab-tip", tipRight ? "right" : "left"); } function fab(id, icon, resolve) { if (document.getElementById(id)) return; var a = document.createElement("a"); a.id = id; a.className = "subotiz-fab"; a.target = "_blank"; a.rel = "noopener noreferrer"; a.innerHTML = icon; var sync = function () { var r = resolve(lang()); a.href = r.href; a.setAttribute("aria-label", r.label); }; sync(); a.addEventListener("mouseenter", sync); a.addEventListener("focus", sync); a.addEventListener("click", sync); document.body.appendChild(a); } // 让顶栏 navbar 里的 .txt 链接(llms.txt 等)在新标签打开(Mintlify navbar 不支持配 target) function linkNewTab() { document .querySelectorAll('#navbar .navbar-link a, #navbar a[href$=".txt"]') .forEach(function (a) { a.setAttribute("target", "_blank"); a.setAttribute("rel", "noopener noreferrer"); }); } // AI 助手激活时隐藏浮标,避免覆盖 / 一闪。激活 = 面板打开,或底部"提出问题"输入框获焦。 // 面板 #chat-assistant-sheet 打开时从右侧覆盖浮标(还能放大变宽); // 底部常驻输入框 #chat-assistant-textarea 获焦即视为开始用 AI。 function aiActive() { var s = document.getElementById("chat-assistant-sheet"); if (s) { var cs = getComputedStyle(s); if (cs.visibility !== "hidden" && cs.display !== "none" && s.getBoundingClientRect().width > 0) return true; } var a = document.activeElement; if (a && (a.id === "chat-assistant-textarea" || (a.closest && a.closest("#chat-assistant-sheet")))) return true; return false; } function syncFabVisibility() { document.documentElement.toggleAttribute("data-ai-open", aiActive()); } // 是否点在会打开/激活 AI 的控件上(入口按钮、输入框、面板内) function isAiTrigger(t) { return !!(t && t.closest && t.closest("#assistant-entry, #assistant-entry-mobile, #chat-assistant-textarea, #chat-assistant-sheet")); } var aiObserver; function watchAiSheet() { var s = document.getElementById("chat-assistant-sheet"); if (!s || aiObserver) return; aiObserver = new MutationObserver(syncFabVisibility); aiObserver.observe(s, { attributes: true, attributeFilter: ["style", "class"] }); syncFabVisibility(); } // 目录:给"含当前选中页"的所有祖先折叠分组的 header 打持久标记 data-active-ancestor。 // Mintlify 折叠分组时会把子列表从 DOM 移除,纯 CSS :has() 会失效;改为在选中项可见时 // (页面加载/切页,此时该分组自动展开)标记,标记落在 header 上,折叠后依然保留。 var navObserver; function markActiveNavAncestors() { var root = document.getElementById("navigation-items"); if (!root) return; var active = root.querySelector('a[aria-current="page"]'); if (!active) return; // 选中项不在 DOM(分组已折叠)→ 保留已有标记,不清除 var marks = root.querySelectorAll("button[data-active-ancestor]"); for (var i = 0; i < marks.length; i++) marks[i].removeAttribute("data-active-ancestor"); var el = active.parentElement; while (el && el.id !== "navigation-items") { if (el.tagName === "LI") { var btn = el.querySelector(":scope > button"); if (btn) btn.setAttribute("data-active-ancestor", ""); } el = el.parentElement; } } function watchNav() { var root = document.getElementById("navigation-items"); if (!root || navObserver) return; navObserver = new MutationObserver(function () { markActiveNavAncestors(); }); navObserver.observe(root, { subtree: true, childList: true, attributes: true, attributeFilter: ["aria-current"] }); markActiveNavAncestors(); } function mount() { if (!document.body) return; fab("subotiz-help-fab", ICON_HELP, function (l) { return { href: l === "en" ? HELP_EN : HELP_ZH, label: LABELS.help[l] }; }); fab("subotiz-feedback-fab", ICON_FEEDBACK, function (l) { return { href: FEEDBACK_URL, label: LABELS.feedback[l] }; }); positionFabs(); linkNewTab(); watchAiSheet(); watchNav(); // 导航栏 / AI 面板可能晚于脚本渲染,稍后再补几次 [150, 400, 900].forEach(function (t) { setTimeout(function () { positionFabs(); linkNewTab(); watchAiSheet(); watchNav(); markActiveNavAncestors(); syncFabVisibility(); }, t); }); // 提前隐藏(消除一闪):按下 AI 入口/输入框的瞬间就隐藏,不等面板动画 document.addEventListener("pointerdown", function (e) { if (isAiTrigger(e.target)) document.documentElement.setAttribute("data-ai-open", ""); }, true); // 焦点进出时同步(覆盖底部"提出问题"输入框入口) document.addEventListener("focusin", syncFabVisibility); document.addEventListener("focusout", function () { setTimeout(syncFabVisibility, 60); }); // 兜底:任何点击后延时复检(面板真正开/关以此为准) document.addEventListener("click", function () { setTimeout(syncFabVisibility, 250); }); } // 尺寸变化时重算(rAF 去抖) var raf; window.addEventListener("resize", function () { if (raf) cancelAnimationFrame(raf); raf = requestAnimationFrame(positionFabs); }); // SPA 路由切换(目录可能出现/消失、语言可能改变)时重算 ["pushState", "replaceState"].forEach(function (m) { var orig = history[m]; if (typeof orig === "function") { history[m] = function () { var ret = orig.apply(this, arguments); [80, 300].forEach(function (t) { setTimeout(function () { positionFabs(); linkNewTab(); markActiveNavAncestors(); }, t); }); return ret; }; } }); window.addEventListener("popstate", function () { [80, 300].forEach(function (t) { setTimeout(function () { positionFabs(); linkNewTab(); markActiveNavAncestors(); }, t); }); }); if (document.body) mount(); else document.addEventListener("DOMContentLoaded", mount); })();