StylePropertyMap: append()-Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die append()-Methode der StylePropertyMap-Schnittstelle fügt einem Werteliste einer CSS-Eigenschaft mit Listenwerten einen oder mehrere Werte hinzu.
Eine CSS-Eigenschaft mit Listenwerten ist eine, deren Wert eine durch Kommas getrennte Liste von Begriffen ist, wie z.B. background-image oder animation.
Syntax
append(property)
append(property, value1)
append(property, value1, value2)
append(property, value1, value2, /* …, */ valueN)
Parameter
property-
Ein Bezeichner, der das stilistische Merkmal angibt (z.B. Schriftart, Breite, Hintergrundfarbe), das hinzugefügt werden soll.
value1, …,valueN-
Ein oder mehrere Werte, die in der angegebenen Reihenfolge am Ende der Werteliste von
propertyhinzugefügt werden sollen.
Rückgabewert
Keiner (undefined).
Ausnahmen
TypeError-
Wird ausgelöst, wenn:
propertykeine gültige CSS-Eigenschaft mit Listenwerten ist.- Einer der
value1, …,valueNbereits mit einer anderen Eigenschaft verbunden ist (zum Beispiel ein Wert, der aus dem Eintrag einer Eigenschaft in einemStylePropertyMapgelesen und dann anappend()für eine andere Eigenschaft übergeben wurde). - Einer der
value1, …,valueNeinCSSUnparsedValue- oderCSSVariableReferenceValue-Objekt ist. - Der aktuelle Wert von
propertyeinenvar()-Verweis enthält.
Beispiele
Grundlegende Verwendung
Dieses Beispiel zeigt, wie ein zusätzlicher Hintergrundbild-Wert zur background-image-Eigenschaft des Elements hinzugefügt wird, unter Verwendung von HTMLElement.attributeStyleMap.
// get the button element
const buttonEl = document.querySelector("button");
// append another value to the background-image property set on the attribute
buttonEl.attributeStyleMap.append(
"background-image",
"linear-gradient(180deg, blue, black)",
);
Spezifikationen
| Spezifikation |
|---|
| CSS Typed OM Level 1 # dom-stylepropertymap-append |