大网数据广告活动
Web 标准与前端开发

StylePropertyMap: append() method

· 52CE 我爱测

The **`append()`** method of the StylePropertyMap interface adds one or more values to the end of a list-valued CSS property's value list.

CSS Typed Object Model API

The append() method of the StylePropertyMap interface adds one or more values to the end of a list-valued CSS property's value list.

A list-valued CSS property is one whose value is a comma-separated list of terms, such as background-image or animation.

Syntax

append(property)
append(property, value1)
append(property, value1, value2)
append(property, value1, value2, /* …, */ valueN)

Parameters

  • property
    • : An identifier indicating the stylistic feature (e.g., font, width, background color) to add.
  • value1, …, valueN
    • : One or more values to add to the end of property's value list, in the order given.

Return value

None (undefined).

Exceptions

  • TypeError
    • : Thrown if:
      • property is not a valid CSS list-valued property.
      • Any of value1, …, valueN is already associated with a different property (for example, a value read from one property's entry in a StylePropertyMap, then passed to append() for another property).
      • Any of value1, …, valueN is a CSSUnparsedValue or CSSVariableReferenceValue object.
      • property's current value contains a var reference.

Examples

Basic usage

This example shows an extra background image value being added to the background-image property of the element, using 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)",
);

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。