Node: isConnected-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Die schreibgeschützte isConnected-Eigenschaft des Node-Interfaces gibt einen booleschen Wert zurück, der anzeigt, ob der Knoten (direkt oder indirekt) mit einem Document-Objekt verbunden ist.
Wert
Ein boolescher Wert, der true ist, wenn der Knoten mit seinem relevanten Kontextobjekt verbunden ist, und false wenn nicht.
Hinweis:
Ein Attr-Knoten gibt für isConnected immer false zurück, selbst wenn sein ownerElement verbunden ist.
Dies liegt daran, dass ein Attribut zwar über ownerElement mit einem Element verknüpft ist, jedoch nicht Teil des Knotendbaums ist — es hat keinen übergeordneten Knoten und ist sein eigener Wurzelknoten.
Da isConnected nur dann true ist, wenn die Wurzel eines Knotens ein Dokument ist, wird ein Attr-Knoten niemals als verbunden angesehen.
Beispiele
Standard DOM
Ein Beispiel für Standard DOM:
let test = document.createElement("p");
console.log(test.isConnected); // Returns false
document.body.appendChild(test);
console.log(test.isConnected); // Returns true
Shadow DOM
Ein Beispiel für Shadow DOM:
// Create a shadow root
const shadow = this.attachShadow({ mode: "open" });
// Create some CSS to apply to the shadow DOM
const style = document.createElement("style");
console.log(style.isConnected); // returns false
style.textContent = `
.wrapper {
position: relative;
}
.info {
font-size: 0.8rem;
width: 200px;
display: inline-block;
border: 1px solid black;
padding: 10px;
background: white;
border-radius: 10px;
opacity: 0;
transition: 0.6s all;
positions: absolute;
bottom: 20px;
left: 10px;
z-index: 3
}
`;
// Attach the created style element to the shadow DOM
shadow.appendChild(style);
console.log(style.isConnected); // Returns true
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-node-isconnected① |