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

CKTIS / CSS

Propiedades personalizadas de CSS: --*

Las propiedades personalizadas almacenan valores con nombres que empiezan por --. Participan en la cascada, se heredan de forma predeterminada y permiten que var() inserte sus valores en declaraciones de otras propiedades.

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

Sintaxis

--name: <declaration-value>?;
property: var(--name, fallback);

--* representa la familia de propiedades personalizadas, no un nombre literal de declaración. Usa un identificador válido que empiece por --, como --size; -- por sí solo está reservado. Se distingue entre mayúsculas y minúsculas: --size y --Size son propiedades diferentes.

Las propiedades personalizadas no registradas participan en la cascada y se heredan. Almacenan tokens CSS, que no tienen por qué ser un valor válido para la propiedad que los consume. var(--size, 20px) sustituye por el valor de --size; el valor alternativo se aplica cuando esa propiedad tiene el valor garantizado como no válido, incluso si no hay ninguna declaración que la proporcione. No corrige un valor existente que no sea adecuado para la propiedad que lo consume: --size: red no activará el valor alternativo para width.

El valor inicial de una propiedad no registrada es garantizado como no válido; initial lo restaura. En cambio, la declaración vacía --size:; es un valor vacío válido. Las referencias cíclicas producen valores no válidos. En el ejemplo, el primer rectángulo hereda 40px, mientras que el segundo usa el valor alternativo 20px tras aplicar initial.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>Custom property inheritance</title>
<style>
  .group { --size: 40px; }
  .box {
    width: var(--size, 20px);
    height: 20px;
    background: black;
    margin-bottom: 4px;
  }
  .reset { --size: initial; }
</style>
<div class="group">
  <div class="box"></div>
  <div class="box reset"></div>
</div>

Resultado

.box: width = 40px
.box.reset: width = 20px

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