Class Element

Element

Reprezentacja węzła XML Element.

// Adds up the values listed in a sample XML document and adds a new element with the total.
var xml = '<things>'
    + '<plates>12</plates>'
    + '<bowls>18</bowls>'
    + '<cups>25</cups>'
    + '</things>';
var document = XmlService.parse(xml);
var root = document.getRootElement();
var items = root.getChildren();
var total = 0;
for (var i = 0; i < items.length; i++) {
  total += Number(items[i].getText());
}
var totalElement = XmlService.createElement('total').setText(total);
root.addContent(totalElement);
xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

Metody

MetodaZwracany typKrótki opis
addContent(content)ElementDołącza podany węzeł jako ostatni węzeł podrzędny węzła Element.
addContent(index, content)ElementWstawia dany węzeł w danym indeksie wśród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi Element węzeł.
cloneContent()Content[]Tworzy niedołączone kopie wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}.
detach()ContentOdłącza węzeł od jego nadrzędnego węzła Element.
getAllContent()Content[]Pobiera wszystkie węzły, które są bezpośrednimi węzłami podrzędnymi węzła {@code Element}.
getAttribute(name)AttributePobiera atrybut tego węzła Element o podanej nazwie i bez przestrzeni nazw.
getAttribute(name, namespace)AttributePobiera atrybut tego węzła Element o podanej nazwie i przestrzeni nazw.
getAttributes()Attribute[]Pobiera wszystkie atrybuty tego węzła Element w kolejności, w jakiej występują w dokumencie.
getChild(name)ElementPobiera pierwszy węzeł Element o podanej nazwie i nie ma przestrzeni nazw, która jest natychmiastowa element podrzędny tego węzła Element.
getChild(name, namespace)ElementPobiera pierwszy węzeł Element o podanej nazwie i przestrzeni nazw, która jest natychmiastowa element podrzędny tego węzła Element.
getChildText(name)StringPobiera wartość tekstową węzła o podanej nazwie i bez przestrzeni nazw, jeśli węzeł jest bezpośredniego elementu podrzędnego węzła Element.
getChildText(name, namespace)StringPobiera wartość tekstową węzła o podanej nazwie i przestrzeni nazw, jeśli węzeł jest bezpośrednim elementu podrzędnego węzła Element.
getChildren()Element[]Pobiera wszystkie węzły Element, które są bezpośrednimi węzłami podrzędnymi tego węzła Element, w w kolejności ich wyświetlania w dokumencie.
getChildren(name)Element[]Pobiera wszystkie węzły (Element) o podanej nazwie i nie ma przestrzeni nazw, które są bezpośrednimi elementami podrzędnymi tego węzła Element w kolejności, w jakiej występują w dokumencie.
getChildren(name, namespace)Element[]Pobiera wszystkie węzły (Element) o podanej nazwie i przestrzeni nazw, które są bezpośrednimi elementami podrzędnymi instancji w tym węźle Element w kolejności, w jakiej występują w dokumencie.
getContent(index)ContentPobiera węzeł o danym indeksie wśród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi Węzeł {@code Element}.
getContentSize()IntegerPobiera liczbę węzłów, które są bezpośrednimi węzłami podrzędnymi węzła {@code Element}.
getDescendants()Content[]Pobiera wszystkie węzły, które są bezpośrednimi lub pośrednimi podrzędnymi węzłami węzła {@code Element}, w kolejności widoczne w dokumencie.
getDocument()DocumentPobiera dokument XML zawierający węzeł {@code Element}.
getName()StringPobiera lokalną nazwę węzła Element.
getNamespace()NamespacePobiera przestrzeń nazw węzła Element.
getNamespace(prefix)NamespacePobiera przestrzeń nazw z podanym prefiksem węzła Element.
getParentElement()ElementPobiera nadrzędny węzeł Element węzła.
getQualifiedName()StringPobiera nazwę lokalną i prefiks przestrzeni nazw węzła Element w formacie [namespacePrefix]:[localName].
getText()StringPobiera wartość tekstową węzła Element.
getValue()StringPobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi elementami podrzędnymi danego węzła, w kolejności w dokumencie.
isAncestorOf(other)BooleanOkreśla, czy ten węzeł Element jest bezpośrednim czy pośrednim nadrzędnym danego węzła Element.
isRootElement()BooleanOkreśla, czy węzeł Element jest węzłem głównym dokumentu.
removeAttribute(attribute)BooleanUsuwa dany atrybut dla tego węzła Element, jeśli taki atrybut istnieje.
removeAttribute(attributeName)BooleanUsuwa atrybut tego węzła Element o podanej nazwie i nie ma przestrzeni nazw, jeśli taki atrybut istnieje.
removeAttribute(attributeName, namespace)BooleanUsuwa atrybut tego węzła Element o danej nazwie i przestrzeni nazw, jeśli tak atrybut istnieje.
removeContent()Content[]Usuwa wszystkie węzły, które są bezpośrednimi węzłami podrzędnymi węzła {@code Element}.
removeContent(content)BooleanUsuwa dany węzeł, jeśli jest on bezpośrednim elementem podrzędnym węzła {@code Element}.
removeContent(index)ContentUsuwa węzeł w danym indeksie spośród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi Węzeł {@code Element}.
setAttribute(attribute)ElementUstawia podany atrybut dla tego węzła Element.
setAttribute(name, value)ElementUstawia atrybut tego węzła Element o podanej nazwie, wartości i bez przestrzeni nazw.
setAttribute(name, value, namespace)ElementUstawia atrybut tego węzła Element o podanej nazwie, wartości i przestrzeni nazw.
setName(name)ElementUstawia lokalną nazwę węzła Element.
setNamespace(namespace)ElementUstawia przestrzeń nazw węzła Element.
setText(text)ElementUstawia wartość tekstową węzła Element.

