shadowzzh

diagram-linker.js

diagram-linker.js
/*!
 * diagram-linker.js — S2 图与代码联动
 * -------------------------------------------------------------
 * 功能:
 *   1. 点击 SVG 内带 [data-anchor="<nodeId>"] 的元素 → 平滑滚动到对应代码块,
 *      并给代码块加 .is-highlighted(3s 后自动移除)。
 *   2. 代码块进入视口中段时(IntersectionObserver,rootMargin -40%/-40%)→
 *      SVG 内对应的 [data-anchor] 元素加 .is-active,其余 .is-active 移除。
 *
 * 数据源:页面里 <script type="application/json" id="diagram-anchors"> 内联的 JSON,
 *        形如 { diagramId: { nodeId: "codeBlockId", ... }, ... }。
 *        该 JSON 由 ModuleLayout.astro 从 entry.data.diagrams[].anchors 序列化注入。
 *
 * 依赖:Vanilla JS,无外部库。Astro 视图转换时会触发 astro:page-load 重新绑定。
 * 兼容:现代浏览器(Chromium/Firefox/Safari/Edge 最近 2 年版本)。
 */
(function () {
  'use strict';

  function setupLinker() {
    // 1. 读取页面内联的 anchors 配置
    var anchorsEl = document.getElementById('diagram-anchors');
    if (!anchorsEl) return;

    var anchorsText = anchorsEl.textContent || '{}';
    var anchors;
    try {
      anchors = JSON.parse(anchorsText);
    } catch (err) {
      // 配置损坏,静默退出(开发期可 console.warn)
      if (window.console && console.warn) {
        console.warn('[diagram-linker] diagram-anchors JSON parse failed:', err);
      }
      return;
    }

    // 2. 为每个 diagram 绑定联动
    Object.keys(anchors || {}).forEach(function (diagramId) {
      var mapping = anchors[diagramId] || {};
      var diagram = document.querySelector('[data-diagram-id="' + cssEscape(diagramId) + '"]');
      if (!diagram) return;

      var nodeIds = Object.keys(mapping);
      var codeIds = nodeIds.map(function (nid) { return mapping[nid]; });

      // 检查 SVG 是否已内联(必须能查到 [data-anchor] 才有意义绑定)
      // 若未内联,跳过本次绑定(不设 linkerBound),等 diagram:inline 事件后重试
      var hasAnchorNodes = false;
      nodeIds.forEach(function (nodeId) {
        if (diagram.querySelector('[data-anchor="' + cssEscape(nodeId) + '"]')) {
          hasAnchorNodes = true;
        }
      });
      if (!hasAnchorNodes) return;

      // —— 正向:点击 SVG 元素 → 滚动到代码块 ——
      nodeIds.forEach(function (nodeId) {
        var codeId = mapping[nodeId];
        var svgEls = diagram.querySelectorAll('[data-anchor="' + cssEscape(nodeId) + '"]');
        Array.prototype.forEach.call(svgEls, function (el) {
          el.style.cursor = 'pointer';
          el.addEventListener('click', function () {
            var target = document.getElementById(codeId);
            if (!target) return;
            target.scrollIntoView({ behavior: 'smooth', block: 'center' });
            target.classList.add('is-highlighted');
            window.setTimeout(function () {
              target.classList.remove('is-highlighted');
            }, 3000);
          });
        });
      });

      // —— 反向:代码块进入视口中段 → 对应 SVG 元素加 .is-active ——
      //    rootMargin -40%/-40% 让"触发线"位于视口纵向中段(40% 处)。
      if (typeof IntersectionObserver === 'undefined') return;
      var observer = new IntersectionObserver(function (entries) {
        entries.forEach(function (e) {
          if (!e.isIntersecting) return;
          var codeId = e.target.id;
          // 反查 nodeId
          var nodeId = null;
          for (var i = 0; i < nodeIds.length; i++) {
            if (mapping[nodeIds[i]] === codeId) { nodeId = nodeIds[i]; break; }
          }
          if (!nodeId) return;
          // 清除同图内其它 .is-active
          var prevActive = diagram.querySelectorAll('.is-active');
          Array.prototype.forEach.call(prevActive, function (n) {
            n.classList.remove('is-active');
          });
          // 高亮当前
          var current = diagram.querySelectorAll('[data-anchor="' + cssEscape(nodeId) + '"]');
          Array.prototype.forEach.call(current, function (n) {
            n.classList.add('is-active');
          });
        });
      }, { rootMargin: '-40% 0px -40% 0px' });

      codeIds.forEach(function (codeId) {
        var el = document.getElementById(codeId);
        if (el) observer.observe(el);
      });

      // 标记此 diagram 已绑定(供 setupLinkerSafe 去重)
      diagram.dataset.linkerBound = '1';
    });
  }

  // —— 工具:CSS.escape polyfill(应对 id 中可能出现的特殊字符)——
  function cssEscape(s) {
    if (typeof window.CSS !== 'undefined' && typeof window.CSS.escape === 'function') {
      return window.CSS.escape(s);
    }
    // 简易回退:仅处理双引号和反斜杠
    return String(s).replace(/\\/g, '\\\\').replace(/"/g, '\\"');
  }

  // 初始绑定 + Astro 视图转换后重新绑定 + SVG 内联完成后重新绑定
  // 注意:setupLinker 每次执行都会新增事件监听器,为避免重复绑定,
  //       我们用 dataset 标记已经绑定过的 diagram,跳过它。
  function setupLinkerSafe() {
    var diagrams = document.querySelectorAll('[data-diagram-id]');
    var anyUnbound = false;
    for (var i = 0; i < diagrams.length; i++) {
      if (!diagrams[i].dataset.linkerBound) { anyUnbound = true; break; }
    }
    if (!anyUnbound) return;
    setupLinker();
  }

  setupLinkerSafe();
  document.addEventListener('astro:page-load', setupLinkerSafe);
  // SVG 内联完成后(Diagram.astro 的 inlineSvgDiagrams dispatch 此事件)重新绑定
  document.addEventListener('diagram:inline', setupLinkerSafe);
})();