term-tooltip.js 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277
  1. // resources/js/modules/term-tooltip.js
  2. // 原 term-tooltip.js 移至此处(从 js/ 根目录移入 modules/)。
  3. // 所有阅读页公用(tipitaka read、anthology read、wiki show、blog show)。
  4. // 在 reader.js 中 import,不在 app.js 全局加载(仅阅读页需要)。
  5. //
  6. // 文件内容:将现有 term-tooltip.js 内容直接复制至此,不做修改。
  7. // 待 reader.js 建立后在此 import:
  8. // import './modules/term-tooltip';
  9. import * as bootstrap from "bootstrap";
  10. (function () {
  11. "use strict";
  12. // ── 缓存层 ────────────────────────────────────────────────────────
  13. const cache = {};
  14. // 下面的模板用 innerHTML 拼接,取回的文字先转义
  15. const escapeHtml = (text) =>
  16. String(text ?? "").replace(/[&<>"']/g, (c) => ({
  17. "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;",
  18. })[c]);
  19. // 百科页上点术语直接跳转;其它页面(阅读页)不跳走,「查看完整条目」在新标签页打开
  20. const onWikiPage = /^\/library\/wiki\//.test(window.location.pathname);
  21. // 词条的百科页地址:语言取当前百科页的,其它页面取 <html lang>
  22. function wikiUrl(id) {
  23. const m = window.location.pathname.match(/^\/library\/wiki\/([^/]+)/);
  24. const lang = m
  25. ? decodeURIComponent(m[1])
  26. : document.documentElement.lang || "zh-Hans";
  27. return `/library/wiki/${encodeURIComponent(lang)}/${encodeURIComponent(id)}`;
  28. }
  29. const linkTarget = onWikiPage ? "" : ' target="_blank" rel="noopener"';
  30. // v3:summary_text 是纯文本摘要(有摘要用摘要,没有取正文第一段)
  31. async function fetchTerm(id) {
  32. if (cache[id]) return cache[id];
  33. const res = await fetch(`/api/v3/terms/${id}`, {
  34. headers: { Accept: "application/json" },
  35. });
  36. if (!res.ok) throw new Error(`fetchTerm ${id} failed: ${res.status}`);
  37. const { data } = await res.json();
  38. cache[id] = {
  39. word: escapeHtml(data.word),
  40. meaning: escapeHtml(data.meaning),
  41. summary: escapeHtml(data.summary_text),
  42. url: wikiUrl(id),
  43. };
  44. return cache[id];
  45. }
  46. // ── 设备判断 ──────────────────────────────────────────────────────
  47. const isMobile = () => window.innerWidth < 768;
  48. // ── Skeleton 模板 ─────────────────────────────────────────────────
  49. function buildSkeletonContent() {
  50. return `
  51. <div class="wiki-term-skeleton">
  52. <div class="wiki-term-skeleton-word"></div>
  53. <div class="wiki-term-skeleton-line"></div>
  54. <div class="wiki-term-skeleton-line short"></div>
  55. </div>
  56. `;
  57. }
  58. // ── Popover 内容模板 ──────────────────────────────────────────────
  59. function buildPopoverContent(data) {
  60. const meaning = (data.meaning || "").trim();
  61. const summary = (data.summary || "").trim();
  62. const showSummary = summary && summary !== meaning;
  63. return `
  64. <div class="wiki-term-card-word">${data.word || ""}</div>
  65. <div class="wiki-term-card-body" style="padding: 10px 14px 12px;">
  66. ${
  67. meaning
  68. ? `<div class="wiki-term-card-meaning">${meaning}</div>`
  69. : ""
  70. }
  71. ${
  72. showSummary
  73. ? `<div class="wiki-term-card-summary">${summary}</div>`
  74. : ""
  75. }
  76. </div>
  77. <div><a href="${data.url}"${linkTarget}>查看完整条目</a></div>
  78. `;
  79. }
  80. // ── 桌面端:Bootstrap Popover ─────────────────────────────────────
  81. function initDesktopPopover(el, content) {
  82. if (el._wikiPopover) return el._wikiPopover;
  83. const popover = new bootstrap.Popover(el, {
  84. trigger: "manual",
  85. html: true,
  86. placement: "bottom",
  87. fallbackPlacements: ["top", "bottom"],
  88. customClass: "wiki-term-popover",
  89. content: content,
  90. sanitize: false,
  91. });
  92. el._wikiPopover = popover;
  93. let hideTimer = null;
  94. function scheduleHide() {
  95. hideTimer = setTimeout(() => {
  96. const tipEl = document.querySelector(".wiki-term-popover.show");
  97. if (tipEl && tipEl.matches(":hover")) return;
  98. popover.hide();
  99. }, 120);
  100. }
  101. function cancelHide() {
  102. clearTimeout(hideTimer);
  103. }
  104. el.addEventListener("mouseenter", () => {
  105. cancelHide();
  106. popover.show();
  107. });
  108. el.addEventListener("mouseleave", scheduleHide);
  109. el.addEventListener("shown.bs.popover", () => {
  110. const tipEl = document.querySelector(".wiki-term-popover.show");
  111. if (!tipEl) return;
  112. tipEl.addEventListener("mouseenter", cancelHide);
  113. tipEl.addEventListener("mouseleave", scheduleHide);
  114. });
  115. return popover;
  116. }
  117. function updateDesktopPopover(el, data) {
  118. const popover = el._wikiPopover;
  119. if (!popover) return;
  120. // 更新内容
  121. const tip = document.querySelector(".wiki-term-popover.show");
  122. if (tip) {
  123. tip.querySelector(".popover-body").innerHTML =
  124. buildPopoverContent(data);
  125. }
  126. // 同步 popover 内部 config,供下次 show 使用
  127. popover._config.content = buildPopoverContent(data);
  128. }
  129. // ── 移动端:Bootstrap Offcanvas ───────────────────────────────────
  130. let offcanvasInstance = null;
  131. function getOffcanvas() {
  132. if (offcanvasInstance) return offcanvasInstance;
  133. const el = document.getElementById("wikiTermDrawer");
  134. if (!el) return null;
  135. offcanvasInstance = new bootstrap.Offcanvas(el, { scroll: false });
  136. el.addEventListener("hidden.bs.offcanvas", () => {
  137. document
  138. .querySelectorAll(".offcanvas-backdrop")
  139. .forEach((b) => b.remove());
  140. document.body.classList.remove("modal-open");
  141. document.body.style.removeProperty("overflow");
  142. document.body.style.removeProperty("padding-right");
  143. });
  144. return offcanvasInstance;
  145. }
  146. function showMobileDrawerSkeleton() {
  147. const oc = getOffcanvas();
  148. if (!oc) return;
  149. document.getElementById("wikiTermDrawerWord").innerHTML =
  150. '<div class="wiki-term-skeleton-word"></div>';
  151. document.getElementById("wikiTermDrawerMeaning").innerHTML =
  152. '<div class="wiki-term-skeleton-line short"></div>';
  153. document.getElementById(
  154. "wikiTermCardSlot"
  155. ).innerHTML = `<div class="wiki-term-skeleton">
  156. <div class="wiki-term-skeleton-line"></div>
  157. <div class="wiki-term-skeleton-line short"></div>
  158. </div>`;
  159. document.getElementById("wikiTermDrawerLink").style.display = "none";
  160. oc.show();
  161. }
  162. function fillMobileDrawer(data) {
  163. const meaning = (data.meaning || "").trim();
  164. const summary = (data.summary || "").trim();
  165. const showSummary = summary && summary !== meaning;
  166. document.getElementById("wikiTermDrawerWord").textContent =
  167. data.word || "";
  168. document.getElementById("wikiTermDrawerMeaning").textContent = meaning;
  169. document.getElementById("wikiTermCardSlot").innerHTML = showSummary
  170. ? `<div class="wiki-term-card-summary">${summary}</div>`
  171. : "";
  172. const link = document.getElementById("wikiTermDrawerLink");
  173. if (link && data.url) {
  174. link.href = data.url;
  175. if (!onWikiPage) {
  176. link.target = "_blank";
  177. link.rel = "noopener";
  178. }
  179. link.style.display = "";
  180. }
  181. }
  182. // ── 入口:扫描所有 .term-ref ──────────────────────────────────────
  183. function init() {
  184. const refs = document.querySelectorAll(".term-ref[data-id]");
  185. if (!refs.length) return;
  186. refs.forEach((el) => {
  187. // 桌面:mouseenter 时先显示 skeleton,数据回来后更新
  188. el.addEventListener("mouseenter", async function onFirstEnter() {
  189. if (isMobile()) return;
  190. // 立即显示 skeleton popover
  191. const popover = initDesktopPopover(el, buildSkeletonContent());
  192. popover.show();
  193. try {
  194. const data = await fetchTerm(el.dataset.id);
  195. updateDesktopPopover(el, data);
  196. } catch (e) {
  197. console.warn(
  198. "[WikiPāli] term fetch failed",
  199. el.dataset.id,
  200. e
  201. );
  202. popover.hide();
  203. }
  204. el.removeEventListener("mouseenter", onFirstEnter);
  205. });
  206. // 移动端:点击立即弹出 skeleton,数据回来后填充(抽屉里有「查看完整条目」)
  207. // 桌面端:百科页上点击直接跳到那条术语
  208. el.addEventListener("click", async (e) => {
  209. if (!isMobile()) {
  210. if (onWikiPage) {
  211. e.preventDefault();
  212. window.location.href = wikiUrl(el.dataset.id);
  213. }
  214. return;
  215. }
  216. e.preventDefault();
  217. showMobileDrawerSkeleton();
  218. try {
  219. const data = await fetchTerm(el.dataset.id);
  220. fillMobileDrawer(data);
  221. } catch (err) {
  222. console.warn(
  223. "[WikiPāli] term fetch failed",
  224. el.dataset.id,
  225. err
  226. );
  227. }
  228. });
  229. });
  230. }
  231. if (document.readyState === "loading") {
  232. document.addEventListener("DOMContentLoaded", init);
  233. } else {
  234. init();
  235. }
  236. })();