Szczegółowa dokumentacja

addContent(content)

Dołącza podany węzeł jako ostatni węzeł podrzędny węzła Element. content może być obiektem Element lub dowolnym obiektem węzła odpowiadającym typowi znajduje się w lokalizacji ContentType.

Parametry

NazwaTypOpis
contentContentwęzeł do dołączenia

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;


addContent(index, content)

Wstawia dany węzeł w danym indeksie wśród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi Element węzeł. Argumentem content może być obiekt Element lub dowolny obiekt węzła odpowiadający typowi wymienionemu w tabeli ContentType.

Parametry

NazwaTypOpis
indexIntegerindeks, w którym ma zostać wstawiony węzeł wśród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi węzła Element
contentContentwęzeł do wstawienia

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;


cloneContent()

Tworzy niedołączone kopie wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}.

Powrót

Content[] – tablica niedołączonych kopii wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła Węzeł {@code Element}


detach()

Odłącza węzeł od jego nadrzędnego węzła Element. Jeśli węzeł nie ma elementu nadrzędnego, ta metoda nie ma żadnego efektu.

Powrót

Content – odłączony węzeł,


getAllContent()

Pobiera wszystkie węzły, które są bezpośrednimi węzłami podrzędnymi węzła {@code Element}.

Powrót

Content[] – tablica wszystkich węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}.


getAttribute(name)

Pobiera atrybut tego węzła Element o podanej nazwie i bez przestrzeni nazw. Jeśli nie ma takiego atrybutu, ta metoda zwraca null.

Parametry

NazwaTypOpis
nameStringnazwa atrybutu

Powrót

Attribute – atrybut lub null, jeśli nie ma atrybutu o danej nazwie i nie; przestrzeń nazw


getAttribute(name, namespace)

Pobiera atrybut tego węzła Element o podanej nazwie i przestrzeni nazw. Jeśli nie ma takiego węzła, ta metoda zwraca null.

Parametry

NazwaTypOpis
nameStringnazwa atrybutu
namespaceNamespaceprzestrzeń nazw atrybutu

Powrót

Attribute – atrybut lub null, jeśli nie ma atrybutu o danej nazwie i przestrzeń nazw


getAttributes()

Pobiera wszystkie atrybuty tego węzła Element w kolejności, w jakiej występują w dokumencie.

Powrót

Attribute[] – tablica wszystkich atrybutów dla tego węzła Element


getChild(name)

Pobiera pierwszy węzeł Element o podanej nazwie i nie ma przestrzeni nazw, która jest natychmiastowa element podrzędny tego węzła Element. Jeśli nie ma takiego węzła, ta metoda zwraca null.

Parametry

NazwaTypOpis
nameStringnazwa węzła podrzędnego Element

Powrót

Element – węzeł Element lub null, jeśli nie ma natychmiastowego węzła podrzędnego Element o danej nazwie i przestrzeni nazw;


getChild(name, namespace)

Pobiera pierwszy węzeł Element o podanej nazwie i przestrzeni nazw, która jest natychmiastowa element podrzędny tego węzła Element. Jeśli nie ma takiego węzła, ta metoda zwraca null.

Parametry

NazwaTypOpis
nameStringnazwa węzła podrzędnego Element
namespaceNamespaceprzestrzeń nazw węzła podrzędnego Element

Powrót

Element – węzeł Element lub null, jeśli nie ma natychmiastowego węzła podrzędnego Element o danej nazwie i przestrzeni nazw;


getChildText(name)

Pobiera wartość tekstową węzła o podanej nazwie i bez przestrzeni nazw, jeśli węzeł jest bezpośredniego elementu podrzędnego węzła Element. Jeśli nie ma takiego węzła, ta metoda zwraca null

Parametry

NazwaTypOpis
nameStringnazwa węzła podrzędnego

Powrót

