Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / CSS

::highlight() — štýlovanie vlastných zvýraznení textu

Pseudoelement ::highlight() štýluje textové rozsahy registrované pomocou CSS Custom Highlight API bez pridávania obalových elementov. CSS určuje vzhľad a JavaScript vytvára rozsahy a registruje zvýraznenie pod názvom.

Verzia: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

::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ázdnym argumentom. Predstavuje časti textu pokryté vlastným zvýraznením. Na rozdiel od ::selection nevyžaduje, aby používateľ vybral text. Rozsahy môžu presahovať hranice elementov bez zmeny štruktúry DOM.

Zápisy ::highlight(<custom-highlight-name>) a ::highlight(<custom-ident>) opisujú výber zvýraznenia podľa názvu; ostré zátvorky označujú zástupné symboly, nie doslovný kód. V ::highlight(demo) zodpovedá argument demo kľúču v CSS.highlights.set('demo', ...). Samotné CSS rozsah nevytvorí: JavaScript odovzdá Range objektu Highlight a zaregistruje objekt v CSS.highlights.

Editor’s Draft rozširuje syntax na ::highlight(<highlight-name-selector>), ktorý prijíma <custom-ident> alebo *. ::highlight(*) vyberá všetky vlastné zvýraznenia, nie však vstavané zvýraznenia, ako je ::selection. Pomenovaná forma má špecificitu (0,0,1), zatiaľ čo forma s * má špecificitu (0,0,0). Toto rozšírenie návrhu treba samostatne overiť v cieľovom prehliadači.

Použijú sa iba vlastnosti povolené pre zvýraznenia vrátane color a background-color; margin, display ani font-size nemôžu zmeniť ich rozloženie. Príklad pokrýva rozsah od indexu 6 po výhradný index 10, teda Beta. Kontrola dostupnosti API a syntaxe selektora nedokazuje správne vykreslenie; treba skontrolovať aj vzhľad.

Prí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ýsledok

Beta

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje