hexo-theme-stellar 1.40.0 → 1.41.0

package/source/js/main.js

@@ -97,6 +97,30 @@ const hud = {
 
 const l_body = document.querySelector('.l_body');
 
+const sidebar = {
+  leftbar: () => {
+    if (l_body) {
+      l_body.toggleAttribute('leftbar');
+      l_body.removeAttribute('rightbar');
+    }
+  },
+  rightbar: () => {
+    if (l_body) {
+      l_body.toggleAttribute('rightbar');
+      l_body.removeAttribute('leftbar');
+    }
+  },
+  dismiss: () => {
+    if (l_body) {
+      l_body.removeAttribute('leftbar');
+      l_body.removeAttribute('rightbar');
+    }
+  },
+  toggleTOC: () => {
+    document.querySelector('#data-toc').classList.toggle('collapse');
+  }
+}
+
 // 通用平滑滚动（自定义动画，TOC / 回到顶部 / 参与讨论共用）
 let scrollAnim = null;
 function cancelSmoothScroll() {
@@ -217,6 +241,40 @@ function bindTocClick(widget) {
   });
 }
 
+// 通用页内锚点平滑滚动（标题左侧 headerlink、{% navbar %} 页内导航、脚注回链等）
+// 已被其他处理器拦截的点击（TOC、tabs、wiki #start 等）通过 defaultPrevented 跳过，避免重复滚动
+function bindAnchorClick() {
+  document.addEventListener('click', function (e) {
+    const link = e.target.closest('a[href^="#"]');
+    if (!link || e.defaultPrevented) {
+      return;
+    }
+    const href = link.getAttribute('href');
+    if (!href || href.indexOf('#') !== 0) {
+      return;
+    }
+    let id = href.slice(1);
+    try {
+      id = decodeURIComponent(id);
+    } catch (err) {
+      // 片段含非法编码时按原样查找
+    }
+    const target = id && document.getElementById(id);
+    if (!target) {
+      return;
+    }
+    e.preventDefault();
+    // #start 锚点贴顶滚动，不预留 offset；其余锚点与 TOC 点击滚动保持一致（32px）
+    const offset = id === 'start' ? 0 : 32;
+    const targetY = target.getBoundingClientRect().top + window.scrollY - offset;
+    smoothScrollTo(targetY);
+    if (window.history && window.history.pushState) {
+      window.history.pushState(null, '', href);
+    }
+  });
+}
+bindAnchorClick();
+
 // 远程 md 渲染完成后由页面层重建右栏 TOC
 document.addEventListener('stellar:mdrender', function (e) {
   rebuildToc(e.detail && e.detail.target);
@@ -367,6 +425,61 @@ const init = {
       }
     } catch (e) {}
   },
+  navbarPin: () => {
+    // 列表页 navbar top 背景条状态切换：未吸顶为卡片样式（var(--card) + 文章卡片同款阴影），
+    // 吸顶后恢复玻璃效果。在吸顶边界切换 .pinned 类，视觉由 CSS 控制。
+    // 吸顶判定直接测 navbar 的实际视口位置，而非用 scrollY 推算：
+    // 移动端浏览器顶栏伸缩会改变 scrollY（展开顶栏时 scrollY 减小），
+    // 即使 navbar 仍吸顶也可能跌破阈值，导致玻璃效果误消失。
+    const navbars = document.querySelectorAll('.navbar.top');
+    if (navbars.length === 0) {
+      return;
+    }
+    // 视口顶部允许的偏差（px），吸收亚像素/取整误差
+    const TOLERANCE = 2;
+    let states = [];
+    function update() {
+      states.forEach((state) => {
+        const top = state.navbar.getBoundingClientRect().top;
+        state.bar.classList.toggle('pinned', top <= state.stickyTop + TOLERANCE);
+      });
+    }
+    function measure() {
+      states = [];
+      navbars.forEach((navbar) => {
+        const bar = navbar.querySelector('.navbar-blur');
+        if (bar == null) {
+          return;
+        }
+        // getComputedStyle().top 自动兼容桌面 var(--gap-margin) 与移动端 8pt
+        const stickyTop = parseFloat(getComputedStyle(navbar).top) || 16;
+        states.push({
+          navbar: navbar,
+          bar: bar,
+          stickyTop: stickyTop
+        });
+      });
+      update();
+    }
+    let ticking = false;
+    window.addEventListener('scroll', () => {
+      if (ticking) {
+        return;
+      }
+      ticking = true;
+      utils.requestAnimationFrame(() => {
+        update();
+        ticking = false;
+      });
+    }, { passive: true });
+    // 顶栏伸缩不一定触发 scroll，兜底监听 visualViewport 尺寸变化
+    if (window.visualViewport) {
+      window.visualViewport.addEventListener('resize', update);
+    }
+    window.addEventListener('resize', measure);
+    window.addEventListener('pageshow', measure);
+    measure();
+  },
   relativeDate: (selector) => {
     selector.forEach(item => {
       const $this = item
@@ -509,6 +622,7 @@ stellar.initPage = function () {
   init.sidebar();
   init.wikiStart();
   init.leftbarScroll();
+  init.navbarPin();
   init.relativeDate(document.querySelectorAll('#post-meta time'));
   init.registerTabsTag();
 };

package/source/js/search/highlight.js

@@ -0,0 +1,82 @@
+// 搜索跳转高亮：URL 带 ?kw= 时在正文中高亮匹配词
+(function () {
+  var params;
+  try {
+    params = new URLSearchParams(window.location.search);
+  } catch (e) {
+    return;
+  }
+  var keyword = (params.get('kw') || '').trim();
+  if (!keyword) return;
+
+  function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  }
+
+  function highlightKeyword() {
+    // 优先主栏正文（避免命中 wiki 封面等其它 md-text 容器）
+    var root = document.querySelector('.l_main .md-text') || document.querySelector('.md-text');
+    if (!root) return;
+
+    var re = new RegExp(escapeRegExp(keyword), 'gi');
+    var textNodes = [];
+    var walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+      acceptNode: function (node) {
+        var parent = node.parentElement;
+        if (!parent) return NodeFilter.FILTER_REJECT;
+        // 跳过脚本/样式内容与已存在的 mark 高亮
+        if (parent.closest('script, style, noscript, .tag-plugin.mark')) {
+          return NodeFilter.FILTER_REJECT;
+        }
+        return NodeFilter.FILTER_ACCEPT;
+      }
+    });
+    var node;
+    while ((node = walker.nextNode())) {
+      textNodes.push(node);
+    }
+
+    var limit = 50;
+    var count = 0;
+    for (var i = 0; i < textNodes.length && count < limit; i++) {
+      var textNode = textNodes[i];
+      var text = textNode.nodeValue || '';
+      var frag = document.createDocumentFragment();
+      var lastIndex = 0;
+      var m;
+      re.lastIndex = 0;
+      while (count < limit && (m = re.exec(text)) !== null) {
+        if (m.index > lastIndex) {
+          frag.appendChild(document.createTextNode(text.slice(lastIndex, m.index)));
+        }
+        var mark = document.createElement('mark');
+        mark.className = 'tag-plugin colorful mark';
+        mark.setAttribute('color', 'yellow');
+        mark.textContent = m[0];
+        frag.appendChild(mark);
+        count += 1;
+        lastIndex = m.index + m[0].length;
+      }
+      if (lastIndex === 0) continue;
+      if (lastIndex < text.length) {
+        frag.appendChild(document.createTextNode(text.slice(lastIndex)));
+      }
+      textNode.parentNode.replaceChild(frag, textNode);
+    }
+
+    // 无锚点时（intro / 仅标题命中）滚动到第一个匹配词，实现定位
+    if (!window.location.hash) {
+      var first = root.querySelector('mark.tag-plugin.mark[color="yellow"]');
+      if (first) {
+        var top = first.getBoundingClientRect().top + window.scrollY - 32;
+        window.scrollTo({ top: Math.max(0, top), behavior: 'instant' });
+      }
+    }
+  }
+
+  if (document.readyState !== 'loading') {
+    highlightKeyword();
+  } else {
+    document.addEventListener('DOMContentLoaded', highlightKeyword);
+  }
+})();