String – wartość tekstowa węzła podrzędnego lub null, jeśli nie ma bezpośredniego węzła podrzędnego; z podaną nazwą i bez przestrzeni nazw


getChildText(name, namespace)

Pobiera wartość tekstową węzła o podanej nazwie i przestrzeni nazw, jeśli węzeł jest bezpośrednim elementu podrzędnego węzła Element. Jeśli nie ma takiego węzła, ta metoda zwraca null.

Parametry

NazwaTypOpis
nameStringnazwa węzła podrzędnego
namespaceNamespaceprzestrzeń nazw węzła podrzędnego

Powrót

String – wartość tekstowa węzła podrzędnego lub null, jeśli nie ma bezpośredniego węzła podrzędnego; o podanej nazwie i przestrzeni nazw


getChildren()

Pobiera wszystkie węzły Element, które są bezpośrednimi węzłami podrzędnymi tego węzła Element, w w kolejności ich wyświetlania w dokumencie.

Powrót

Element[] – tablica wszystkich Element węzłów, które są bezpośrednimi elementami podrzędnymi tego węzła Element.


getChildren(name)

Pobiera wszystkie węzły (Element) o podanej nazwie i nie ma przestrzeni nazw, które są bezpośrednimi elementami podrzędnymi tego węzła Element w kolejności, w jakiej występują w dokumencie.

Parametry

NazwaTypOpis
nameStringnazwa Element węzła podrzędnego

Powrót

Element[] – tablica wszystkich Element węzłów o podanej nazwie i bez przestrzeni nazw, które są bezpośrednie elementy podrzędne tego węzła Element


getChildren(name, namespace)

Pobiera wszystkie węzły (Element) o podanej nazwie i przestrzeni nazw, które są bezpośrednimi elementami podrzędnymi instancji w tym węźle Element w kolejności, w jakiej występują w dokumencie.

Parametry

NazwaTypOpis
nameStringnazwa Element węzła podrzędnego
namespaceNamespaceprzestrzeń nazw Element węzłów podrzędnych

Powrót

Element[] – tablica wszystkich Element węzłów o podanej nazwie i przestrzeni nazw, które są bezpośrednie elementy podrzędne tego węzła Element


getContent(index)

Pobiera węzeł o danym indeksie wśród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi Węzeł {@code Element}. Jeśli pod danym indeksem nie ma węzła, ta metoda zwraca null.

Parametry

NazwaTypOpis
indexIntegerindeks węzła wśród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi węzła Węzeł {@code Element}

Powrót

Content – węzeł lub null, jeśli w danym indeksie nie ma węzła;


getContentSize()

Pobiera liczbę węzłów, które są bezpośrednimi węzłami podrzędnymi węzła {@code Element}.

Powrót

Integer – liczba węzłów, które są bezpośrednimi elementami podrzędnymi węzła {@code Element}.


getDescendants()

Pobiera wszystkie węzły, które są bezpośrednimi lub pośrednimi podrzędnymi węzłami węzła {@code Element}, w kolejności widoczne w dokumencie.

Powrót

Content[] – tablica wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzłami węzła {@code Element}


getDocument()

Pobiera dokument XML zawierający węzeł {@code Element}.

Powrót

Document – dokument zawierający węzeł {@code Element}


getName()

Pobiera lokalną nazwę węzła Element. Jeśli węzeł ma prefiks przestrzeni nazw, użyj getQualifiedName() lub getNamespace().getPrefix() do pobierz prefiks.

Powrót

String – lokalna nazwa węzła Element,


getNamespace()

Pobiera przestrzeń nazw węzła Element.

Powrót

Namespace – przestrzeń nazw węzła Element,


getNamespace(prefix)

Pobiera przestrzeń nazw z podanym prefiksem węzła Element.

Parametry

NazwaTypOpis
prefixStringprefiks przestrzeni nazw

Powrót

Namespace – przestrzeń nazw z podanym prefiksem węzła Element,


getParentElement()

Pobiera nadrzędny węzeł Element węzła. Jeśli węzeł nie ma elementu nadrzędnego, ta metoda zwraca null.

Powrót

Element – nadrzędny węzeł Element.


getQualifiedName()

Pobiera nazwę lokalną i prefiks przestrzeni nazw węzła Element w formacie [namespacePrefix]:[localName]. Jeśli węzeł nie ma prefiksu przestrzeni nazw, użyj getName().

Powrót

String – nazwa lokalna i prefiks przestrzeni nazw węzła Element w formacie [namespacePrefix]:[localName];


getText()

Pobiera wartość tekstową węzła Element.

Powrót

String – wartość tekstowa węzła Element,


getValue()

Pobiera wartość tekstową wszystkich węzłów, które są bezpośrednimi lub pośrednimi elementami podrzędnymi danego węzła, w kolejności w dokumencie.

Powrót

