Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

::highlight() — stylowanie własnych wyróżnień tekstu

Pseudo-element ::highlight() styluje zakresy tekstu zarejestrowane przez CSS Custom Highlight API, bez dodawania elementów opakowujących. CSS określa wygląd, a JavaScript tworzy zakresy i rejestruje wyróżnienie pod nazwą.

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

Składnia

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

::highlight() to nazwa funkcyjnego pseudo-elementu, nie poprawny selektor z pustym argumentem. Reprezentuje fragmenty tekstu objęte własnym wyróżnieniem. W przeciwieństwie do ::selection nie wymaga zaznaczenia tekstu przez użytkownika. Zakresy mogą przekraczać granice elementów bez zmieniania struktury DOM.

Zapisy ::highlight(<custom-highlight-name>) i ::highlight(<custom-ident>) opisują wybór wyróżnienia według nazwy; nawiasy ostrokątne oznaczają miejsca na wartości, a nie dosłowny kod. W ::highlight(demo) argument demo odpowiada kluczowi w CSS.highlights.set('demo', ...). Sam CSS nie tworzy zakresu: JavaScript przekazuje Range do Highlight i rejestruje obiekt w CSS.highlights.

Szkic redakcyjny rozszerza składnię do ::highlight(<highlight-name-selector>), gdzie argumentem jest <custom-ident> albo *. ::highlight(*) wybiera wszystkie własne wyróżnienia, ale nie wbudowane wyróżnienia takie jak ::selection. Nazwany wariant wnosi specyficzność (0,0,1), a wariant z * — (0,0,0). To rozszerzenie szkicu wymaga osobnej weryfikacji w docelowej przeglądarce.

Działają tylko właściwości dozwolone dla wyróżnień, między innymi color i background-color; margin, display ani font-size nie zmienią ich układu. Przykład obejmuje zakres od indeksu 6 do wyłącznego indeksu 10, czyli Beta. Sprawdzenie dostępności API i składni nie dowodzi poprawnego renderowania; trzeba również sprawdzić wygląd.

Przykłady

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

Wynik

Beta

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła