--- title: Wertdefinitionssyntax slug: Web/CSS/Wertdefinitionssyntax tags: - CSS - Referenz translation_of: Web/CSS/Value_definition_syntax ---

{{ CSSRef() }}

Eine formale Grammatik, die CSS Wertdefinitionssyntax, wird für die Definition einer Menge von gültigen Werten für eine CSS Eigenschaft oder Funktion verwendet. Zusätzlich zu dieser Syntax kann die Menge an gültigen Werten durch semantische Beschränkungen (wie z. B. dass eine Zahl positiv sein muss) weiter eingegrenzt werden.

Die Definitionssyntax beschreibt, welche Werte erlaubt sind und die Interaktionen zwischen ihnen. Eine Komponente kann ein Schlüsselwort sein, einige Zeichen, die als Literal interpretiert werden, oder ein Wert eines vorhandenen CSS Datentyps einer anderen CSS Eigenschaft.

Komponentenwert Typen

Schlüsselwörter

Generische Schlüsselwörter

Ein Schlüsselwort mit einer vordefinierten Bedeutung wird wortgetreu, ohne Anführungszeichen, dargestellt, zum Beispiel: auto, smaller oder ease-in.

Die Spezialfälle inherit und initial

Alle CSS Eigenschaften akzeptieren die Schlüsselwörter inherit und initial, die durchweg in CSS definiert werden. Sie werden nicht in der Wertdefinition angezeigt und werden implizit definiert.

Literale

In CSS können einige Zeichen getrennt auftreten, wie der Schrägstrich ('/') oder das Komma (','), und werden in der Eigenschaftendefinition verwendet, um Teile voneinander zu trennen. Das Komma wird oft verwendet, um Werte in Aufzählungen oder Parameter in Mathematik ähnlichen Funktionen zu trennen; der Schrägstrich trennt oft Teile eines Wertes, die semantisch unterscheiden, jedoch eine gemeinsame Syntax haben. Normalerweise wird der Schrägstrich manchmal in Kurzform Eigenschaften verwendet, um Komponenten von einander zu trennen, die vom gleichen Typ sind, aber zu verschiedenen Eigenschaften gehören.

Beide Symbole erscheinen buchstäblich in einer Wertdefinition.

Datentypen

Elementare Datentypen

Bestimmte Daten werden überall in CSS verwendet und werden einmalig für alle Werte in der Spezifikation definiert. Die sogenannten elementaren Datentypen werden durch ihren von den Symbolen '<' und '>' umschlossenen Namen gekennzeichnet: {{ cssxref("<angle>") }}, {{cssxref("<string>")}}, …

Nichtterminale Datentypen

Weniger häufige Datentypen, genannt nichtterminale Datentypen, werden ebenfalls von '<' und '>' umschlossen.

Es gibt zwei Arten von nichtterminalen Datentypen:

Komponentenwert Kombinatoren

Eckige Klammern

Eckige Klammern schließen mehrere Entitäten, Kombinatoren und Multiplikatoren ein und transformieren diese anschließend als eine einzige Komponente. Sie werden benutzt, um Komponenten zu gruppieren und so die Rangordnungsregeln zu umgehen.

bold [ thin && <length> ]

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Nebeneinanderstellung

Wenn mehrere Schlüsselwörter, Literale oder Datentypen aufgereiht werden und nur durch ein oder mehrere Leerzeichen getrennt werden, nennt man dies Nebeneinanderstellung. Alle nebeneinander gestellten Komponenten sind zwingend und müssen in der exakten Reihenfolge angegeben werden.

bold <length> , thin

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Doppeltes Und-Zeichen

Wenn zwei oder mehrere Komponenten durch ein doppeltes Und-Zeichen, &&, getrennt sind, bedeutet das, dass alle diese Entitäten zwingend sind, jedoch in beliebiger Reihenfolge auftreten können.

bold && <length>

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Hinweis: Juxtaposition hat Vorrang gegenüber dem doppelten Und-Zeichen, was bedeutet, dass bold thin && <length> gleichbedeutend ist mit [ bold thin ] && <length>. Dies beschreibt bold thin <length> oder <length> bold thin, aber nicht bold <length> thin.

Doppelter Balken

Wenn zwei oder mehrere Komponenten durch einen doppelten Balken, ||, getrennt sind, bedeutet das, dass alle Entitäten optional sind: mindestens eine davon muss angegeben werden, und sie können in beliebiger Reihenfolge auftreten. Normalerweise wird dies verwendet, um die verschiedenen Werte einer Kurzform Eigenschaft zu definieren.

<'border-width'> || <'border-style'> || <'border-color'>

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Hinweis: Das doppelte Und-Zeichen hat Vorrang gegenüber dem doppelten Balken, was bedeutet, dass bold || thin && <length> gleichbedeutend ist mit bold || [ thin && <length> ]. Dies beschreibt bold, thin, <length>, bold thin, <length> bold, oder thin <length> bold, aber nicht bold <length> bold thin, da bold, falls nicht weggelassen, vor oder nach der gesamten thin && <length> Komponente platziert werden muss.

Einfacher Balken

Wenn zwei oder mehrere Entitäten durch einen einfachen Balken, |, getrennt werden, bedeutet das, dass alle Entitäten exklusive Optionen sind: genau eine dieser Optionen muss angegeben werden. Dies wird normalerweise benutzt, um eine Liste möglicher Schlüsselwörter zu trennen.

<percentage> | <length> | left | center | right | top | bottom

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Hinweis: Der doppelte Balken hat Vorrang gegenüber dem einfachen Balken, was bedeutet, dass bold | thin || <length> gleichbedeutend ist mit bold | [ thin || <length> ]. Dies beschreibt bold, thin, <length>, <length> thin, oder thin <length>, aber nicht bold <length>, da nur eine Entität jeder Seite des | Kombinators vorkommen darf.

Komponentenwert Multiplikatoren

Ein Multiplikator ist ein Zeichen, das angibt, wie oft eine vorhergehende Entität wiederholt werden kann. Ohne einen Multiplikator muss eine Entität exakt einmal vorkommen.

{{Note("Multiplikatoren können nicht zu Kombinatoren hinzugefügt werden und haben auch keinen Vorrang vor diesen.")}}

Asterisk (*)

Der Asterisk Multiplikator gibt an, dass die Entität keinmal, einmal oder mehrmals vorkommen kann.

bold smaller*

Dieses Beispiel passt auf die folgende Werte:

Aber nicht:

Plus (+)

Der Plus Multiplikator gibt an, dass die Entität einmal oder mehrmals vorkommen kann.

bold smaller+

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Fragezeichen (?)

Der Fragezeichen Multiplikator gibt an, dass die Entität optional ist und keinmal oder einmal vorkommen kann.

bold smaller?

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Geschweifte Klammern ({ })

Der Geschweifte Klammern Multiplikator schließt zwei durch Komma getrennte Ganzzahlen A und B ein und gibt an, dass die Entität mindestens A-mal vorkommen muss und höchstens B-mal vorkommen darf.

bold smaller{1,3}

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Rautensymbol (#)

Der Rautensymbol Multiplizierer gibt an, dass die Entität einmal oder mehrmals wiederholt werden kann (wie beim Plus Multiplikator), jedoch jedes Vorkommen durch ein Komma (',') getrennt wird.

bold smaller#

Dieses Beispiel passt auf die folgenden Werte:

Aber nicht:

Übersicht

Zeichen Name Beschreibung Beispiel
Kombinatoren
  Nebeneinanderstellung Komponenten sind zwingend und müssen in der angegebenen Reihenfolge vorkommen solid <length>
&& Doppeltes Und-Zeichen Komponenten sind zwingend, aber können in beliebiger Reihenfolge vorkommen <length> && <string>
|| Doppelter Balken Mindestens eine der Komponenten muss angegeben werden und sie können in beliebiger Reihenfolge vorkommen <'border-image-outset'> || <'border-image-slice'>
| Einfacher Balken Genau eine der Komponenten muss angegeben werden smaller | small | normal | big | bigger
[ ] Eckige Klammern Gruppierung von Komponenten, um Rangordnungsregeln zu umgehen bold [ thin && <length> ]
Multiplizierer
  Kein Multiplizierer Genau einmal solid
* Asterisk 0 oder mehrmals bold smaller*
+ Pluszeichen 1 oder mehrmals bold smaller+
? Fragezeichen 0 oder 1-mal (that is optional) bold smaller?
{A,B} Geschweifte Klammern Mindestens A-mal, höchstens B-mal bold smaller{1,3}
# Rautensymbol 1 oder mehrmals, aber jedes Vorkommen getrennt durch Komma (',') bold smaller#

Spezifikationen

Spezifikation Status Kommentar
{{ SpecName('CSS3 Values', '#value-defs', 'Value definition syntax') }} {{ Spec2('CSS3 Values') }} Fügt den Rautensymbol Multiplizierer hinzu.
{{ SpecName('CSS2.1', 'about.html#value-defs', 'Value definition syntax') }} {{ Spec2('CSS2.1') }} Fügt den doppelten Und-Zeichen Kombinator hinzu.
{{SpecName('CSS1', '#notation-for-property-values', 'Value definition syntax') }} {{ Spec2('CSS1') }} Ursprüngliche Definition

Siehe auch