kitbash Connect agent
Components

Table of contents with progress

Numbered chapter groups in three columns with dotted leaders. A Status / Words toggle swaps word counts for five-block progress meters. Below it a progress bar and a small ledger of numbers that count up when seen.

Part of the style

Blueprint Manual

7 parts that belong together, with their tokens, type and rules.

Preview

Code
<section class="contents" data-view="words">
  <header class="contents__head">
    <h2 class="contents__title">Table of Contents.<sup class="contents__version">v0.7</sup></h2>
    <span class="contents__line" aria-hidden="true"></span>
    <div class="contents__switch" role="group" aria-label="What to show next to each chapter">
      <button class="contents__option" type="button" data-show="status" aria-pressed="false">Status</button>
      <span class="contents__sep" aria-hidden="true">&middot;</span>
      <button class="contents__option" type="button" data-show="words" aria-pressed="true">Words</button>
    </div>
  </header>

  <div class="contents__groups">
    <section class="contents__group">
      <h3 class="contents__heading"><span class="contents__ordinal">1.</span> Heat and water</h3>
      <ul class="contents__list">
        <li><a class="contents__row" href="#"><span class="contents__name">How a kettle knows when to stop.</span><span class="contents__dots"></span><span class="contents__words">3.4k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">The stovetop pot.</span><span class="contents__dots"></span><span class="contents__words">5.9k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Pressure cookers.</span><span class="contents__dots"></span><span class="contents__words">2.2k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Why toast browns.</span><span class="contents__dots"></span><span class="contents__words">3.1k words</span><span class="contents__meter" style="--done: 4" aria-label="Four fifths done"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Induction.</span><span class="contents__dots"></span><span class="contents__words">4.6k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
      </ul>
    </section>

    <section class="contents__group">
      <h3 class="contents__heading"><span class="contents__ordinal">2.</span> Cold</h3>
      <ul class="contents__list">
        <li><a class="contents__row" href="#"><span class="contents__name">The loop inside a fridge.</span><span class="contents__dots"></span><span class="contents__words">5.2k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Ice makers.</span><span class="contents__dots"></span><span class="contents__words">1.8k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Thermostats.</span><span class="contents__dots"></span><span class="contents__words">2.7k words</span><span class="contents__meter" style="--done: 3" aria-label="Three fifths done"></span></a></li>
      </ul>
    </section>

    <section class="contents__group">
      <h3 class="contents__heading"><span class="contents__ordinal">3.</span> Things that spin</h3>
      <ul class="contents__list">
        <li><a class="contents__row" href="#"><span class="contents__name">Blenders.</span><span class="contents__dots"></span><span class="contents__words">3.6k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">The stand mixer gearbox.</span><span class="contents__dots"></span><span class="contents__words">4.4k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Salad spinners.</span><span class="contents__dots"></span><span class="contents__words">1.3k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Hand-crank grinders.</span><span class="contents__dots"></span><span class="contents__words">2.9k words</span><span class="contents__meter" style="--done: 2" aria-label="Two fifths done"></span></a></li>
      </ul>
    </section>

    <section class="contents__group">
      <h3 class="contents__heading"><span class="contents__ordinal">4.</span> Time</h3>
      <ul class="contents__list">
        <li><a class="contents__row" href="#"><span class="contents__name">Egg timers.</span><span class="contents__dots"></span><span class="contents__words">1.6k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">The microwave turntable.</span><span class="contents__dots"></span><span class="contents__words">2.4k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Clockwork toasters.</span><span class="contents__dots"></span><span class="contents__words"></span><span class="contents__meter" style="--done: 1" aria-label="Just started"></span></a></li>
      </ul>
    </section>

    <section class="contents__group">
      <h3 class="contents__heading"><span class="contents__ordinal">5.</span> Small mechanisms</h3>
      <ul class="contents__list">
        <li><a class="contents__row" href="#"><span class="contents__name">Can openers.</span><span class="contents__dots"></span><span class="contents__words">2.0k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Corkscrews.</span><span class="contents__dots"></span><span class="contents__words">2.8k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">The pepper mill.</span><span class="contents__dots"></span><span class="contents__words">3.3k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">Whisks, briefly.</span><span class="contents__dots"></span><span class="contents__words"></span><span class="contents__meter" style="--done: 0" aria-label="Not started"></span></a></li>
      </ul>
    </section>

    <section class="contents__group">
      <h3 class="contents__heading"><span class="contents__ordinal">6.</span> Misc</h3>
      <ul class="contents__list">
        <li><a class="contents__row" href="#"><span class="contents__name">Kitchen scales.</span><span class="contents__dots"></span><span class="contents__words">2.1k words</span><span class="contents__meter" style="--done: 5" aria-label="Finished"></span></a></li>
        <li><a class="contents__row" href="#"><span class="contents__name">The smoke alarm.</span><span class="contents__dots"></span><span class="contents__words"></span><span class="contents__meter" style="--done: 2" aria-label="Two fifths done"></span></a></li>
      </ul>
    </section>
  </div>

  <div class="contents__ledger">
    <div class="contents__progress">
      <h3 class="contents__subtitle">Current progress:</h3>
      <div class="contents__bar" style="--fill: 71%" role="img" aria-label="15 of 21 chapters finished"></div>
    </div>
    <dl class="contents__stats">
      <div class="contents__stat"><dt>Finished chapters:</dt><dd><span data-count="15">15</span> / 21</dd></div>
      <div class="contents__stat"><dt>Words so far:</dt><dd><span data-count="55.3" data-decimals="1">55.3</span>k</dd></div>
      <div class="contents__stat"><dt>Drawings/chapter:</dt><dd><span data-count="12">12</span></dd></div>
      <div class="contents__stat"><dt>Est. word count:</dt><dd><span data-count="78.0" data-decimals="1">78.0</span>k</dd></div>
      <div class="contents__stat"><dt>Parts labelled:</dt><dd><span data-count="1406">1406</span></dd></div>
      <div class="contents__stat"><dt>Screws lost:</dt><dd><span data-count="7">7</span></dd></div>
    </dl>
  </div>
</section>

<style>
  .contents {
    container-type: inline-size;
    padding: var(--space-section) var(--gutter) 0;
  }

  .contents__head {
    display: flex;
    align-items: baseline;
    gap: 1rem;
  }

  .contents__title {
    position: relative;
    margin: 0;
    font-size: var(--text-body);
    font-weight: 400;
    white-space: nowrap;
  }

  .contents__version {
    position: absolute;
    right: -0.25rem;
    bottom: 100%;
    transform: translateX(100%);
    font-family: var(--font-label);
    font-size: var(--text-micro);
    letter-spacing: var(--tracking-label);
    text-transform: uppercase;
    color: var(--ink-soft);
  }

  .contents__line {
    flex: 1;
    min-width: 1rem;
    border-bottom: 1px solid var(--ink);
  }

  .contents__switch {
    display: flex;
    align-items: center;
    gap: 0.25rem;
  }

  .contents__option,
  .contents__sep {
    font-family: var(--font-label);
    font-size: var(--text-label);
    letter-spacing: var(--tracking-label);
    text-transform: uppercase;
  }

  .contents__option {
    position: relative;
    padding: 0 0.25rem;
    border: 0;
    background: none;
    color: var(--ink);
    cursor: pointer;
    transition: color var(--time-quick) var(--ease);
  }

  .contents__option::after {
    content: "";
    position: absolute;
    inset: 50% 0 auto;
    height: var(--tap);
    transform: translateY(-50%);
  }

  .contents__option:hover,
  .contents__option[aria-pressed="true"] {
    color: var(--blue);
  }

  .contents__option:focus-visible {
    outline: 1px dashed var(--blue);
    outline-offset: 4px;
  }

  .contents__groups {
    columns: 3 17rem;
    column-gap: var(--column-gap);
    margin-top: clamp(3rem, 7cqi, 6rem);
  }

  .contents__group {
    break-inside: avoid;
    padding-bottom: 2rem;
  }

  .contents__heading {
    margin: 0 0 0.75rem;
    font-family: var(--font-label);
    font-size: 0.9375rem;
    font-weight: 400;
    letter-spacing: var(--tracking-label);
    text-transform: uppercase;
  }

  .contents__ordinal {
    display: inline-block;
    min-width: 1.75rem;
  }

  .contents__list {
    margin: 0;
    padding: 0 0 0 1.75rem;
    list-style: none;
  }

  .contents__row {
    position: relative;
    display: grid;
    grid-template-columns: auto 1fr auto;
    align-items: baseline;
    gap: 0 0.35rem;
    min-height: 1.875rem;
    padding-left: 1rem;
    font-size: var(--text-small);
    line-height: 1.875rem;
    text-decoration: none;
    color: var(--ink);
    transition: color var(--time-quick) var(--ease);
  }

  .contents__row::before {
    content: "";
    position: absolute;
    top: 50%;
    left: 0;
    width: 4px;
    height: 4px;
    border-radius: 50%;
    background: currentColor;
    transform: translateY(-50%);
  }

  .contents__row:hover,
  .contents__row:focus-visible {
    color: var(--blue);
    outline: none;
  }

  .contents__row:focus-visible .contents__name {
    text-decoration: underline dotted;
    text-underline-offset: 0.25em;
  }

  .contents__dots {
    align-self: end;
    margin-bottom: 0.55em;
    border-bottom: 1px dotted currentColor;
    opacity: 0.45;
  }

  .contents__words {
    font-family: var(--font-label);
    font-size: var(--text-micro);
    letter-spacing: var(--tracking-label);
    text-transform: uppercase;
    color: var(--ink-soft);
  }

  .contents__meter {
    align-self: center;
    width: 52px;
    height: 8px;
    background:
      linear-gradient(var(--blue), var(--blue)) 0 0 / calc(var(--done) * 11px) 100% no-repeat,
      var(--pattern-dither) 0 0 / 2px 2px;
    -webkit-mask-image: var(--pattern-ticks);
    mask-image: var(--pattern-ticks);
  }

  .contents[data-view="words"] .contents__meter,
  .contents[data-view="status"] .contents__words {
    display: none;
  }

  .contents__words,
  .contents__meter {
    animation: contents-swap var(--time) var(--ease);
  }

  .contents__ledger {
    max-width: 36rem;
    margin: clamp(2rem, 6cqi, 5rem) auto 0;
  }

  .contents__progress {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 1rem;
    padding: 0 0.375rem 0.75rem;
    border-bottom: 1px solid var(--ink);
  }

  .contents__subtitle {
    margin: 0;
    font-size: var(--text-body);
    font-weight: 400;
  }

  .contents__bar {
    position: relative;
    width: min(10.5rem, 45%);
    height: 0.9375rem;
    border: 1px solid var(--blue);
    background:
      linear-gradient(var(--blue), var(--blue)) 0 0 / var(--fill) 100% no-repeat,
      var(--pattern-grid) 0 0 / 3px 3px,
      var(--blue-wash);
    transition: background-size var(--time-long) var(--ease-settle);
  }

  .contents__bar::after {
    content: "";
    position: absolute;
    inset: 0;
    background: repeating-linear-gradient(90deg, transparent 0 calc(100% / 14 - 1px), var(--blue-mid) 0 calc(100% / 14));
    opacity: 0.6;
  }

  .contents__stats {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(13rem, 1fr));
    gap: 0 clamp(2rem, 8cqi, 6rem);
    margin: 1.5rem 0 0;
    padding: 0 0.375rem;
  }

  .contents__stat {
    display: flex;
    justify-content: space-between;
    gap: 1rem;
    font-family: var(--font-label);
    font-size: var(--text-micro);
    letter-spacing: var(--tracking-label);
    line-height: 2;
    text-transform: uppercase;
  }

  .contents__stat dt {
    color: var(--ink-soft);
  }

  .contents__stat dd {
    margin: 0;
    font-variant-numeric: tabular-nums;
  }

  @container (max-width: 43.99rem) {
    .contents__head {
      flex-wrap: wrap;
    }

    .contents__row {
      min-height: var(--tap);
      line-height: 1.4;
      align-items: center;
    }

    .contents__dots {
      align-self: center;
      margin-bottom: 0;
    }
  }

  @keyframes contents-swap {
    from {
      opacity: 0;
      filter: blur(3px);
    }
    to {
      opacity: 1;
      filter: blur(0);
    }
  }

  @media (prefers-reduced-motion: reduce) {
    .contents__words,
    .contents__meter {
      animation: none;
    }

    .contents__bar {
      transition: none;
    }
  }
</style>

<script>
  (() => {
    const prefersStill = matchMedia('(prefers-reduced-motion: reduce)').matches;

    const wireSwitch = (root) => {
      const options = root.querySelectorAll('.contents__option');
      options.forEach((option) =>
        option.addEventListener('click', () => {
          root.dataset.view = option.dataset.show;
          options.forEach((other) => other.setAttribute('aria-pressed', String(other === option)));
        })
      );
    };

    const countUp = (number) => {
      const duration = parseFloat(getComputedStyle(number).getPropertyValue('--time-long'));
      const target = Number(number.dataset.count);
      const decimals = Number(number.dataset.decimals || 0);
      const started = performance.now();
      const tick = (now) => {
        const progress = Math.min(1, (now - started) / duration);
        const eased = 1 - Math.pow(1 - progress, 3);
        number.textContent = (target * eased).toFixed(decimals);
        if (progress < 1) requestAnimationFrame(tick);
      };
      requestAnimationFrame(tick);
    };

    const refill = (bar) => {
      const fill = bar.style.getPropertyValue('--fill');
      bar.style.transition = 'none';
      bar.style.setProperty('--fill', '0%');
      bar.getBoundingClientRect();
      bar.style.transition = '';
      bar.style.setProperty('--fill', fill);
    };

    const tallyWhenSeen = (root) => {
      const ledger = root.querySelector('.contents__ledger');
      if (prefersStill || !ledger || !('IntersectionObserver' in window)) return;
      const seen = new IntersectionObserver(
        ([entry]) => {
          if (!entry.isIntersecting) return;
          ledger.querySelectorAll('[data-count]').forEach(countUp);
          ledger.querySelectorAll('.contents__bar').forEach(refill);
          seen.disconnect();
        },
        { threshold: 0.6 }
      );
      seen.observe(ledger);
    };

    document.querySelectorAll('.contents').forEach((root) => {
      wireSwitch(root);
      tallyWhenSeen(root);
    });
  })();
</script>

Similar components

Ray lab

Ray lab

Contents with buttons

Contents with buttons

Insights

Insights

Capability rows

Capability rows

News

News

Investment ledger

Investment ledger

Coming soon

Coming soon

Entry columns

Entry columns