JavaScript/DOM/ParentNode/children

Aus SELFHTML-Wiki
Wechseln zu: Navigation, Suche

Der Wert der Eigenschaft children ist eine HTMLCollection die alle Kindknoten des Kontextobjektes enthält, bei denen es sich um Elemente handelt. Kindknoten bei denen es sich nicht um Elemente handelt werden nicht berücksichtigt. Die Eigenschaft steht auf allen Objekten zur Verfügung, die von den Schnittstellen Document, DocumentFragment oder Element erben.


Syntax

ParentNode.children


Anwendungsbeispiel

Wenn es darum geht die Kindelemente eines bestimmten Elementes zu referenzieren, dann ist children das Mittel der Wahl. Ein häufiger Fehler ist es, statt dessen die Eigenschaft childNodes zu verwenden, welche eine NodeList mit allen Kindknoten zurückgibt, unabhängig von deren jeweiligem Typ. Wird hingegen auf die Eigenschaft children zugegriffen, dann werden ausschließlich Kindknoten vom Typ Element referenziert.


Beispiel
<body>
  <main>
    <p>Die Eigenschaft <code>children</code> enthält <em>keine</em> Textknoten.</p>
  </main>
  <script>
document.querySelector('p').children.length; // 2
  </script>
</body>


Der durch das Element p repräsentierte Absatz in dem Beispiel oben besitzt fünf Kindknoten, jedoch nur zwei Kindelemente. Während die von der Eigenschaft childNodes zurückgegebene NodeList auch die Textknoten enthalten würde, sind in der von children zurückgegebenen HTMLCollection nur die beiden Kindelemente code und em enthalten.