Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / CSS

::highlight() — oblikovanje vlastitih isticanja teksta

Pseudo-element ::highlight() oblikuje raspone teksta registrirane putem CSS Custom Highlight API-ja, bez dodavanja omotačkih elemenata. CSS određuje izgled, a JavaScript stvara raspone i registrira isticanje pod nazivom.

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

Sintaksa

::highlight(<custom-ident>)
/* Editor’s Draft: */
::highlight(<highlight-name-selector>)
/* <highlight-name-selector> = '*' | <custom-ident> */

::highlight() naziv je funkcionalnog pseudo-elementa; nije valjan selektor s praznim argumentom. Predstavlja dijelove teksta obuhvaćene vlastitim isticanjem. Za razliku od ::selection, ne zahtijeva da korisnik odabere tekst. Rasponi mogu prelaziti granice elemenata bez promjene strukture DOM-a.

Zapisi ::highlight(<custom-highlight-name>) i ::highlight(<custom-ident>) opisuju odabir isticanja prema nazivu; uglate zagrade označavaju zamjenske vrijednosti, a ne doslovni kod. U ::highlight(demo) argument demo odgovara ključu u CSS.highlights.set('demo', ...). Sam CSS ne stvara raspon: JavaScript prosljeđuje Range objektu Highlight i registrira objekt u CSS.highlights.

Editor’s Draft proširuje sintaksu na ::highlight(<highlight-name-selector>), koji prihvaća <custom-ident> ili *. ::highlight(*) odabire sva vlastita isticanja, ali ne i ugrađena isticanja poput ::selection. Oblik s nazivom ima specifičnost (0,0,1), dok oblik s * ima specifičnost (0,0,0). Ovo proširenje nacrta treba zasebno provjeriti u ciljnom pregledniku.

Primjenjuju se samo svojstva dopuštena za isticanja, uključujući color i background-color; margin, display i font-size ne mogu promijeniti njihov raspored. Primjer obuhvaća raspon od indeksa 6 do isključivog indeksa 10, odnosno Beta. Provjera dostupnosti API-ja i sintakse selektora ne dokazuje ispravno prikazivanje; treba provjeriti i izgled.

Primjeri

<!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>

Rezultat

Beta

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori