Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

StylePropertyMapReadOnly: get()-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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die get()-Methode der StylePropertyMapReadOnly-Schnittstelle gibt ein CSSStyleValue-Objekt für den ersten Wert der angegebenen Eigenschaft zurück.

Syntax

js
get(property)

Parameter

property

Der Name der Eigenschaft, deren Wert abgerufen werden soll.

Rückgabewert

Ein CSSStyleValue-Objekt.

Beispiele

Grundlegende Nutzung

Lassen Sie uns nur einige Eigenschaften und Werte abrufen. Beginnen wir mit dem Erstellen eines Links innerhalb eines Absatzes in unserem HTML und fügen eine Definitionsliste hinzu, die wir mit JavaScript befüllen:

html
<p>
  <a href="https://example.com">Link</a>
</p>
<dl id="results"></dl>

Wir fügen etwas CSS hinzu, einschließlich einer benutzerdefinierten Eigenschaft und einer vererbbaren Eigenschaft:

css
p {
  font-weight: bold;
}
a {
  --color: red;
  color: var(--color);
}

Wir verwenden die computedStyleMap()-Methode des Elements, um ein StylePropertyMapReadOnly-Objekt zurückzugeben. Wir erstellen ein Array von interessanten Eigenschaften und verwenden die get()-Methode von StylePropertyMapReadOnly, um nur diese Werte abzurufen.

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);
}

Spezifikationen

Spezifikation
CSS Typed OM Level 1
# dom-stylepropertymapreadonly-get

Browser-Kompatibilität

Siehe auch