CKTIS / CSS
container-name — nombrar contenedores de consulta
La propiedad container-name asigna nombres a un elemento para que las reglas @container puedan seleccionar un contenedor. Ponerle un nombre no activa por sí solo las consultas de tamaño: estas requieren un container-type adecuado.
Versión: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxis
container-name: none | <custom-ident>+;container-name asigna a un elemento uno o varios nombres que filtran los contenedores que tiene en cuenta @container. Una consulta selecciona el antecesor apto más cercano que tenga el nombre indicado; no consulta el propio elemento al que se aplican los estilos. Los nombres no tienen que ser únicos.
El valor inicial none significa que no hay ningún nombre, no que todas las consultas estén desactivadas. La notación <custom-ident>+ significa uno o varios nombres separados por espacios, sin comas ni comillas, como panel sidebar. Se distingue entre mayúsculas y minúsculas. none, and, not y or no pueden ser nombres; las palabras clave globales de CSS tampoco lo son.
La propiedad se aplica a todos los elementos, no se hereda y no es animable. No sustituye a container-type. En un modo de escritura horizontal, container-type: inline-size permite consultar la anchura física (width). En un modo de escritura vertical, en cambio, el eje en línea corresponde a la altura, por lo que un contenedor con inline-size no es apto para una consulta sobre width. En ese caso, usa container-type: size para permitir consultas en ambos ejes. La abreviatura container: panel / inline-size establece ambas propiedades; omitir la parte que va después de / restablece container-type a normal.
El ejemplo usa el modo de escritura horizontal predeterminado y el contenedor tiene 320px de ancho, así que la consulta con nombre y umbral de 300px da un relleno de 16px al descendiente .card. Si se cambia el nombre del contenedor a other, la consulta deja de coincidir y el relleno sigue siendo de 4px.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>container-name</title>
<style>
.panel {
width: 320px;
container-type: inline-size;
container-name: panel sidebar;
}
.card { padding: 4px; }
@container panel (min-width: 300px) {
.card { padding: 16px; }
}
</style>
<div class="panel">
<div class="card">Card</div>
</div>
<script>
const card = document.querySelector('.card');
console.log(getComputedStyle(card).paddingTop);
</script>Resultado
16px
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.