StylePropertyMapReadOnly: get() method
The get()
method of the
StylePropertyMapReadOnly
interface returns a CSSStyleValue
object for the first value of the specified property.
Syntax
js
get(property)
Parameters
property
-
The name of the property to retrieve the value of.
Return value
A CSSStyleValue
object.
Examples
Let's get just a few properties and values. Let's start by creating a link inside a paragraph in our HTML, and adding a definition list which we will populate with JavaScript:
html
<p>
<a href="https://example.com">Link</a>
</p>
<dl id="results"></dl>
We add a bit of CSS, including a custom property and an inheritable property:
css
p {
font-weight: bold;
}
a {
--color: red;
color: var(--color);
}
We use the Element's
computedStyleMap()
to return a StylePropertyMapReadOnly object. We create an array of properties
of interest and use the StylePropertyMapReadOnly's get()
method to get only
those values.
js
// get the element
const myElement = document.querySelector("a");
// Retrieve all computed styles with computedStyleMap()
const styleMap = myElement.computedStyleMap();
// get the <dl> we'll be populating
const stylesList = document.querySelector("#results");
// array of properties we're interested in
const ofInterest = ["font-weight", "border-left-color", "color", "--color"];
// iterate over our properties of interest
for (const property of ofInterest) {
// properties
const cssProperty = document.createElement("dt");
cssProperty.innerText = property;
stylesList.appendChild(cssProperty);
// values
const cssValue = document.createElement("dd");
// use get() to find the value
cssValue.innerText = styleMap.get(property);
stylesList.appendChild(cssValue);
}
Specifications
Specification |
---|
CSS Typed OM Level 1 # dom-stylepropertymapreadonly-get |
Browser compatibility
BCD tables only load in the browser