Download Link
A download link that shows the file's type and weight beside its words, read from the file itself. On hover the arrow sinks into its tray; a click sends it through and back from the top.
View codeQuote Link
Select words in an article and a pill offers a link to them: the page's address with a text fragment, which opens it scrolled to the quote and highlighted. It rolls to Link copied with a check.
Links
No dependencies
linkquotesharetext fragmenthighlightcopyarticlewordpress
Added Oct 2026
With your AI
Just ask.
Say it to your AI. It gets the exact code below, not its best guess, and knows where it goes.
Add the Kodza Quote Link to my page.
Not plugged in yet?
Also in Codex, Cursor and VS Code.
claude mcp add -t http kodza https://kodza.dev/api/mcp
<div class="kodza-quote-link" data-kodza-quote-link>
<h2>What happened</h2>
<p>At 5:58 pm on a Friday, a config change took the checkout down for eleven minutes. The rollback took two. Finding the person who knew the rollback took nine.</p>
<p>Nothing was lost. Orders placed during those minutes were retried by the queue and went through once the checkout came back.</p>
<h2>What we changed</h2>
<p>Config changes now go through the same review as code. The rollback is a button in the dashboard, and its runbook fits on one screen.</p>
</div>/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Quote Link
Select a sentence in the article: a pill comes up over it and copies a link that opens the page
on that sentence, highlighted (a text fragment, #:~:text=…). The pill stays centred on the first
line, goes below the last one on a touch screen (the system menu is above) or when the top of
the window is too close, and rolls to "Link copied" with a check.
Tuned with the --kz-quote-link-* variables. */
.kodza-quote-link {
--kz-quote-link-heading: #0a0a0a;
--kz-quote-link-text: rgba(10, 10, 10, 0.72);
--kz-quote-link-pill: #0a0a0a;
--kz-quote-link-pill-ink: #fff;
--kz-quote-link-pill-hover: #262626;
--kz-quote-link-shadow: 0 1px 2px rgba(10, 10, 10, 0.12), 0 10px 28px rgba(10, 10, 10, 0.18);
--kz-quote-link-mark: rgba(10, 10, 10, 0.14);
--kz-quote-link-duration: 0.22s;
--kz-quote-link-ease: cubic-bezier(0.22, 1, 0.36, 1);
position: relative;
}
/* The article it holds: its own type, whatever the theme gives to headings and paragraphs (an
empty root leaves the page's own text as it is) */
.kodza-quote-link > h2,
.kodza-quote-link > h3 {
color: var(--kz-quote-link-heading);
font-family: "Geist", system-ui, sans-serif;
font-weight: 600;
text-align: start;
}
.kodza-quote-link > h2 {
margin: 56px 0 14px;
font-size: clamp(24px, 4vw, 32px);
line-height: 1.2;
letter-spacing: -0.035em;
}
.kodza-quote-link > h3 {
margin: 36px 0 10px;
font-size: 20px;
line-height: 1.3;
letter-spacing: -0.025em;
}
.kodza-quote-link > :is(h2, h3):first-child {
margin-top: 0;
}
.kodza-quote-link > p {
margin: 0 0 1.1em;
color: var(--kz-quote-link-text);
font-family: "Geist", system-ui, sans-serif;
font-size: 17px;
line-height: 1.7;
text-wrap: pretty;
}
.kodza-quote-link > p:last-child {
margin-bottom: 0;
}
/* Where the pill stands (placed by the script with translate): centred on the line above it,
below it with .is-below */
.kodza-quote-link__float {
position: absolute;
top: 0;
left: 0;
z-index: 20;
pointer-events: none;
visibility: hidden;
transform: translate(-50%, -100%);
transition: visibility 0s linear 0.16s;
}
.kodza-quote-link__float.is-below {
transform: translate(-50%, 0);
}
/* Shown, it glides to a new selection instead of jumping */
.kodza-quote-link__float.is-shown {
pointer-events: auto;
visibility: visible;
transition: translate 0.32s var(--kz-quote-link-ease), transform 0.32s var(--kz-quote-link-ease), visibility 0s;
}
.kodza-quote-link__pill {
display: inline-flex;
align-items: center;
gap: 8px;
box-sizing: border-box;
height: 36px;
margin: 0;
padding: 0 14px 0 12px;
border: 0;
border-radius: 999px;
background: var(--kz-quote-link-pill);
box-shadow: var(--kz-quote-link-shadow);
color: var(--kz-quote-link-pill-ink);
font: 500 14px/20px "Geist", system-ui, sans-serif;
letter-spacing: -0.01em;
text-transform: none;
white-space: nowrap;
cursor: pointer;
user-select: none;
-webkit-user-select: none;
-webkit-tap-highlight-color: transparent;
opacity: 0;
scale: 0.96;
translate: 0 6px;
transform-origin: 50% 100%;
transition: opacity 0.16s ease, scale 0.16s ease, translate 0.16s ease, background-color 0.15s ease;
}
.kodza-quote-link__float.is-below .kodza-quote-link__pill {
translate: 0 -6px;
transform-origin: 50% 0;
}
.kodza-quote-link__float.is-shown .kodza-quote-link__pill {
opacity: 1;
scale: 1;
translate: 0 0;
transition: opacity var(--kz-quote-link-duration) var(--kz-quote-link-ease), scale var(--kz-quote-link-duration) var(--kz-quote-link-ease), translate var(--kz-quote-link-duration) var(--kz-quote-link-ease), background-color 0.15s ease;
}
.kodza-quote-link__pill:hover {
background: var(--kz-quote-link-pill-hover);
}
.kodza-quote-link__pill:focus-visible {
outline: 2px solid var(--kz-quote-link-pill);
outline-offset: 3px;
}
/* The chain and the check share one cell: one leaves upwards as the other comes up and draws */
.kodza-quote-link__icon {
display: grid;
flex: none;
width: 16px;
height: 16px;
clip-path: inset(0);
}
.kodza-quote-link__icon svg {
grid-area: 1 / 1;
display: block;
width: 16px;
height: 16px;
fill: none;
stroke: currentColor;
stroke-width: 1.6;
stroke-linecap: round;
stroke-linejoin: round;
transition: translate var(--kz-quote-link-duration) var(--kz-quote-link-ease);
}
.kodza-quote-link__check {
translate: 0 110%;
}
.kodza-quote-link__check path {
stroke-dasharray: 1;
stroke-dashoffset: 1;
transition: stroke-dashoffset 0.2s ease;
}
.kodza-quote-link__pill.is-copied:not(.is-failed) .kodza-quote-link__chain {
translate: 0 -110%;
}
.kodza-quote-link__pill.is-copied:not(.is-failed) .kodza-quote-link__check {
translate: 0 0;
}
.kodza-quote-link__pill.is-copied:not(.is-failed) .kodza-quote-link__check path {
stroke-dashoffset: 0;
transition: stroke-dashoffset 0.3s var(--kz-quote-link-ease) 0.08s;
}
/* The words roll in their mask: the old one up and out, the new one in from below. The label's
width follows, measured in the script */
.kodza-quote-link__label {
position: relative;
display: block;
overflow: hidden;
}
.kodza-quote-link__word,
.kodza-quote-link__done {
display: block;
transition: translate var(--kz-quote-link-duration) var(--kz-quote-link-ease);
}
.kodza-quote-link__done {
position: absolute;
top: 0;
left: 0;
translate: 0 110%;
}
.kodza-quote-link__pill.is-copied .kodza-quote-link__word {
position: absolute;
top: 0;
left: 0;
translate: 0 -110%;
}
.kodza-quote-link__pill.is-copied .kodza-quote-link__done {
position: static;
translate: 0 0;
transition-delay: 0.06s;
}
/* For screen readers: what happened after the click */
.kodza-quote-link__status {
position: absolute;
width: 1px;
height: 1px;
overflow: hidden;
clip-path: inset(50%);
white-space: nowrap;
}
/* Opened from a quote link: the sentence in the page's ink, not the browser's yellow (also in the
article an empty root dresses) */
.kodza-quote-link ::target-text,
:has(> .kodza-quote-link) ::target-text {
background-color: var(--kz-quote-link-mark, rgba(10, 10, 10, 0.14));
color: inherit;
}
@media (prefers-reduced-motion: reduce) {
.kodza-quote-link__float,
.kodza-quote-link__float *,
.kodza-quote-link__check path {
transition-duration: 0.01ms !important;
transition-delay: 0s !important;
}
}
/* kodza-guard 854a28a19548 — generated by Kodza, do not edit.
Theme guard: keeps a site's own CSS (WordPress themes, Bootstrap, CSS resets…) off this
component. :not(#_) is always true and weighs as much as an id, so these lines win over
theme rules made of classes and tags. Customise the component through its --kz-* variables. */
/* What the browser gives, where the component sets it only in some states: at the lowest weight, so its own rules below put it back */
:where(.kodza-quote-link__pill):not(#_) {
outline: revert;
outline-offset: revert;
}
/* What the browser gives, on everything the component leaves to it */
.kodza-quote-link:not(#_),
.kodza-quote-link__float:not(#_),
.kodza-quote-link__icon:not(#_),
.kodza-quote-link__label:not(#_),
.kodza-quote-link__word:not(#_),
.kodza-quote-link__done:not(#_),
.kodza-quote-link__status:not(#_) {
box-sizing: revert;
}
.kodza-quote-link__pill:not(#_) {
text-decoration: revert;
list-style: revert;
float: revert;
position: revert;
appearance: revert;
max-width: revert;
max-height: revert;
text-underline-offset: revert;
text-align: revert;
text-indent: revert;
text-shadow: revert;
vertical-align: revert;
min-height: revert;
}
.kodza-quote-link__chain:not(#_),
.kodza-quote-link__check:not(#_) {
border: revert;
margin: revert;
padding: revert;
border-radius: revert;
outline: revert;
text-decoration: revert;
list-style: revert;
box-sizing: revert;
float: revert;
position: revert;
background-color: revert;
background-image: revert;
box-shadow: revert;
outline-offset: revert;
appearance: revert;
max-width: revert;
max-height: revert;
color: revert;
font-family: revert;
font-size: revert;
font-weight: revert;
font-style: revert;
line-height: revert;
letter-spacing: revert;
text-transform: revert;
text-underline-offset: revert;
text-align: revert;
text-indent: revert;
text-shadow: revert;
vertical-align: revert;
}
.kodza-quote-link h2:where(:not([class*="kodza-"]):not(.kodza-quote-link [class*="kodza-"] *)):not(#_) {
border: revert;
padding: revert;
border-radius: revert;
outline: revert;
text-decoration: revert;
transition: revert;
list-style: revert;
box-sizing: revert;
float: revert;
position: revert;
background-color: revert;
background-image: revert;
box-shadow: revert;
outline-offset: revert;
appearance: revert;
max-width: revert;
max-height: revert;
font-style: revert;
text-transform: revert;
text-underline-offset: revert;
text-indent: revert;
text-shadow: revert;
vertical-align: revert;
}
.kodza-quote-link p:where(:not([class*="kodza-"]):not(.kodza-quote-link [class*="kodza-"] *)):not(#_) {
border: revert;
padding: revert;
border-radius: revert;
outline: revert;
text-decoration: revert;
transition: revert;
list-style: revert;
box-sizing: revert;
float: revert;
position: revert;
background-color: revert;
background-image: revert;
box-shadow: revert;
outline-offset: revert;
appearance: revert;
max-width: revert;
max-height: revert;
font-weight: revert;
font-style: revert;
letter-spacing: revert;
text-transform: revert;
text-underline-offset: revert;
text-align: revert;
text-indent: revert;
text-shadow: revert;
vertical-align: revert;
}
.kodza-quote-link h2:where(:not([class*="kodza-"]):not(.kodza-quote-link [class*="kodza-"] *)):not(#_):where(:not([hidden])),
.kodza-quote-link p:where(:not([class*="kodza-"]):not(.kodza-quote-link [class*="kodza-"] *)):not(#_):where(:not([hidden])) {
display: revert;
}
.kodza-quote-link h2:where(:not([class*="kodza-"]):not(.kodza-quote-link [class*="kodza-"] *)):not(#_):where([hidden]),
.kodza-quote-link p:where(:not([class*="kodza-"]):not(.kodza-quote-link [class*="kodza-"] *)):not(#_):where([hidden]) {
display: none;
}
/* The component's own rules, one step stronger: real buttons and fields, what it sets on tags themes style (links, lists, headings, images…), and the root width (a theme may narrow it, never widen it) */
.kodza-quote-link > h2:not(#_) {
color: var(--kz-quote-link-heading);
font-family: "Geist", system-ui, sans-serif;
font-weight: 600;
text-align: start;
}
.kodza-quote-link > h2:not(#_) {
margin: 56px 0 14px;
font-size: clamp(24px, 4vw, 32px);
line-height: 1.2;
letter-spacing: -0.035em;
}
.kodza-quote-link > :is(h2, h3):first-child:where(h2, p):not(#_) {
margin-top: 0;
}
.kodza-quote-link > p:not(#_) {
margin: 0 0 1.1em;
color: var(--kz-quote-link-text);
font-family: "Geist", system-ui, sans-serif;
font-size: 17px;
line-height: 1.7;
}
.kodza-quote-link > p:last-child:not(#_) {
margin-bottom: 0;
}
.kodza-quote-link__pill:not(#_) {
display: inline-flex;
align-items: center;
gap: 8px;
box-sizing: border-box;
height: 36px;
margin: 0;
padding: 0 14px 0 12px;
border: 0;
border-radius: 999px;
background: var(--kz-quote-link-pill);
box-shadow: var(--kz-quote-link-shadow);
color: var(--kz-quote-link-pill-ink);
font: 500 14px/20px "Geist", system-ui, sans-serif;
letter-spacing: -0.01em;
text-transform: none;
white-space: nowrap;
cursor: pointer;
user-select: none;
-webkit-user-select: none;
-webkit-tap-highlight-color: transparent;
opacity: 0;
scale: 0.96;
translate: 0 6px;
transform-origin: 50% 100%;
transition: opacity 0.16s ease, scale 0.16s ease, translate 0.16s ease, background-color 0.15s ease;
}
.kodza-quote-link__float.is-below .kodza-quote-link__pill:not(#_) {
translate: 0 -6px;
transform-origin: 50% 0;
}
.kodza-quote-link__float.is-shown .kodza-quote-link__pill:not(#_) {
opacity: 1;
scale: 1;
translate: 0 0;
transition: opacity var(--kz-quote-link-duration) var(--kz-quote-link-ease), scale var(--kz-quote-link-duration) var(--kz-quote-link-ease), translate var(--kz-quote-link-duration) var(--kz-quote-link-ease), background-color 0.15s ease;
}
.kodza-quote-link__pill:hover:not(#_) {
background: var(--kz-quote-link-pill-hover);
}
.kodza-quote-link__pill:focus-visible:not(#_) {
outline: 2px solid var(--kz-quote-link-pill);
outline-offset: 3px;
}
.kodza-quote-link__icon svg:not(#_) {
display: block;
transition: translate var(--kz-quote-link-duration) var(--kz-quote-link-ease);
}
.kodza-quote-link__pill.is-copied:not(.is-failed) .kodza-quote-link__check path:not(#_) {
transition: stroke-dashoffset 0.3s var(--kz-quote-link-ease) 0.08s;
}
.kodza-quote-link__pill.is-copied .kodza-quote-link__done:not(#_) {
transition-delay: 0.06s;
}
.kodza-quote-link :not(#_)::target-text,
:has(> .kodza-quote-link) :not(#_)::target-text {
background-color: var(--kz-quote-link-mark, rgba(10, 10, 10, 0.14));
color: inherit;
}
@media (prefers-reduced-motion: reduce) {
.kodza-quote-link__float *:not(#_) {
transition-duration: 0.01ms !important;
transition-delay: 0s !important;
}
}// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Quote Link
// Words selected in the article bring up a pill that copies a link to them: the page's address with
// a text fragment (#:~:text=…), which opens the page scrolled to the quote and highlighted. The
// quote is widened to whole words, long ones are written by their first and last words, and a
// start that the page repeats gets the words before it. The heading above gives the link a
// fallback for a browser that ignores the fragment.
// An empty root works on the article around or beside it (data-target), like a Custom HTML block
// in WordPress.
(() => {
const SELECTOR = '[data-kodza-quote-link]';
const RESET_AFTER = 1500;
const GAP = 10;
const GAP_TOUCH = 28; // clear of the selection handles
const EASE = 'cubic-bezier(0.22, 1, 0.36, 1)';
const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
const LETTER = /[\p{L}\p{N}]/u;
const FIELD = 'input, textarea, select, [contenteditable]:not([contenteditable="false"])';
// The pill, written once
const MARK = document.createElement('template');
MARK.innerHTML = '<span class="kodza-quote-link__float"><button class="kodza-quote-link__pill" type="button"><span class="kodza-quote-link__icon" aria-hidden="true"><svg class="kodza-quote-link__chain" viewBox="0 0 16 16" focusable="false"><path d="M6.75 9.25a2.75 2.75 0 0 0 3.9 0l2-2a2.75 2.75 0 0 0-3.9-3.9l-.6.6" /><path d="M9.25 6.75a2.75 2.75 0 0 0-3.9 0l-2 2a2.75 2.75 0 0 0 3.9 3.9l.6-.6" /></svg><svg class="kodza-quote-link__check" viewBox="0 0 16 16" focusable="false"><path d="M3 8.5l3.2 3L13 4.5" pathLength="1" /></svg></span><span class="kodza-quote-link__label"><span class="kodza-quote-link__word"></span><span class="kodza-quote-link__done" aria-hidden="true"></span></span></button></span>';
async function writeText(text) {
try {
await navigator.clipboard.writeText(text);
return true;
} catch {
const area = document.createElement('textarea');
area.value = text;
area.setAttribute('readonly', '');
area.style.cssText = 'position:fixed;top:0;left:0;opacity:0;pointer-events:none';
document.body.append(area);
area.select();
let ok = false;
try {
ok = document.execCommand('copy');
} catch {}
area.remove();
return ok;
}
}
// The bottom of what stays at the top of the window (a fixed or sticky header): the pill does not
// go under it
function headerBottom() {
const width = document.documentElement.clientWidth;
let bottom = 0;
[width / 2, 24, width - 24].forEach((x) => {
for (let el = document.elementFromPoint(x, 1); el && el !== document.body && el !== document.documentElement; el = el.parentElement) {
const { position } = getComputedStyle(el);
if (position !== 'fixed' && position !== 'sticky') continue;
const rect = el.getBoundingClientRect();
if (rect.top <= 1 && rect.height < window.innerHeight / 2) bottom = Math.max(bottom, rect.bottom);
break;
}
});
return bottom;
}
const blockOf = (el) => {
for (; el; el = el.parentElement) {
const { display } = getComputedStyle(el);
if (!display.startsWith('inline') && display !== 'contents') return el;
}
return document.body;
};
// The text of a range as the page shows it, one string per block: hidden text, marks drawn for
// the eye (a heading's #) and the pill left out
const blocksOf = (range) => {
const out = [];
let block = null;
let text = '';
const top = range.commonAncestorContainer;
const walker = document.createTreeWalker(top.nodeType === Node.TEXT_NODE ? top.parentNode : top, NodeFilter.SHOW_TEXT);
for (let node = walker.nextNode(); node; node = walker.nextNode()) {
if (!range.intersectsNode(node)) continue;
const el = node.parentElement;
if (!el.getClientRects().length || el.closest('[aria-hidden="true"], .kodza-quote-link__float')) continue;
const from = node === range.startContainer ? range.startOffset : 0;
const to = node === range.endContainer ? range.endOffset : node.length;
const at = blockOf(el);
if (at !== block) {
out.push({ block: at, text: '' });
block = at;
}
text = node.data.slice(from, to);
out[out.length - 1].text += text;
}
return out.map((part) => ({ ...part, words: part.text.split(/\s+/).filter(Boolean) })).filter((part) => part.words.length);
};
// The selection widened to whole words: a fragment only matches on word boundaries
const whole = (range) => {
const r = range.cloneRange();
const { startContainer: start, endContainer: end } = r;
if (start.nodeType === Node.TEXT_NODE) {
let i = r.startOffset;
while (i > 0 && LETTER.test(start.data[i - 1])) i -= 1;
r.setStart(start, i);
}
if (end.nodeType === Node.TEXT_NODE) {
let i = r.endOffset;
while (i < end.data.length && LETTER.test(end.data[i])) i += 1;
r.setEnd(end, i);
}
return r;
};
const encode = (text) => encodeURIComponent(text).replace(/-/g, '%2D');
const flat = (text) => text.replace(/\s+/g, ' ').trim().toLowerCase();
// The link: the whole quote when it is short and in one block, its first and last words
// otherwise, with the words before it (or after it) when the page says its start more than once
const linkTo = (selected, scope) => {
const range = whole(selected);
const parts = blocksOf(range);
if (!parts.length) return location.href;
const first = parts[0];
const last = parts[parts.length - 1];
let start = first.words.join(' ');
let end = '';
if (parts.length > 1 || first.words.length > 10) {
start = first.words.slice(0, 4).join(' ');
end = last.words.slice(-4).join(' ');
}
const page = flat(document.body.innerText);
const twice = (term) => page.indexOf(flat(term)) !== page.lastIndexOf(flat(term));
let prefix = '';
let suffix = '';
if (twice(start)) {
const before = document.createRange();
before.setStart(first.block, 0);
before.setEnd(range.startContainer, range.startOffset);
prefix = blocksOf(before).pop()?.words.slice(-3).join(' ') || '';
if (!prefix) {
const after = document.createRange();
after.setStart(range.endContainer, range.endOffset);
after.setEnd(last.block, last.block.childNodes.length);
suffix = blocksOf(after)[0]?.words.slice(0, 3).join(' ') || '';
}
}
const terms = [prefix && `${encode(prefix)}-`, encode(start), end && encode(end), suffix && `-${encode(suffix)}`].filter(Boolean);
// A browser without fragments still lands on the section: the heading above the quote
const headings = [...scope.querySelectorAll('h1[id], h2[id], h3[id], h4[id], h5[id], h6[id]')]
.filter((heading) => heading.compareDocumentPosition(range.startContainer) & Node.DOCUMENT_POSITION_FOLLOWING || heading.contains(range.startContainer));
const id = headings.pop()?.id;
const hash = id ? `#${encodeURIComponent(id)}` : location.hash.split(':~:')[0] || '#';
return `${location.href.split('#')[0]}${hash}:~:text=${terms.join(',')}`;
};
// One instance, with its own state: two copies on a page never interfere. Everything it
// starts is tied to `signal` (listeners get { signal }, observers and timers stop on its
// 'abort' event), so kodza:destroy stops it all.
function mount(root, signal) {
let scope = root;
if (!root.textContent.trim()) {
const selector = root.dataset.target || 'article, main, .entry-content';
scope = root.parentElement?.closest(selector);
for (let up = root.parentElement; !scope && up; up = up.parentElement) scope = up.querySelector(selector);
if (!scope) return;
}
const label = root.dataset.label || 'Copy link to quote';
const copied = root.dataset.copied || 'Link copied';
const failed = root.dataset.failed || "Couldn't copy";
const float = MARK.content.firstElementChild.cloneNode(true);
const pill = float.querySelector('.kodza-quote-link__pill');
const text = float.querySelector('.kodza-quote-link__label');
const done = float.querySelector('.kodza-quote-link__done');
float.querySelector('.kodza-quote-link__word').textContent = label;
done.textContent = copied;
const status = document.createElement('span');
status.className = 'kodza-quote-link__status';
status.setAttribute('role', 'status');
root.append(float, status);
let saved = null; // the selection the pill stands for
let shown = false;
let pressing = false; // a mouse button held down: the selection is being made
let holding = false; // the pill pressed: the selection may blink out before the click
let copying = false;
let touch = false;
const timers = {};
const later = (name, call, ms) => {
clearTimeout(timers[name]);
timers[name] = setTimeout(call, ms);
};
// The selection, if it is words in this article and not in a field
const current = () => {
const selection = getSelection();
if (!selection?.rangeCount || selection.isCollapsed) return null;
const range = selection.getRangeAt(0);
const node = range.commonAncestorContainer;
const el = node.nodeType === Node.ELEMENT_NODE ? node : node.parentElement;
if (!scope.contains(node) || float.contains(node) || el?.closest(FIELD)) return null;
const words = selection.toString().trim();
return words.length >= 3 && LETTER.test(words) ? range : null;
};
const same = (a, b) => a.compareBoundaryPoints(Range.START_TO_START, b) === 0 && a.compareBoundaryPoints(Range.END_TO_END, b) === 0;
// Back to "Copy link to quote", without rolling: the pill is out of sight
const reset = () => {
pill.classList.remove('is-copied', 'is-failed');
text.getAnimations().forEach((animation) => animation.cancel());
status.textContent = '';
};
// Over the middle of the first line, or under the last; kept on screen
const place = () => {
const rects = [...saved.getClientRects()].filter((rect) => rect.width > 1 && rect.height > 0);
if (!rects.length) return false;
const line = (at) => {
const own = rects.filter((rect) => rect.bottom > at.top + 2 && rect.top < at.bottom - 2);
return { left: Math.min(...own.map((r) => r.left)), right: Math.max(...own.map((r) => r.right)), top: Math.min(...own.map((r) => r.top)), bottom: Math.max(...own.map((r) => r.bottom)) };
};
const top = line(rects[0]);
const bottom = line(rects[rects.length - 1]);
const box = root.getBoundingClientRect();
const scale = box.width / root.offsetWidth || 1;
const width = pill.offsetWidth * scale;
const height = pill.offsetHeight * scale;
const gap = (touch ? GAP_TOUCH : GAP) * scale;
const above = top.top - GAP * scale - height >= headerBottom() + 8;
const below = bottom.bottom + gap + height <= window.innerHeight - 8;
const under = touch ? below || !above : !above;
const at = under ? bottom : top;
const page = document.documentElement.clientWidth;
const x = Math.min(Math.max((at.left + at.right) / 2, 8 + width / 2), page - 8 - width / 2);
const y = under ? at.bottom + gap : at.top - GAP * scale;
float.classList.toggle('is-below', under);
float.style.translate = `${(x - box.left) / scale - root.clientLeft}px ${(y - box.top) / scale - root.clientTop}px`;
return true;
};
// The label rolls, its width following from one word to the other: to "Link copied" (or
// "Couldn't copy"), and back to "Copy link to quote" when other words are chosen
const roll = (word) => {
const from = text.offsetWidth;
if (word) done.textContent = word;
pill.classList.toggle('is-failed', word === failed);
pill.classList.toggle('is-copied', Boolean(word));
status.textContent = '';
const to = text.offsetWidth;
if (!reduceMotion && from !== to) text.animate([{ width: `${from}px` }, { width: `${to}px` }], { duration: 380, easing: EASE });
};
const show = (range) => {
clearTimeout(timers.leave);
saved = range.cloneRange();
if (!shown) {
clearTimeout(timers.reset);
reset();
} else if (pill.classList.contains('is-copied')) {
roll(null);
}
if (!place()) return;
if (shown) return;
void float.offsetWidth; // placed before it appears: it comes up where it stands, not from the last place
float.classList.add('is-shown');
shown = true;
};
const hide = () => {
clearTimeout(timers.show);
clearTimeout(timers.leave);
if (!shown) return;
shown = false;
if (float.contains(document.activeElement)) pill.blur();
float.classList.remove('is-shown');
later('reset', reset, 200);
};
const check = () => {
if (copying) return;
const range = current();
if (!range) hide();
else if (!shown || !saved || !same(range, saved)) show(range);
};
const copy = async () => {
if (!saved || copying) return;
copying = true;
const range = saved;
const focused = document.activeElement === pill;
const ok = await writeText(linkTo(range, scope));
// The copy's fallback borrowed the selection and the focus: both come back
const selection = getSelection();
if (selection && (!selection.rangeCount || !same(selection.getRangeAt(0), range))) {
selection.removeAllRanges();
selection.addRange(range);
}
if (focused) pill.focus({ preventScroll: true });
copying = false;
if (signal.aborted || !shown) return;
roll(ok ? copied : failed);
status.textContent = ok ? copied : `${failed}. Copy the address from the bar.`;
later('leave', hide, RESET_AFTER);
};
// The mouse: the pill goes as the button goes down and comes up with it, once the words are chosen
document.addEventListener('pointerdown', (event) => {
touch = event.pointerType === 'touch' || event.pointerType === 'pen';
if (float.contains(event.target) || event.pointerType !== 'mouse' || event.button) return;
pressing = true;
hide();
}, { signal, capture: true });
document.addEventListener('pointerup', (event) => {
if (!pressing || event.pointerType !== 'mouse') return;
pressing = false;
later('show', check, 0);
}, { signal, capture: true });
// A finger or the keyboard: once the selection holds still
document.addEventListener('selectionchange', () => {
if (pressing || holding || copying) return;
if (!current()) hide();
else later('show', check, 280);
}, { signal });
// Pressing the pill keeps the selection and gives no focus ring to a click
pill.addEventListener('mousedown', (event) => event.preventDefault(), { signal });
pill.addEventListener('pointerdown', () => {
holding = true;
later('hold', () => { holding = false; }, 600);
}, { signal });
pill.addEventListener('click', () => {
holding = false;
copy();
}, { signal });
// Tab goes to the pill while it is up; Escape puts it away, the selection stays
document.addEventListener('keydown', (event) => {
if (!shown) return;
if (event.key === 'Escape') {
hide();
} else if (event.key === 'Tab' && !event.shiftKey && !event.altKey && !event.ctrlKey && !event.metaKey
&& document.activeElement !== pill && !document.activeElement?.closest(FIELD)) {
event.preventDefault();
pill.focus({ preventScroll: true });
}
}, { signal });
// Tabbing past it says no
pill.addEventListener('focusout', (event) => {
if (copying || !document.hasFocus() || float.contains(event.relatedTarget)) return;
hide();
}, { signal });
const replace = () => {
if (shown && saved) place();
};
window.addEventListener('resize', replace, { signal });
document.fonts?.ready.then(() => {
if (!signal.aborted) replace();
});
signal.addEventListener('abort', () => {
Object.values(timers).forEach(clearTimeout);
float.remove();
status.remove();
});
}
// Kodza lifecycle, the same in every component: `kodza:init` starts the instances inside
// event.detail.root (the whole page by default), `kodza:destroy` stops them and puts their
// markup back. For themes and apps that swap content without a page load. Each running root
// keeps its markup as written under KODZA, shared by every Kodza script on the page: a Kodza
// component inside another one is saved as written, not half-started, and stopped with it.
const KODZA = Symbol.for('kodza');
const instances = new WeakMap();
const find = (scope = document) => [scope, ...scope.querySelectorAll(SELECTOR)].filter((el) => el.matches?.(SELECTOR));
const attrsOf = (el) => [...el.attributes].map((a) => [a.name, a.value]);
const put = (el, saved) => {
[...el.attributes].forEach((a) => el.removeAttribute(a.name));
saved.attrs.forEach(([name, value]) => el.setAttribute(name, value));
el.innerHTML = saved.html;
};
// The markup inside a root as written: Kodza components already running in it give back their own
const written = (root) => {
const all = [...root.querySelectorAll('*')];
if (!all.some((el) => el[KODZA])) return root.innerHTML;
const copy = root.cloneNode(true);
const twins = copy.querySelectorAll('*');
let last = null;
all.forEach((el, i) => {
if (!el[KODZA] || last?.contains(el)) return;
last = el;
put(twins[i], el[KODZA]);
});
return copy.innerHTML;
};
const init = (scope) => find(scope).forEach((root) => {
if (root.classList.contains('is-ready')) return; // already running, maybe from another copy of this script
const controller = new AbortController();
const saved = { html: written(root), attrs: attrsOf(root), stop: () => destroy(root) };
instances.set(root, { controller, saved });
root[KODZA] = saved;
mount(root, controller.signal);
root.classList.add('is-ready');
});
const destroy = (scope) => find(scope).forEach((root) => {
const instance = instances.get(root);
if (!instance) return;
instances.delete(root);
// The Kodza components running inside it stop first: once its markup is put back, their own
// script could not find them any more
root.querySelectorAll('*').forEach((el) => el[KODZA]?.stop());
instance.controller.abort();
delete root[KODZA];
put(root, instance.saved);
});
document.addEventListener('kodza:init', (event) => init(event.detail?.root));
document.addEventListener('kodza:destroy', (event) => destroy(event.detail?.root));
init();
// Loaded in <head>, the script runs before the markup exists: once more when it is parsed
if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => init(), { once: true });
})();'use client';
// Kodza — Quote Link, for React. From https://kodza.dev/components/quote-link/
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Next to this file: quote-link.css and quote-link.js, the component's CSS and JS from Kodza, as they are.
// Yours to edit: the markup is plain JSX below.
// The script changes this markup once React has rendered it (it adds layers, splits text, moves
// nodes), so React must not patch it afterwards. When a prop changes, the key gives React a fresh
// element: kodza:destroy stops the script on the old one, kodza:init starts it on the new one.
// Built from your data (tabs, rows, options)? Put what the markup is made of in the key, as plain
// values (ids, text, numbers): a change starts the script again on fresh markup. What the visitor
// changes (the open tab, the sort, what they type) is the script's: keep it out of the key, follow
// it with onClick or onInput on the root, and change it from your code as a visitor would (click
// the tab; set the field's value, then dispatch a bubbling input event).
import { useRef, useEffect, type ComponentPropsWithoutRef, type ComponentRef, type CSSProperties } from 'react';
import './quote-link.css';
export type QuoteLinkProps = Omit<ComponentPropsWithoutRef<'div'>, "children" | "vars"> & {
/** Settings, as CSS variables on the root */
vars?: {
/** default: #0a0a0a */
"--kz-quote-link-heading"?: string | number;
/** default: rgba(10, 10, 10, 0.72) */
"--kz-quote-link-text"?: string | number;
/** default: #0a0a0a */
"--kz-quote-link-pill"?: string | number;
/** default: #fff */
"--kz-quote-link-pill-ink"?: string | number;
/** default: #262626 */
"--kz-quote-link-pill-hover"?: string | number;
/** default: 0 1px 2px rgba(10, 10, 10, 0.12), 0 10px 28px rgba(10, 10, 10, 0.18) */
"--kz-quote-link-shadow"?: string | number;
/** default: rgba(10, 10, 10, 0.14) */
"--kz-quote-link-mark"?: string | number;
/** default: 0.22s */
"--kz-quote-link-duration"?: string | number;
/** default: cubic-bezier(0.22, 1, 0.36, 1) */
"--kz-quote-link-ease"?: string | number;
};
className?: string;
};
export function QuoteLink({ vars, className, style, ...rest }: QuoteLinkProps) {
const ref = useRef<ComponentRef<'div'>>(null);
const classes = ["kodza-quote-link", className].filter(Boolean).join(' ');
// Everything the markup is made of: when it changes, React gets a fresh element (see the top)
const key = JSON.stringify([classes, vars, style, rest]);
// Starts the script on this element once React has rendered it, stops it when it goes
useEffect(() => {
const root = ref.current;
let live = true;
// @ts-ignore: a plain script, no types to find
import('./quote-link.js').then(() => {
if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
});
return () => {
live = false;
document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
};
}, [key]);
return (
<div data-kodza-quote-link="" key={key} {...rest} className={classes} style={{ ...vars, ...style } as CSSProperties} ref={ref}>
<h2>What happened</h2>
<p>At 5:58 pm on a Friday, a config change took the checkout down for eleven minutes. The rollback took two. Finding the person who knew the rollback took nine.</p>
<p>Nothing was lost. Orders placed during those minutes were retried by the queue and went through once the checkout came back.</p>
<h2>What we changed</h2>
<p>Config changes now go through the same review as code. The rollback is a button in the dashboard, and its runbook fits on one screen.</p>
</div>
);
}Checked
Checked before you paste.
Robots poked at it before you did. Every component goes through the same checks, and again each time it changes.
What ranLast run
Accessibilityaxe-core 4.10.2: the WCAG 2.1 A and AA rules, plus best practices.
0 issues
KeyboardThe Tab key gets there, and the focus ring shows when it does.
Passed
Reduced motionTurn on reduced motion and what moved just appears. Nothing loops.
Passed
Light and darkThe same checks on both themes, contrast included.
Passed
WordPressPasted into Twenty Twenty-Five, Twenty Twenty-One, Astra, Blocksy, GeneratePress, Hello Elementor, Kadence and OceanWP. Nothing to flag.
8 / 8 themes
Robots checked this. A human with VoiceOver hasn't yet.
KeyboardPress them in the preview
On the pill
- Copies a link that opens the page on the quoteEnter/Space
- Puts the pill awayEsc
In the text, with words selected
- Moves to the pillTab
- Puts the pill away, the selection staysEsc
Heading Anchor
A # beside every heading. It slides out of the margin when the heading is pointed at, or waits after the last word on a touch screen. Click it, or the heading, to put the section in the bar and copy the link.
View code
Footnote Link
Footnotes that stay on their line. Wide, the note sits in the margin level with its line and inks with its number; narrow, it folds out under the line. Picks up WordPress footnotes as they are.
View code
Arrow Link
A link that points the way: at rest a chevron, on hover the shaft draws itself in and the head moves on, › becomes →. A back variant points the other way. Pure CSS.
View code
External Link
A link that leaves the site says so: a line of ink runs under the words to the ↗, which then springs out towards the corner, its shaft stretching after it. Pure CSS.
View code
Link Preview
Point at a link and a card of where it goes unfolds above it. One card per paragraph: it glides from link to link, its picture cross-fading and its words rolling.
View code