HTMLStyleElement: disabled-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since November 2015.
Die HTMLStyleElement.disabled
-Eigenschaft kann verwendet werden, um festzulegen oder abzurufen, ob das Stylesheet deaktiviert (true
) oder nicht (false
) ist.
Beachten Sie, dass es kein entsprechendes disabled
-Attribut auf dem HTML <style>
-Element gibt.
Wert
Gibt true
zurück, wenn das Stylesheet deaktiviert ist oder kein zugeordnetes Stylesheet vorhanden ist; ansonsten false
.
Der Wert ist standardmäßig false
(wenn ein zugeordnetes Stylesheet vorhanden ist).
Die Eigenschaft kann verwendet werden, um ein zugeordnetes Stylesheet zu aktivieren oder zu deaktivieren.
Das Setzen der Eigenschaft auf true
, wenn kein zugeordnetes Stylesheet vorhanden ist, hat keine Wirkung.
Beispiele
Deaktivieren eines Inline-Styles
Dieses Beispiel demonstriert das programmgesteuerte Setzen der disabled-Eigenschaft auf einen Stil, der im HTML mithilfe des HTML <style>
-Elements definiert wurde.
Beachten Sie, dass Sie auch auf alle Stylesheets im Dokument mittels Document.styleSheets
zugreifen können.
HTML
Das HTML enthält ein HTML <style>
-Element, das die Absatz-Elemente blau färbt, ein Absatz-Element und einen Button, der verwendet wird, um den Stil zu aktivieren und zu deaktivieren.
<button>Enable</button>
<style id="InlineStyle">
p {
color: blue;
}
</style>
<p>Text is black when style is disabled; blue when enabled.</p>
<p></p>
JavaScript
Der untenstehende Code erhält das style
-Element über seine ID und setzt es dann als deaktiviert.
Da der Stil bereits existiert, da er im SVG definiert ist, sollte dies gelingen.
const style = document.getElementById("InlineStyle");
style.disabled = true;
Wir fügen dann einen Ereignishandler für den Button hinzu, der den disabled
-Wert und den Button-Text umschaltet.
const button = document.querySelector("button");
button.addEventListener("click", () => {
style.disabled = !style.disabled;
const buttonText = style.disabled ? "Enable" : "Disable";
button.innerText = buttonText;
});
Ergebnis
Das Ergebnis wird unten angezeigt.
Drücken Sie den Button, um den disabled
-Eigenschaftswert des Stils für den Absatztext umzuschalten.
Deaktivieren eines programmatisch definierten Stils
Dieses Beispiel ist dem obigen sehr ähnlich, mit dem Unterschied, dass der Stil programmatisch definiert wird.
HTML
Das HTML ist ähnlich zum vorherigen Fall, aber die Definition enthält kein Standardstyling.
<button>Enable</button>
<p>Text is black when style is disabled; blue when enabled.</p>
<p></p>
JavaScript
Zuerst erstellen wir das neue Style-Element im HTML.
Dies geschieht, indem zunächst ein Style-Element mithilfe von Document.createElement()
erstellt wird, ein Textknoten mit der Stildefinition erstellt und angehängt wird, und dann das Style-Element an den Dokumentenkörper angehängt wird.
// Create the `style` element
const style = document.createElement("style");
const node = document.createTextNode("p { color: blue; }");
style.appendChild(node);
document.body.appendChild(style);
Wir können den Stil dann wie unten gezeigt deaktivieren.
Beachten Sie, dass dies der früheste Punkt ist, an dem das Setzen der Eigenschaft auf true
erfolgreich sein wird.
Vor diesem Punkt hatte das Dokument keinen zugeordneten Stil, sodass der Wert standardmäßig false
ist.
// Disable the style
style.disabled = true;
Zum Schluss fügen wir einen Ereignishandler für den Button hinzu, der den deaktivierten Zustand und den Button-Text umschaltet (dies ist derselbe wie im vorherigen Beispiel).
const button = document.querySelector("button");
button.addEventListener("click", () => {
style.disabled = !style.disabled;
const buttonText = style.disabled ? "Enable" : "Disable";
button.innerText = buttonText;
});
Ergebnis
Das Ergebnis wird unten angezeigt. Drücken Sie den Button, um den deaktivierten Zustand des Stils, der für den Text verwendet wird, umzuschalten.
Spezifikationen
Specification |
---|
HTML # dom-style-disabled |