WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

container-name — Abfragecontainer benennen

Die Eigenschaft container-name weist einem Element Namen zu, mit denen @container-Regeln einen Container auswählen können. Die Benennung allein aktiviert keine Größenabfragen; dafür ist ein geeignetes container-type erforderlich.

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

Syntax

container-name: none | <custom-ident>+;

container-name weist einem Element einen oder mehrere Namen zu, die die von @container berücksichtigten Container eingrenzen. Eine Abfrage wählt den nächstgelegenen geeigneten Vorfahren mit dem angegebenen Namen aus; sie prüft nicht das gestaltete Element selbst. Namen müssen nicht eindeutig sein.

Der Anfangswert none bedeutet, dass kein Name vorhanden ist, nicht, dass alle Abfragen deaktiviert sind. Die Schreibweise <custom-ident>+ steht für einen oder mehrere durch Leerzeichen getrennte Namen, ohne Kommas oder Anführungszeichen, etwa panel sidebar. Bei Namen wird zwischen Groß- und Kleinschreibung unterschieden. none, and, not und or können keine Namen sein; auch CSS-weite Schlüsselwörter sind keine Namen.

Die Eigenschaft gilt für alle Elemente, wird nicht vererbt und ist nicht animierbar. Sie ersetzt container-type nicht. In einem horizontalen Schreibmodus ermöglicht container-type: inline-size Abfragen der physischen Breite (width). In einem vertikalen Schreibmodus entspricht die Inline-Achse dagegen der Höhe, sodass ein Container mit inline-size für eine width-Abfrage nicht geeignet ist. Verwende dann container-type: size, um Abfragen auf beiden Achsen zu ermöglichen. Die Kurzschreibweise container: panel / inline-size setzt beide Eigenschaften; wird der Teil nach / weggelassen, wird container-type auf normal zurückgesetzt.

Im Beispiel gilt der standardmäßige horizontale Schreibmodus, und der Container ist 320px breit. Daher erhält das .card-Nachfahrenelement durch die benannte Abfrage mit dem Schwellenwert 300px einen Innenabstand von 16px. Wird der Containername in other geändert, passt die Abfrage nicht mehr und es bleiben 4px.

Beispiele

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

Ergebnis

16px

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen