StylePropertyMap: append() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The append() method of the StylePropertyMap interface adds the passed CSS value to the StylePropertyMap with the given property.

Syntax

js
append(property, value)

Parameters

property

An identifier indicating the stylistic feature (e.g. font, width, background color) to add.

value

The value the given property should have.

Return value

None (undefined).

Examples

This example shows an extra background image value being added to the background-image property of the element, using HTMLElement.attributeStyleMap.

js
// 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)",
);

Specifications

Specification
CSS Typed OM Level 1
# dom-stylepropertymap-append

Browser compatibility

BCD tables only load in the browser