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.