Objekt integriertes Objekt
  1. Titelseite
  2. eingebaute Objekte
  3. ObjectXmlElement

ObjectXmlElement

XmlElement-Objekte repräsentieren Elemente in einem XML-Dokument

Erbschaftsverhältnis

%0 object object toString() toJSON() XmlNode XmlNode nodeType nodeName nodeValue ownerDocument parentNode childNodes children firstChild lastChild previousSibling nextSibling firstElementChild lastElementChild previousElementSibling nextElementSibling textContent hasChildNodes() normalize() cloneNode() lookupPrefix() lookupNamespaceURI() insertBefore() insertAfter() appendChild() replaceChild() removeChild() object->XmlNode XmlElement XmlElement namespaceURI prefix localName tagName id innerHTML outerHTML className attributes getAttribute() getAttributeNS() setAttribute() setAttributeNS() removeAttribute() removeAttributeNS() hasAttribute() hasAttributeNS() getElementsByTagName() getElementsByTagNameNS() getElementById() getElementsByClassName() XmlNode->XmlElement

Mitgliedereigenschaften

namespaceURI

String, URI des Namespace des Abfrageelements. Wenn der ausgewählte Knoten keinen Namespace hat, gibt diese Eigenschaft NULL zurück

1
readonly String XmlElement.namespaceURI;

prefix

String, Abfrage und Festlegung des Namespace-Präfixes des Elements. Wenn der ausgewählte Knoten keinen Namespace hat, gibt diese Eigenschaft NULL zurück

1
String XmlElement.prefix;

localName

String, der lokale Name des Abfrageelements. Wenn der ausgewählte Knoten keinen Namespace hat, entspricht diese Eigenschaft nodeName

1
readonly String XmlElement.localName;

tagName

String, gibt den Tag-Namen des Elements zurück

1
readonly String XmlElement.tagName;

id

String, Abfrage und Festlegen des ID-Attributs des Elements

1
String XmlElement.id;

innerHTML

String, Abfrage und Festlegung des HTML-Textes der Nachkommen des ausgewählten Elements, nur gültig im HTML-Modus. Geben Sie bei der Abfrage die HTML-Kodierung aller untergeordneten Knoten innerhalb des Elementknotens zurück. Löschen Sie beim Festlegen alle untergeordneten Knoten und ersetzen Sie sie durch die angegebene HTML-Dekodierung.

1
String XmlElement.innerHTML;

outerHTML

Zeichenfolge, Abfrage des HTML-Textes des ausgewählten Elements und seiner Nachkommen, nur gültig im HTML-Modus. Geben Sie bei der Abfrage die HTML-Codierung des Elements und aller untergeordneten Knoten innerhalb des Knotens zurück.

1
readonly String XmlElement.outerHTML;

className

String, Abfrage und Festlegen des Klassenattributs des Elements, nur gültig im HTML-Modus

1
String XmlElement.className;

attributes

XmlNamedNodeMap, gibt eine NamedNodeMap zurück, die die Attribute des ausgewählten Knotens enthält. Wenn der ausgewählte Knoten kein Element ist, gibt diese Eigenschaft NULL zurück.

1
readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

Ganzzahl, gibt den Knotentyp des Knotens zurück

1
readonly Integer XmlElement.nodeType;

Der Knotentyp verschiedener Objekte gibt unterschiedliche Werte zurück:

nodeName

String gibt den Namen des Knotens entsprechend seinem Typ zurück

1
readonly String XmlElement.nodeName;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:

nodeValue

String gibt den Namen des Knotens entsprechend seinem Typ zurück

1
String XmlElement.nodeValue;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:

ownerDocument

XmlDocument, gibt das Wurzelelement des Knotens zurück (XmlDocumentObjekt)

1
readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode, kann den übergeordneten Knoten eines Knotens zurückgeben

1
readonly XmlNode XmlElement.parentNode;

childNodes

