CKTIS / CSS
::highlight() — stylování vlastních zvýraznění textu
Pseudoelement ::highlight() styluje textové rozsahy registrované prostřednictvím CSS Custom Highlight API, aniž by přidával obalové elementy. CSS určuje vzhled, zatímco JavaScript vytváří rozsahy a registruje zvýraznění pod názvem.
Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
::highlight(<custom-ident>)
/* Editor’s Draft: */
::highlight(<highlight-name-selector>)
/* <highlight-name-selector> = '*' | <custom-ident> */::highlight() označuje funkční pseudoelement; nejde o platný selektor s prázdným argumentem. Představuje části textu pokryté vlastním zvýrazněním. Na rozdíl od ::selection nevyžaduje, aby uživatel text vybral. Rozsahy mohou překračovat hranice elementů, aniž by měnily strukturu DOM.
Zápisy ::highlight(<custom-highlight-name>) a ::highlight(<custom-ident>) popisují výběr zvýraznění podle názvu; špičaté závorky označují zástupné symboly, nikoli doslovný kód. V ::highlight(demo) odpovídá argument demo klíči v CSS.highlights.set('demo', ...). Samotné CSS rozsah nevytváří: JavaScript předá Range objektu Highlight a zaregistruje tento objekt v CSS.highlights.
Editor’s Draft rozšiřuje syntaxi na ::highlight(<highlight-name-selector>), který přijímá <custom-ident> nebo *. ::highlight(*) vybírá všechna vlastní zvýraznění, nikoli však vestavěná zvýraznění, jako je ::selection. Pojmenovaná forma má specificitu (0,0,1), zatímco forma s * má specificitu (0,0,0). Toto rozšíření návrhu je třeba ověřit zvlášť v cílovém prohlížeči.
Použijí se jen vlastnosti povolené pro zvýraznění, například color a background-color; margin, display ani font-size nemohou změnit jejich rozložení. Příklad pokrývá rozsah od indexu 6 po výhradní index 10, tedy Beta. Ověření dostupnosti API a syntaxe selektoru nedokazuje správné vykreslení; je třeba zkontrolovat také vzhled.
Příklady
<!doctype html>
<meta charset="utf-8">
<title>Custom highlight</title>
<style>
::highlight(demo) {
color: #000000;
background-color: #ffff00;
}
</style>
<p id="text">Alpha Beta Gamma</p>
<pre id="status"></pre>
<script>
const status = document.getElementById('status');
if (!('Highlight' in window) || !CSS.highlights ||
!CSS.supports('selector(::highlight(demo))')) {
status.textContent = 'Unsupported';
} else {
const text = document.getElementById('text').firstChild;
const range = new Range();
range.setStart(text, 6);
range.setEnd(text, 10);
CSS.highlights.set('demo', new Highlight(range));
status.textContent = range.toString();
}
</script>Výsledek
Beta
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.