String – wartość tekstowa wszystkich węzłów, które są bezpośrednimi lub pośrednimi podrzędnymi węzłami;


isAncestorOf(other)

Określa, czy ten węzeł Element jest bezpośrednim czy pośrednim nadrzędnym danego węzła Element.

Parametry

NazwaTypOpis
otherElementdrugi węzeł Element

Powrót

Booleantrue, jeśli ten węzeł Element jest bezpośrednim lub pośrednim nadrzędnym wobec danego Element węzeł; false, jeśli nie


isRootElement()

Określa, czy węzeł Element jest węzłem głównym dokumentu.

Powrót

Booleantrue, jeśli węzeł Element jest węzłem głównym dokumentu; false, jeśli nie


removeAttribute(attribute)

Usuwa dany atrybut dla tego węzła Element, jeśli taki atrybut istnieje.

Parametry

NazwaTypOpis
attributeAttributeatrybut

Powrót

Booleantrue, jeśli atrybut istniał i został usunięty; false, jeśli nie


removeAttribute(attributeName)

Usuwa atrybut tego węzła Element o podanej nazwie i nie ma przestrzeni nazw, jeśli taki atrybut istnieje.

Parametry

NazwaTypOpis
attributeNameStringnazwa atrybutu

Powrót

Booleantrue, jeśli atrybut istniał i został usunięty; false, jeśli nie


removeAttribute(attributeName, namespace)

Usuwa atrybut tego węzła Element o danej nazwie i przestrzeni nazw, jeśli tak atrybut istnieje.

Parametry

NazwaTypOpis
attributeNameStringnazwa atrybutu
namespaceNamespaceprzestrzeń nazw atrybutu

Powrót

Booleantrue, jeśli atrybut istniał i został usunięty; false, jeśli nie


removeContent()

Usuwa wszystkie węzły, które są bezpośrednimi węzłami podrzędnymi węzła {@code Element}.

Powrót

Content[] – tablica wszystkich węzłów, które były bezpośrednimi elementami podrzędnymi węzła {@code Element}, zanim zostały zostały usunięte


removeContent(content)

Usuwa dany węzeł, jeśli jest on bezpośrednim elementem podrzędnym węzła {@code Element}. Argument content może być obiektem Element lub dowolnym obiektem węzła odpowiadającym typu wymienionego w tabeli ContentType.

Parametry

NazwaTypOpis
contentContentwęzeł do usunięcia

Powrót

Booleantrue, jeśli węzeł był bezpośrednim elementem podrzędnym i został usunięty; false, jeśli nie


removeContent(index)

Usuwa węzeł w danym indeksie spośród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi Węzeł {@code Element}. Jeśli pod danym indeksem nie ma węzła, ta metoda zwraca null.

Parametry

NazwaTypOpis
indexIntegerindeks węzła wśród wszystkich węzłów, które są bezpośrednimi węzłami podrzędnymi węzła Węzeł {@code Element}

Powrót

Content – węzeł, który został usunięty, lub null, jeśli nie ma węzła w danym indeksie.


setAttribute(attribute)

Ustawia podany atrybut dla tego węzła Element.

Parametry

NazwaTypOpis
attributeAttributeatrybut do ustawienia

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;


setAttribute(name, value)

Ustawia atrybut tego węzła Element o podanej nazwie, wartości i bez przestrzeni nazw.

Parametry

NazwaTypOpis
nameStringnazwa atrybutu do ustawienia
valueStringwartość atrybutu do ustawienia

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;


setAttribute(name, value, namespace)

Ustawia atrybut tego węzła Element o podanej nazwie, wartości i przestrzeni nazw.

Parametry

NazwaTypOpis
nameStringnazwa atrybutu do ustawienia
valueStringwartość atrybutu do ustawienia
namespaceNamespaceprzestrzeń nazw atrybutu do ustawienia

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;


setName(name)

Ustawia lokalną nazwę węzła Element. Aby ustawić prefiks przestrzeni nazw węzła, użyj setNamespace(namespace) w połączeniu z XmlService.getNamespace(prefix, uri).

Parametry

NazwaTypOpis
nameStringlokalną nazwę, którą chcesz ustawić

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;


setNamespace(namespace)

Ustawia przestrzeń nazw węzła Element.

Parametry

NazwaTypOpis
namespaceNamespaceprzestrzeń nazw do ustawienia

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;


setText(text)

Ustawia wartość tekstową węzła Element. Jeśli węzeł zawiera już wartość tekstową lub wszystkich węzłów podrzędnych, ta metoda zastępuje starą zawartość. Aby zamiast tego dołączyć lub wstawić treść: użyj właściwości addContent(content) lub addContent(index, content).

Parametry

NazwaTypOpis
textStringtekst do ustawienia

Powrót

Element – węzeł Element używany do tworzenia łańcuchów;