CKTIS / CSS
Propiedades personalizadas de CSS y temas
Las propiedades personalizadas almacenan valores que consume var(). La cascada y la herencia permiten compartir tokens de diseño y sobrescribirlos localmente, por ejemplo, para crear un tema oscuro.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
--token: value;
property: var(--token);
property: var(--token, fallback);Una propiedad personalizada tiene un nombre que empieza por --, como --ink. En los nombres se distingue entre mayúsculas y minúsculas: --ink y --Ink son distintos. var(--ink) sustituye su valor en el valor de otra propiedad; no crea selectores ni nombres de propiedades.
Las propiedades personalizadas no registradas participan en la cascada y se heredan. Coloca los tokens compartidos en :root y las sobrescrituras del tema en un contenedor. Los descendientes heredan los valores sobrescritos, salvo que tengan sus propias declaraciones. En el ejemplo, .dark cambia los tokens, mientras que la regla .card se mantiene compartida.
var(--space, 16px) usa el valor alternativo cuando falta el token o tiene el valor garantizado como no válido, por ejemplo, debido a un ciclo de dependencias. No comprueba si un token existente es adecuado para la propiedad de destino: --ink: 16px no activará el valor alternativo en color: var(--ink, black). La declaración pasa a ser no válida en el momento del cálculo de valores; para color, esto significa herencia, no volver a una declaración anterior de la cascada.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Custom properties</title>
<style>
:root {
--surface: white;
--ink: black;
}
.dark {
--surface: black;
--ink: white;
}
.card {
background-color: var(--surface);
color: var(--ink);
padding: var(--space, 16px);
}
</style>
<div class="card">Light</div>
<section class="dark">
<div class="card">Dark</div>
</section>
</html>Resultado
Light: black text on white; Dark: white text on black. Both cards: 16px padding on every side.
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.