ClassyGitShadowzzh

LeftTOC.astro

LeftTOC.astro
---
// src/components/LeftTOC.astro
// Shows all TS-variant modules in the left sidebar; highlights current.
// 标题可点击收起/展开,状态记到 localStorage(key: pi-agent-book:toc-collapsed)。
import { getAllModules, type ModuleEntry } from '../utils/collection';

interface Props { currentEntry: ModuleEntry; }
const { currentEntry } = Astro.props;
const allModules = (await getAllModules()).filter(m => m.data.variant === 'ts');
const currentBaseSlug = currentEntry.slug.replace(/\.python$/, '');
---

<nav class="toc" id="left-toc" aria-label="目录">
  <button
    class="toc-toggle"
    type="button"
    aria-expanded="true"
    aria-controls="toc-list"
  >
    <span class="toc-toggle-bar" aria-hidden="true"></span>
    <span class="toc-toggle-label">章节目录</span>
    <svg class="toc-toggle-caret" width="10" height="10" viewBox="0 0 10 10" aria-hidden="true">
      <path d="M2.5 3.5L5 6.5L7.5 3.5" stroke="currentColor" fill="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round"/>
    </svg>
  </button>
  <ul class="toc-list" id="toc-list">
    {allModules.map(m => {
      const isCurrent = m.slug === currentBaseSlug;
      return (
        <li class={`toc-item ${isCurrent ? 'is-current' : ''}`}>
          <a href={`/modules/${m.slug}`}>
            <span class="toc-num">{m.data.module}</span>
            <span class="toc-title">{m.data.title}</span>
          </a>
        </li>
      );
    })}
  </ul>
</nav>

<script>
  const STORAGE_KEY = 'pi-agent-book:toc-collapsed';
  const nav = document.getElementById('left-toc');
  if (nav) {
    const btn = nav.querySelector<HTMLButtonElement>('.toc-toggle');
    const list = document.getElementById('toc-list');
    if (btn && list) {
      // 恢复持久化状态(SSR 默认展开,JS 接管后再 collapse 避免 FOUC)
      let collapsed = false;
      try { collapsed = localStorage.getItem(STORAGE_KEY) === 'true'; } catch { /* noop */ }
      if (collapsed) {
        nav.classList.add('is-collapsed');
        btn.setAttribute('aria-expanded', 'false');
      }

      btn.addEventListener('click', () => {
        const next = !nav.classList.contains('is-collapsed');
        nav.classList.toggle('is-collapsed', next);
        btn.setAttribute('aria-expanded', next ? 'false' : 'true');
        try { localStorage.setItem(STORAGE_KEY, String(next)); } catch { /* noop */ }
      });
    }
  }
</script>

<style is:global>
/* is:global:runtime 切 class 不依赖 scoped cid,selector 一定匹配。
   所有规则以 .toc- 前缀专属,不会污染全局。 */
.toc { position: sticky; top: calc(var(--topbar-h) + var(--space-6)); max-height: calc(100vh - var(--topbar-h) - var(--space-6) - var(--space-5)); overflow-y: auto; }

.toc-toggle {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  width: 100%;
  padding: var(--space-2) var(--space-3) var(--space-2) 0;
  margin-bottom: var(--space-3);
  background: transparent;
  border: none;
  border-radius: var(--radius-sm);
  cursor: pointer;
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 600;
  letter-spacing: 0.05em;
  color: var(--soft);
  transition: color var(--dur-fast) var(--ease), background var(--dur-fast) var(--ease);
}
.toc-toggle:hover {
  color: var(--ink);
  background: var(--paper-sunken);
}
.toc-toggle:focus-visible {
  outline: var(--outline-w) solid var(--accent);
  outline-offset: var(--outline-offset);
}
.toc-toggle-bar {
  width: 3px;
  height: 14px;
  background: var(--soft);
  border-radius: 2px;
  flex-shrink: 0;
  transition: background var(--dur-fast) var(--ease), height var(--dur-fast) var(--ease);
}
.toc-toggle:hover .toc-toggle-bar {
  background: var(--accent);
  height: 18px;
}
.toc-toggle-label {
  flex: 1;
  text-align: left;
}
.toc-toggle-caret {
  flex-shrink: 0;
  color: currentColor;
  transition: transform var(--dur-base) var(--ease);
}
.toc.is-collapsed .toc-toggle-caret {
  transform: rotate(-90deg);
}
.toc.is-collapsed .toc-list {
  display: none;
}

.toc-list { list-style: none; padding: 0; margin: 0; }
.toc-item { margin-bottom: var(--space-3); }
.toc-item a {
  display: flex;
  gap: var(--space-3);
  align-items: baseline;
  padding: 8px 12px;
  border-radius: var(--radius-sm);
  font-size: 16px;
  color: var(--muted);
  text-decoration: none;
  transition: all var(--dur-fast);
}
.toc-item a:hover { background: var(--paper-sunken); color: var(--ink); }
.toc-item.is-current > a { background: var(--accent-soft); color: var(--accent); font-weight: 500; }
.toc-num { font-family: var(--font-mono); font-size: 13px; flex-shrink: 0; }
</style>