Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

::highlight() — applicare stili alle evidenziazioni di testo personalizzate

Lo pseudo-elemento ::highlight() applica stili agli intervalli di testo registrati tramite la CSS Custom Highlight API, senza aggiungere elementi contenitore. CSS definisce l’aspetto, mentre JavaScript crea gli intervalli e registra l’evidenziazione con un nome.

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

Sintassi

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

::highlight() è il nome di uno pseudo-elemento funzionale; non è un selettore valido con un argomento vuoto. Rappresenta porzioni di testo coperte da un’evidenziazione personalizzata. A differenza di ::selection, non richiede che l’utente selezioni il testo. Gli intervalli possono attraversare i confini degli elementi senza modificare la struttura DOM.

Le notazioni ::highlight(<custom-highlight-name>) e ::highlight(<custom-ident>) descrivono la selezione di un’evidenziazione in base al nome; le parentesi angolari indicano segnaposto, non codice letterale. In ::highlight(demo), l’argomento demo corrisponde alla chiave in CSS.highlights.set('demo', ...). CSS da solo non crea un intervallo: JavaScript passa un Range a Highlight e registra l’oggetto in CSS.highlights.

L’Editor’s Draft estende la sintassi a ::highlight(<highlight-name-selector>), accettando <custom-ident> oppure *. ::highlight(*) seleziona tutte le evidenziazioni personalizzate, ma non quelle integrate come ::selection. La forma con nome ha specificità (0,0,1), mentre la forma con * ha specificità (0,0,0). Questa estensione della bozza richiede una verifica separata nel browser di destinazione.

Si applicano solo le proprietà consentite per le evidenziazioni, tra cui color e background-color; margin, display e font-size non possono modificarne la disposizione. L’esempio copre l’intervallo dall’indice 6 all’indice esclusivo 10, cioè Beta. Verificare la disponibilità dell’API e la sintassi del selettore non dimostra che il rendering sia corretto; occorre controllare anche l’aspetto.

Esempi

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

Risultato

Beta

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti