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.
https://kitbash.me/components/blueprint-manual/contents/figma.html?palette=deb0b8049fbca405
Use the Figma MCP server (https://mcp.figma.com/mcp). Download https://kitbash.me/components/blueprint-manual/contents/figma.html?palette=deb0b8049fbca405 and pass that whole HTML document to the html_to_figma tool, so the part "Table of contents with progress" lands as editable layers in my open Figma file. Fonts come from Google Fonts: if a face is missing in Figma, pick the closest one.
Code
<style>
/* Goes after the pack's base.css */
:root {
--paper: #e0e0e0;
--card: #0d0d0d;
--ink: #0f0e0d;
--ink-soft: #6f6f6e;
--ink-faint: #c2c2c1;
--blue-wash: #dadada;
--blue: #db491a;
--blue-light: #fff6f4;
--blue-mid: #fcbaa7;
--grid-dot: #feeeea;
}
</style>
<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">·</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>