Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

::highlight() — estilizar realces de texto personalizados

O pseudo-elemento ::highlight() estiliza intervalos de texto registados através da CSS Custom Highlight API, sem acrescentar elementos envolventes. CSS define o aspeto, enquanto JavaScript cria os intervalos e regista o realce com um nome.

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

Sintaxe

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

::highlight() designa um pseudo-elemento funcional; não é um seletor válido com um argumento vazio. Representa partes do texto abrangidas por um realce personalizado. Ao contrário de ::selection, não exige que o utilizador selecione o texto. Os intervalos podem atravessar limites entre elementos sem alterar a estrutura DOM.

As notações ::highlight(<custom-highlight-name>) e ::highlight(<custom-ident>) descrevem a seleção de um realce pelo nome; os parênteses angulares indicam marcadores de posição, não código literal. Em ::highlight(demo), o argumento demo corresponde à chave em CSS.highlights.set('demo', ...). CSS, por si só, não cria um intervalo: JavaScript passa um Range a Highlight e regista o objeto em CSS.highlights.

O Editor’s Draft alarga a sintaxe para ::highlight(<highlight-name-selector>), aceitando <custom-ident> ou *. ::highlight(*) seleciona todos os realces personalizados, mas não os realces integrados, como ::selection. A forma com nome tem especificidade (0,0,1), enquanto a forma com * tem especificidade (0,0,0). Esta extensão da versão de trabalho requer verificação separada no navegador de destino.

Só se aplicam as propriedades permitidas para realces, incluindo color e background-color; margin, display e font-size não podem alterar a disposição. O exemplo abrange o intervalo desde o índice 6 até ao índice exclusivo 10, ou seja, Beta. Verificar a disponibilidade da API e a sintaxe do seletor não prova que a apresentação está correta; também é necessário verificar o aspeto.

Exemplos

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

Resultado

Beta

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes