container-name
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Februar 2023.
Die container-name CSS-Eigenschaft legt eine Liste von Abfragecontainernamen fest, die durch die @container-Regel in einer Containerabfrage verwendet werden. Eine Containerabfrage wird Stile auf Elemente basierend auf der Größe oder dem Scrollzustand des nächstgelegenen Vorfahren mit einem Containment-Kontext anwenden. Wenn einem Containment-Kontext ein Name zugewiesen wird, kann er gezielt mit der @container
-Regel anvisiert werden, anstatt des nächstgelegenen Vorfahren mit Containment.
Hinweis: Bei der Verwendung der container-type
- und container-name
-Eigenschaften werden die Werte style
und layout
der contain
-Eigenschaft automatisch angewendet.
Syntax
container-name: none; /* A single name */ container-name: my-layout; /* Multiple names */ container-name: my-page-layout my-component-library; /* Global Values */ container-name: inherit; container-name: initial; container-name: revert; container-name: revert-layer; container-name: unset;
Werte
none
-
Standardwert. Der Abfragecontainer hat keinen Namen.
<custom-ident>
-
Eine groß- und kleinschreibungsempfindliche Zeichenfolge, die zur Identifizierung des Containers verwendet wird. Die folgenden Bedingungen gelten:
- Der Name darf nicht
or
,and
,not
oderdefault
entsprechen. - Der Name darf nicht in Anführungszeichen stehen.
- Der gestrichelte Identifikator, der für benutzerdefinierte Bezeichner gedacht ist (z.B.
--container-name
), ist erlaubt. - Eine Liste von mehreren Namen, getrennt durch ein Leerzeichen, ist zulässig.
- Der Name darf nicht
Formale Definition
Anfangswert | none |
---|---|
Anwendbar auf | alle Elemente |
Vererbt | Nein |
Berechneter Wert | none or an ordered list of identifiers |
Animationstyp | Not animatable |
Formale Syntax
container-name =
none |
<custom-ident>+
Beispiele
>Verwendung eines Container-Namens
Beispiel des folgenden HTML, welches eine Kartenkomponente mit einem Titel und etwas Text ist:
<div class="card"> <div class="post-meta"> <h2>Card title</h2> <p>My post details.</p> </div> <div class="post-excerpt"> <p> A preview of my <a href="https://example.com">blog post</a> about cats. </p> </div> </div>
Um einen Containment-Kontext zu erstellen, fügen Sie die container-type
-Eigenschaft zu einem Element in CSS hinzu. Das folgende Beispiel erstellt zwei Containment-Kontexte, einen für die Metainformationen der Karte und einen für den Beitragstext:
Hinweis: Eine Kurzschreibweise für diese Deklarationen wird auf der container
-Seite beschrieben.
.post-meta { container-type: inline-size; } .post-excerpt { container-type: inline-size; container-name: excerpt; }
Das Schreiben einer Containerabfrage über die @container
-Regel wird Stile auf die Elemente des Containers anwenden, wenn die Abfrage zu wahr evaluiert wird. Das folgende Beispiel hat zwei Containerabfragen, eine, die nur auf den Inhalt des .post-excerpt
-Elements angewendet wird, und eine, die sowohl auf den .post-meta
- als auch auf den .post-excerpt
-Inhalt angewendet wird:
@container excerpt (width >= 400px) { p { visibility: hidden; } } @container (width >= 400px) { p { font-size: 2rem; } }
Weitere Informationen zum Schreiben von Containerabfragen finden Sie auf der CSS Container Queries Seite.
Verwendung mehrerer Container-Namen
Sie können auch mehrere Namen für einen Container-Kontext durch ein Leerzeichen getrennt angeben:
.post-meta { container-type: inline-size; container-name: meta card; }
Dies ermöglicht es Ihnen, den Container mit einem der beiden Namen in der @container
-Regel anzusprechen. Dies ist nützlich, wenn Sie denselben Container mit mehreren Containerabfragen ansprechen möchten, bei denen eine der Bedingungen zutreffen könnte:
@container meta (width <= 500px) { p { visibility: hidden; } } @container card (width <= 200px) { h2 { font-size: 1.5em; } }
Spezifikationen
Specification |
---|
CSS Conditional Rules Module Level 5> # container-name> |
Browser-Kompatibilität
Loading…
Siehe auch
- CSS Container Queries
- Verwendung von Größen- und Stilabfragen für Container
- Verwendung von Scrollzustand-Abfragen für Container
@container
-Regel- CSS
container
Kurzschreibweise - CSS
container-type
Eigenschaft - CSS
content-visibility
Eigenschaft