XmlNodeList, gibt die Knotenliste der untergeordneten Knoten des angegebenen Knotens zurück

1
readonly XmlNodeList XmlElement.childNodes;

children

XmlNodeList, gibt die Knotenliste der untergeordneten Elementknoten des angegebenen Knotens zurück.

1
readonly XmlNodeList XmlElement.children;

firstChild

XmlNode, gibt den ersten untergeordneten Knoten des Knotens zurück

1
readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode, gibt den letzten untergeordneten Knoten des Knotens zurück

1
readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNode, gibt den Knoten zurück, der einem Knoten unmittelbar vorangeht (auf derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt diese Eigenschaft null zurück.

1
readonly XmlNode XmlElement.previousSibling;

nextSibling

XmlNode, gibt den Knoten zurück, der unmittelbar auf ein Element folgt (in derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt das Attribut null zurück.

1
readonly XmlNode XmlElement.nextSibling;

firstElementChild

XmlNode, gibt den ersten untergeordneten Elementknoten des Knotens zurück

1
readonly XmlNode XmlElement.firstElementChild;

lastElementChild

XmlNode, gibt den letzten untergeordneten Elementknoten des Knotens zurück

1
readonly XmlNode XmlElement.lastElementChild;

previousElementSibling

XmlNode, gibt den Elementknoten zurück, der einem Knoten unmittelbar vorangeht (auf derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt diese Eigenschaft null zurück.

1
readonly XmlNode XmlElement.previousElementSibling;

nextElementSibling

XmlNode, gibt den Elementknoten zurück, der unmittelbar auf ein Element folgt (in derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt das Attribut null zurück.

1
readonly XmlNode XmlElement.nextElementSibling;

textContent

String, fragt den Text des ausgewählten Elements ab und legt ihn fest. Gibt beim Abfragen die Werte aller Textknoten innerhalb des Elementknotens zurück; beim Festlegen werden alle untergeordneten Knoten gelöscht und durch einen einzelnen Textknoten ersetzt.

1
String XmlElement.textContent;

Mitgliedsfunktion

getAttribute

Fragen Sie den Wert eines Attributs nach Namen ab

1
String XmlElement.getAttribute(String name);

Aufrufparameter:

  • name: String, gibt den Attributnamen der Abfrage an

Rückgabeergebnisse:

  • String, gibt den Wert des Attributs zurück

getAttributeNS

Rufen Sie den Attributwert nach Namespace-URI und Name ab

1
2
String XmlElement.getAttributeNS(String namespaceURI,
    String localName);

Aufrufparameter:

  • namespaceURI: Zeichenfolge, die den Namespace-URI der Abfrage angibt
  • localName: String, gibt den Attributnamen der Abfrage an

Rückgabeergebnisse:

  • String, gibt den Wert des Attributs zurück

setAttribute

Erstellen oder ändern Sie eine neue Eigenschaft

1
2
XmlElement.setAttribute(String name,
    String value);

Aufrufparameter:

  • name: String, gibt den festzulegenden Attributnamen an
  • value: String, gibt den festzulegenden Attributwert an

Diese Methode setzt die angegebene Eigenschaft auf den angegebenen Wert. Wenn eine Eigenschaft mit dem angegebenen Namen nicht vorhanden ist, erstellt diese Methode eine neue Eigenschaft

setAttributeNS

Namespace-Eigenschaften erstellen oder ändern

1
2
3
XmlElement.setAttributeNS(String namespaceURI,
    String qualifiedName,
    String value);

Aufrufparameter:

  • namespaceURI: String, gibt den festzulegenden Namespace-URI an
  • qualifiedName: String, gibt den festzulegenden Attributnamen an
  • value: String, gibt den festzulegenden Attributwert an

Diese Methode ähnelt der setAttribute-Methode, außer dass das zu erstellende oder festzulegende Attribut durch einen Namespace-URI und einen qualifizierten Namen bestehend aus einem Namespace-Präfix, einem Doppelpunkt und einem lokalen Namen im Namespace angegeben wird. Zusätzlich zum Ändern des Werts eines Attributs können Sie mit dieser Methode auch das Namespace-Präfix des Attributs ändern.

removeAttribute

Angegebenes Attribut nach Namen entfernen

1
XmlElement.removeAttribute(String name);

Aufrufparameter:

  • name: String, gibt den zu löschenden Attributnamen an

removeAttributeNS

Entfernen Sie die angegebenen Eigenschaften nach Namespace und Name

1
2
XmlElement.removeAttributeNS(String namespaceURI,
    String localName);

Aufrufparameter:

  • namespaceURI: String, gibt den zu löschenden Namespace-URI an
  • localName: String, gibt den zu löschenden Attributnamen an

hasAttribute

Fragen Sie ab, ob der aktuelle Knoten ein Attribut mit dem angegebenen Namen hat

1
Boolean XmlElement.hasAttribute(String name);

Aufrufparameter:

  • name: String, gibt den Attributnamen der Abfrage an

Rückgabeergebnisse:

  • BooleanWenn der aktuelle Elementknoten das angegebene Attribut hat, wird true zurückgegeben, andernfalls wird false zurückgegeben

hasAttributeNS

Fragen Sie ab, ob der aktuelle Knoten Attribute mit dem angegebenen Namespace und Namen hat

1
2
Boolean XmlElement.hasAttributeNS(String namespaceURI,
    String localName);

Aufrufparameter:

  • namespaceURI: String, gibt den abzufragenden Namespace-URI an
  • localName: String, gibt den Attributnamen der Abfrage an

Rückgabeergebnisse:

  • BooleanWenn der aktuelle Elementknoten das angegebene Attribut hat, wird true zurückgegeben, andernfalls wird false zurückgegeben

getElementsByTagName

Gibt alle Elemente mit dem angegebenen Namen zurückXmlNodeList

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Aufrufparameter:

  • tagName: String, der abzurufende Tag-Name. Der Wert „*“ entspricht allen Tags

Rückgabeergebnisse:

  • XmlNodeList, der XmlElement-Knoten mit dem angegebenen Tag in der KnotenstrukturXmlNodeListversammeln. Die Reihenfolge der zurückgegebenen Elementknoten entspricht der Reihenfolge, in der sie im Quelldokument erscheinen.

Diese Methode durchläuft die Nachkommenknoten des angegebenen Elements und gibt einen XmlElement-Knoten zurück.XmlNodeListObjekt, das alle Dokumentelemente mit dem angegebenen Tag-Namen darstellt. Die Reihenfolge der Elemente im zurückgegebenen Array entspricht der Reihenfolge, in der sie im Quellcode des Dokuments erscheinen.

XmlDocumentDie Schnittstelle definiert auch die Methode getElementsByTagName, die dieser Methode ähnelt, jedoch das gesamte Dokument durchläuft, anstatt die untergeordneten Knoten eines Elements zu durchlaufen.

getElementsByTagNameNS

Gibt alle Elemente mit dem angegebenen Namespace und Namen zurückXmlNodeList

1
2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
    String localName);

Aufrufparameter:

  • namespaceURI: String, gibt den abzufragenden Namespace-URI an
  • localName: String, der abzurufende Tag-Name. Der Wert „*“ entspricht allen Tags

Rückgabeergebnisse:

  • XmlNodeList, der XmlElement-Knoten mit dem angegebenen Tag in der KnotenstrukturXmlNodeListversammeln. Die Reihenfolge der zurückgegebenen Elementknoten entspricht der Reihenfolge, in der sie im Quelldokument erscheinen.

Diese Methode ähnelt der getElementsByTagName-Methode, außer dass der Tag-Name des Elements, das Sie abrufen möchten, als Kombination aus dem Namespace-URI und dem im Namespace definierten lokalen Namen angegeben wird.

getElementById

Gibt das Element mit dem angegebenen ID-Attribut zurück

1
XmlElement XmlElement.getElementById(String id);

Aufrufparameter:

  • id: String, die abzurufende ID

Rückgabeergebnisse:

  • XmlElement, der XmlElement-Knoten mit dem angegebenen ID-Attribut in der Knotenstruktur

Diese Methode durchläuft die Nachkommenknoten des angegebenen Elements und gibt ein XmlElement-Knotenobjekt zurück, das das erste Dokumentelement mit dem angegebenen ID-Attribut darstellt. .

XmlDocumentDie Schnittstelle definiert auch die Methode getElementsByTagName, die dieser Methode ähnelt, jedoch das gesamte Dokument durchläuft, anstatt die untergeordneten Knoten eines Elements zu durchlaufen.

getElementsByClassName

Gibt eine Knotenliste aller Elemente mit dem angegebenen Klassennamen zurück

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Aufrufparameter:

  • className: String, der abzurufende Klassenname

Rückgabeergebnisse:

  • XmlNodeList, der XmlElement-Knoten mit dem angegebenen Klassennamen in der DokumentstrukturXmlNodeListversammeln. Die Reihenfolge der zurückgegebenen Elementknoten entspricht der Reihenfolge, in der sie im Quelldokument erscheinen.

Diese Methode gibt a zurückXmlNodeListObjekt (kann als schreibgeschütztes Array verarbeitet werden), das alle XmlElement-Knoten mit dem angegebenen Klassennamen im Dokument speichert. Die Reihenfolge, in der sie gespeichert werden, entspricht der Reihenfolge, in der sie im Quelldokument erscheinen.XmlNodeListDas Objekt ist „live“, d. h. wenn ein Element mit dem angegebenen Tag-Namen im Dokument hinzugefügt oder gelöscht wird, wird sein Inhalt bei Bedarf automatisch aktualisiert.

hasChildNodes

Fragen Sie ab, ob untergeordnete Knoten vorhanden sind

1
Boolean XmlElement.hasChildNodes();

Rückgabeergebnisse:

  • Boolean, gibt „true“ zurück, wenn es untergeordnete Knoten gibt, andernfalls wird „false“ zurückgegeben

normalize

Benachbarte Textknoten zusammenführen und leere Textknoten löschen

1
XmlElement.normalize();

Diese Methode durchläuft alle Nachkommenknoten des aktuellen Knotens und normalisiert das Dokument, indem leere Textknoten gelöscht und alle angrenzenden Textknoten zusammengeführt werden. Diese Methode ist nützlich, um die Struktur des Dokumentbaums nach dem Einfügen oder Löschen von Knoten zu vereinfachen.

cloneNode

Erstellt eine exakte Kopie des angegebenen Knotens

1
XmlNode XmlElement.cloneNode(Boolean deep = true);

Aufrufparameter:

  • deep: Boolescher Wert, ob tief kopiert werden soll. Wenn true, klont der geklonte Knoten alle untergeordneten Knoten des ursprünglichen Knotens

Rückgabeergebnisse:

  • XmlNode, gibt den kopierten Knoten zurück

Diese Methode kopiert den Knoten, auf dem sie aufgerufen wurde, und gibt eine Kopie zurück. Wenn das übergebene Argument wahr ist, werden auch alle Nachkommenknoten des aktuellen Knotens rekursiv kopiert. Andernfalls wird nur der aktuelle Knoten kopiert. Der zurückgegebene Knoten gehört nicht zum Dokumentbaum und seine parentNode-Eigenschaft ist null. Wenn ein Elementknoten kopiert wird, werden alle seine Eigenschaften kopiert.

lookupPrefix

Gibt das Präfix zurück, das dem angegebenen Namespace-URI auf dem aktuellen Knoten entspricht

1
String XmlElement.lookupPrefix(String namespaceURI);

Aufrufparameter:

  • namespaceURI: String, gibt den passenden Namespace-URI an

Rückgabeergebnisse:

  • String, gibt das passende Präfix zurück, gibt null zurück, wenn es nicht übereinstimmt.

lookupNamespaceURI

Gibt den Namespace-URI zurück, der dem angegebenen Präfix auf dem aktuellen Knoten entspricht

1
String XmlElement.lookupNamespaceURI(String prefix);

Aufrufparameter:

  • prefix: String, gibt das passende Präfix an

Rückgabeergebnisse:

  • String, gibt den passenden Namespace-URI zurück, gibt null zurück, wenn er nicht übereinstimmt.

insertBefore

Fügen Sie einen neuen untergeordneten Knoten vor einem vorhandenen untergeordneten Knoten ein

1
2
XmlNode XmlElement.insertBefore(XmlNode newChild,
    XmlNode refChild);

Aufrufparameter:

  • newChild:XmlNode, neuen Knoten einfügen
  • refChild:XmlNode, fügen Sie vor diesem Knoten einen neuen Knoten ein

Rückgabeergebnisse:

  • XmlNode, gibt den neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.

insertAfter

Fügen Sie einen neuen untergeordneten Knoten nach einem vorhandenen untergeordneten Knoten ein

1
2
XmlNode XmlElement.insertAfter(XmlNode newChild,
    XmlNode refChild);

Aufrufparameter:

  • newChild:XmlNode, neuen Knoten einfügen
  • refChild:XmlNode, fügen Sie nach diesem Knoten einen neuen Knoten ein

Rückgabeergebnisse:

  • XmlNode, gibt den neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.

appendChild

Fügt am Ende der Liste der untergeordneten Knoten eines Knotens einen neuen untergeordneten Knoten hinzu

1
XmlNode XmlElement.appendChild(XmlNode newChild);

Aufrufparameter:

  • newChild:XmlNodeGeben Sie den hinzugefügten Knoten an

Rückgabeergebnisse:

  • XmlNode, gibt diesen neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.

replaceChild

Ersetzen Sie einen untergeordneten Knoten durch einen anderen

1
2
XmlNode XmlElement.replaceChild(XmlNode newChild,
    XmlNode oldChild);

Aufrufparameter:

  • newChild:XmlNode, geben Sie den neuen Knoten an
  • oldChild:XmlNode, gibt den zu ersetzenden Knoten an

Rückgabeergebnisse:

  • XmlNodeWenn die Ersetzung erfolgreich ist, kann diese Methode den ersetzten Knoten zurückgeben. Wenn die Ersetzung fehlschlägt, gibt sie null zurück.

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.

removeChild

Entfernen Sie einen Knoten aus der Liste der untergeordneten Knoten

1
XmlNode XmlElement.removeChild(XmlNode oldChild);

Aufrufparameter:

  • oldChild:XmlNode, gibt den zu löschenden Knoten an

Rückgabeergebnisse:

  • XmlNode, Wenn der Löschvorgang erfolgreich ist, kann diese Methode den gelöschten Knoten zurückgeben. Wenn dies fehlschlägt, gibt sie null zurück.

toString

Gibt die Zeichenfolgendarstellung des Objekts zurück. Im Allgemeinen wird „[Native Object]“ zurückgegeben. Das Objekt kann gemäß seinen eigenen Eigenschaften neu implementiert werden.

1
String XmlElement.toString();

Rückgabeergebnisse:

  • String, gibt die Zeichenfolgendarstellung des Objekts zurück

toJSON

Gibt eine Darstellung des Objekts im JSON-Format zurück und gibt im Allgemeinen eine Sammlung lesbarer Eigenschaften zurück, die vom Objekt definiert werden.

1
Value XmlElement.toJSON(String key = "");

Aufrufparameter:

  • key: Zeichenfolge, nicht verwendet

Rückgabeergebnisse:

  • Value, gibt einen Wert zurück, der JSON serialisierbar enthält
© Copyright 2012-2024 fibjs.org | Unterstützen Sie uns