Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / CSS

::highlight() — oblikovanje lastnih označitev besedila

Psevdoelement ::highlight() oblikuje obsege besedila, registrirane prek CSS Custom Highlight API, ne da bi dodajal ovojne elemente. CSS določa videz, JavaScript pa ustvari obsege in registrira označitev pod imenom.

Različica: 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() je ime funkcionalnega psevdoelementa; ni veljaven izbirnik s praznim argumentom. Predstavlja dele besedila, ki jih pokriva lastna označitev. Za razliko od ::selection ne zahteva, da uporabnik izbere besedilo. Obsegi lahko prečkajo meje elementov, ne da bi spremenili strukturo DOM.

Zapis ::highlight(<custom-highlight-name>) in ::highlight(<custom-ident>) opisuje izbiro označitve po imenu; kotni oklepaji označujejo nadomestna mesta, ne dobesedne kode. V ::highlight(demo) argument demo ustreza ključu v CSS.highlights.set('demo', ...). CSS sam ne ustvari obsega: JavaScript posreduje Range objektu Highlight in objekt registrira v CSS.highlights.

Editor’s Draft razširja sintakso v ::highlight(<highlight-name-selector>), ki sprejema <custom-ident> ali *. ::highlight(*) izbere vse lastne označitve, ne pa vgrajenih označitev, kot je ::selection. Poimenovana oblika ima specifičnost (0,0,1), oblika z * pa (0,0,0). To razširitev osnutka je treba ločeno preveriti v ciljnem brskalniku.

Uporabijo se samo lastnosti, dovoljene za označitve, med njimi color in background-color; margin, display in font-size ne morejo spremeniti njihove postavitve. Primer zajema obseg od indeksa 6 do izključnega indeksa 10, torej Beta. Preverjanje razpoložljivosti API-ja in sintakse izbirnika ne dokazuje pravilnega izrisovanja; preveriti je treba tudi videz.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri