Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

::highlight() — dar estilo a resaltados de texto personalizados

El pseudoelemento ::highlight() aplica estilos a rangos de texto registrados mediante la CSS Custom Highlight API, sin añadir elementos contenedores. CSS define la apariencia y JavaScript crea los rangos y registra el resaltado con un nombre.

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

Sintaxis

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

::highlight() es el nombre de un pseudoelemento funcional; no es un selector válido con un argumento vacío. Representa fragmentos de texto cubiertos por un resaltado personalizado. A diferencia de ::selection, no requiere que el usuario seleccione el texto. Los rangos pueden atravesar límites entre elementos sin cambiar la estructura DOM.

Las notaciones ::highlight(<custom-highlight-name>) y ::highlight(<custom-ident>) describen la selección de un resaltado por nombre; los signos angulares indican marcadores de posición, no código literal. En ::highlight(demo), el argumento demo corresponde a la clave de CSS.highlights.set('demo', ...). CSS por sí solo no crea un rango: JavaScript pasa un Range a Highlight y registra el objeto en CSS.highlights.

El Editor’s Draft amplía la sintaxis a ::highlight(<highlight-name-selector>), que admite <custom-ident> o *. ::highlight(*) selecciona todos los resaltados personalizados, pero no los resaltados integrados como ::selection. La forma con nombre aporta una especificidad de (0,0,1), mientras que la forma con * aporta (0,0,0). Esta ampliación del borrador requiere una verificación independiente en el navegador de destino.

Solo se aplican las propiedades permitidas para los resaltados, entre ellas color y background-color; margin, display y font-size no pueden cambiar su disposición. El ejemplo abarca el rango desde el índice 6 hasta el índice exclusivo 10, es decir, Beta. Comprobar la disponibilidad de la API y la sintaxis del selector no demuestra que la representación sea correcta; también hay que comprobar el aspecto.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes