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.