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

StylePropertyMapReadOnly: get() method

· 52CE 我爱测

The **`get()`** method of the StylePropertyMapReadOnly interface returns a CSSStyleValue-derived object for the first value of the specified property.

CSS Typed Object Model API

The get() method of the StylePropertyMapReadOnly interface returns a CSSStyleValue-derived object for the first value of the specified property.

Use StylePropertyMapReadOnly.getAll to get all the values of a CSS property that can have multiple values, such as background-image or transition.

Syntax

get(property)

Parameters

  • property
    • : The name of the property. Custom property names (starting with --) are matched case-sensitively; standard property names are not.

Return value

A CSSStyleValue-derived object, or undefined if property has no value in the map.

The concrete type of the returned object depends on the property and its value. For example, a property assigned a keyword might return a CSSKeywordValue, while a property assigned the result of a mathematical operation might return a CSSMathSum.

Exceptions

  • TypeError
    • : Thrown if property is not a valid CSS property name.

Examples

Basic usage

This example shows how to get a few properties and their values.

HTML

First we create a link inside a paragraph:

<p>
  <a href="https://example.com">Link</a>
</p>
<pre id="log"></pre>

CSS

The CSS styles the font-weight of the paragraph, and defines and uses a custom property for the color of the link:

p {
  font-weight: bold;
}
a {
  --color: red;
  color: var(--color);
}
#log {
  height: 100px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

First we call computedStyleMap() on the element to get its style map: a StylePropertyMapReadOnly object. We create an array of properties of interest and use the get() method of StylePropertyMapReadOnly to log only those values.

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText += `${text}\n`;
}
// get the element and its style map
const myElement = document.querySelector("a");
const styleMap = myElement.computedStyleMap();

// array of properties we're interested in
const properties = ["font-weight", "border-left-color", "color", "--color"];

// log the value of each property of interest
for (const property of properties) {
  log(`${property}: ${styleMap.get(property)}`);
}

Result

Basic usage

Getting different value types

This example demonstrates that get() can return objects of different types, depending on the property and its value.

First it applies a number of different properties to an element using CSS. It then reads them back via JavaScript and logs the constructor name and value of each property. The logging code itself isn't part of the demonstration, so it's hidden here.

HTML

First we define a div with id demoBox to which we'll add styles.

<div id="demoBox">Text</div>
<pre id="log"></pre>

CSS

#demoBox {
  --my-custom-property: "some text";
  opacity: 0.5;
  width: calc(30% - 20px);
  display: block;
  transform: translate(10px, 10px);
}
#log {
  height: 330px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

Next we use computedStyleMap() to get the StylePropertyMapReadOnly object for the demo box, and iterate through each of the properties we added, logging their constructor name and value.

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText += `${text}\n`;
}
const styleMap = document.querySelector("#demoBox").computedStyleMap();
const properties = [
  "opacity",
  "display",
  "width",
  "transform",
  "--my-custom-property",
];

for (const property of properties) {
  const value = styleMap.get(property);
  log(property);
  log(`  type: ${value.constructor.name}`);
  log(`  value: ${value}\n`);
}

Result

Getting different value types

Specifications

Browser compatibility

See also

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

资料来源与适用范围

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

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

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