Esta página foi traduzida pela API Cloud Translation.

Class Element

Uma representação de um nó Element XML.

// 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);

Métodos

Método	Tipo de retorno	Breve descrição
`addContent(content)`	`Element`	Anexa o nó especificado como o último filho do nó `Element`.
`addContent(index, content)`	`Element`	Insere o nó especificado no índice especificado entre todos os nós que são filhos imediatos do Nó `Element`.
`cloneContent()`	`Content[]`	Cria cópias não anexadas de todos os nós que são filhos imediatos do nó {@code Element}.
`detach()`	`Content`	Separa o nó do nó pai `Element`.
`getAllContent()`	`Content[]`	Recebe todos os nós que são filhos imediatos do nó {@code Element}.
`getAttribute(name)`	`Attribute`	Recebe o atributo desse nó `Element` com o nome determinado e sem namespace.
`getAttribute(name, namespace)`	`Attribute`	Recebe o atributo desse nó `Element` com o nome e o namespace fornecidos.
`getAttributes()`	`Attribute[]`	Recebe todos os atributos desse nó `Element`, na ordem em que aparecem no documento.
`getChild(name)`	`Element`	Recebe o primeiro nó `Element` com o nome fornecido e nenhum namespace que seja imediato filho desse nó `Element`.
`getChild(name, namespace)`	`Element`	Recebe o primeiro nó `Element` com o nome e o namespace fornecidos que é imediato filho desse nó `Element`.
`getChildText(name)`	`String`	Extrai o valor de texto do nó com o nome indicado e sem namespace, se o nó for um filho imediato do nó `Element`.
`getChildText(name, namespace)`	`String`	Extrai o valor de texto do nó com o nome e o namespace fornecidos, se o nó for um nó imediato filho do nó `Element`.
`getChildren()`	`Element[]`	Recebe todos os nós `Element` que são filhos imediatos deste nó `Element`, no ordem em que elas aparecem no documento.
`getChildren(name)`	`Element[]`	Recebe todos os nós `Element` com o nome fornecido e nenhum namespace que sejam filhos imediatos deste nó `Element`, na ordem em que aparecem no documento.
`getChildren(name, namespace)`	`Element[]`	Recebe todos os nós `Element` com o nome e o namespace fornecidos que são filhos imediatos de este nó `Element`, na ordem em que eles aparecem no documento.
`getContent(index)`	`Content`	Extrai o nó no índice especificado entre todos os nós que são filhos imediatos do {@code Element} .
`getContentSize()`	`Integer`	Recebe o número de nós que são filhos imediatos do nó {@code Element}.
`getDescendants()`	`Content[]`	Recebe todos os nós que são filhos diretos ou indiretos do nó {@code Element}, na ordem em que aparecem no documento.
`getDocument()`	`Document`	Extrai o documento XML que contém o nó {@code Element}.
`getName()`	`String`	Recebe o nome local do nó `Element`.
`getNamespace()`	`Namespace`	Recebe o namespace do nó `Element`.
`getNamespace(prefix)`	`Namespace`	Recebe o namespace com o prefixo fornecido para o nó `Element`.
`getParentElement()`	`Element`	Recebe o nó `Element` pai do nó.
`getQualifiedName()`	`String`	Recebe o nome local e o prefixo do namespace do nó `Element`, no formato `[namespacePrefix]:[localName]`.
`getText()`	`String`	Recebe o valor de texto do nó `Element`.
`getValue()`	`String`	Extrai o valor de texto de todos os nós que são filhos diretos ou indiretos do nó, na ordem como eles aparecem no documento.
`isAncestorOf(other)`	`Boolean`	Determina se esse nó `Element` é um pai direto ou indireto de um determinado nó `Element`.
`isRootElement()`	`Boolean`	Determina se o nó `Element` é o nó raiz do documento.
`removeAttribute(attribute)`	`Boolean`	Remove o atributo fornecido para esse nó `Element`, se esse atributo existir.
`removeAttribute(attributeName)`	`Boolean`	Remove o atributo desse nó `Element` com o nome fornecido e sem namespace, se esse atributo existe.
`removeAttribute(attributeName, namespace)`	`Boolean`	Remove o atributo desse nó `Element` com o nome e namespace fornecidos, se tais um atributo existe.
`removeContent()`	`Content[]`	Remove todos os nós que são filhos imediatos do nó {@code Element}.
`removeContent(content)`	`Boolean`	Remove o nó determinado, se o nó for um filho imediato do nó {@code Element}.
`removeContent(index)`	`Content`	Remove o nó no índice especificado entre todos os nós que são filhos imediatos do {@code Element} .
`setAttribute(attribute)`	`Element`	Define o atributo fornecido para este nó `Element`.
`setAttribute(name, value)`	`Element`	Define o atributo do nó `Element` com o nome, o valor e sem o namespace fornecidos.
`setAttribute(name, value, namespace)`	`Element`	Define o atributo do nó `Element` com o nome, o valor e o namespace fornecidos.
`setName(name)`	`Element`	Define o nome local do nó `Element`.
`setNamespace(namespace)`	`Element`	Define o namespace do nó `Element`.
`setText(text)`	`Element`	Define o valor de texto do nó `Element`.

Documentação detalhada

`addContent(content)`

Anexa o nó especificado como o último filho do nó Element. O content pode ser um objeto Element ou qualquer objeto de nó que corresponda a um tipo listado em ContentType.

Parâmetros

Nome	Tipo	Descrição
`content`	`Content`	o nó que será anexado

Retornar

Element: o nó Element, para encadeamento

`addContent(index, content)`

Insere o nó especificado no índice especificado entre todos os nós que são filhos imediatos do Nó Element. O argumento content pode ser um objeto Element ou qualquer Objeto de nó que corresponde a um tipo listado em ContentType.

Parâmetros

Nome	Tipo	Descrição
`index`	`Integer`	o índice no qual inserir o nó entre todos os nós que são filhos imediatos do nó `Element`
`content`	`Content`	o nó a ser inserido

Retornar

Element: o nó Element, para encadeamento

`cloneContent()`

Cria cópias não anexadas de todos os nós que são filhos imediatos do nó {@code Element}.

Retornar

Content[]: uma matriz de cópias não anexadas de todos os nós que são filhos imediatos do Nó {@code Elemento

`detach()`

Separa o nó do nó pai Element. Se o nó não tiver um pai, esse método não tem efeito.

Retornar

Content: o nó removido

`getAllContent()`

Recebe todos os nós que são filhos imediatos do nó {@code Element}.

Retornar

Content[]: uma matriz de todos os nós que são filhos imediatos do nó {@code Element}

`getAttribute(name)`

Recebe o atributo desse nó Element com o nome determinado e sem namespace. Se houver não existe tal atributo, o método retorna null.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do atributo

Retornar

Attribute: o atributo ou null se não houver um atributo com o nome fornecido e nenhum namespace

`getAttribute(name, namespace)`

Recebe o atributo desse nó Element com o nome e o namespace fornecidos. Se houver nenhum nó assim, esse método retorna null.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do atributo
`namespace`	`Namespace`	o namespace do atributo

Retornar

Attribute: o atributo ou null se não houver um atributo com o nome fornecido e namespace

`getAttributes()`

Recebe todos os atributos desse nó Element, na ordem em que aparecem no documento.

Retornar

Attribute[]: uma matriz de todos os atributos deste nó Element

`getChild(name)`

Recebe o primeiro nó Element com o nome fornecido e nenhum namespace que seja imediato filho desse nó Element. Se não houver esse nó, esse método retornará null.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do nó `Element` filho

Retornar

Element: o nó Element ou null se não houver um nó Element filho imediato com o nome fornecido e nenhum namespace

`getChild(name, namespace)`

Recebe o primeiro nó Element com o nome e o namespace fornecidos que é imediato filho desse nó Element. Se não houver esse nó, esse método retornará null.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do nó `Element` filho
`namespace`	`Namespace`	o namespace do nó filho `Element`

Retornar

Element: o nó Element ou null se não houver um nó Element filho imediato com o nome e o namespace fornecidos

`getChildText(name)`

Extrai o valor de texto do nó com o nome indicado e sem namespace, se o nó for um filho imediato do nó Element. Se não houver esse nó, este método retorna null:

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do nó filho

Retornar

String: o valor do texto do nó filho ou null se não houver um nó filho imediato com o nome determinado e nenhum namespace

`getChildText(name, namespace)`

Extrai o valor de texto do nó com o nome e o namespace fornecidos, se o nó for um nó imediato filho do nó Element. Se não houver esse nó, esse método retornará null.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do nó filho
`namespace`	`Namespace`	o namespace do nó filho

Retornar

String: o valor do texto do nó filho ou null se não houver um nó filho imediato com o nome e namespace fornecidos

`getChildren()`

Recebe todos os nós Element que são filhos imediatos deste nó Element, no ordem em que elas aparecem no documento.

Retornar

Element[]: uma matriz de todos os nós Element que são filhos imediatos desse nó Element

`getChildren(name)`

Recebe todos os nós Element com o nome fornecido e nenhum namespace que sejam filhos imediatos deste nó Element, na ordem em que aparecem no documento.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome dos nós `Element` filhos

Retornar

Element[]: uma matriz de todos os nós Element com o nome informado e nenhum namespace que seja filhos imediatos deste nó Element

`getChildren(name, namespace)`

Recebe todos os nós Element com o nome e o namespace fornecidos que são filhos imediatos de este nó Element, na ordem em que eles aparecem no documento.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome dos nós `Element` filhos
`namespace`	`Namespace`	o namespace dos nós `Element` filhos

Retornar

Element[]: uma matriz de todos os nós Element com o nome e o namespace informados que são filhos imediatos deste nó Element

`getContent(index)`

Extrai o nó no índice especificado entre todos os nós que são filhos imediatos do {@code Element} . Se não houver nó no índice especificado, esse método retornará null.

Parâmetros

Nome	Tipo	Descrição
`index`	`Integer`	o índice do nó entre todos os nós que são filhos imediatos do Nó {@code Elemento

Retornar

Content: o nó ou null se não houver nó no índice especificado

`getContentSize()`

Recebe o número de nós que são filhos imediatos do nó {@code Element}.

Retornar

Integer: o número de nós que são filhos imediatos do nó {@code Element}

`getDescendants()`

Recebe todos os nós que são filhos diretos ou indiretos do nó {@code Element}, na ordem em que aparecem no documento.

Retornar

Content[]: uma matriz de todos os nós que são filhos diretos ou indiretos do nó {@code Element}

`getDocument()`

Extrai o documento XML que contém o nó {@code Element}.

Retornar

Document: o documento que contém o nó {@code Element}

`getName()`

Recebe o nome local do nó Element. Se o nó tiver um prefixo de namespace, use getQualifiedName() ou getNamespace().getPrefix() a obter o prefixo.

Retornar

String: o nome local do nó Element

`getNamespace()`

Recebe o namespace do nó Element.

Retornar

Namespace: o namespace do nó Element

`getNamespace(prefix)`

Recebe o namespace com o prefixo fornecido para o nó Element.

Parâmetros

Nome	Tipo	Descrição
`prefix`	`String`	o prefixo do namespace

Retornar

Namespace: o namespace com o prefixo fornecido para o nó Element

`getParentElement()`

Recebe o nó Element pai do nó. Se o nó não tiver um pai, esse método retorna null.

Retornar

Element: o nó Element pai

`getQualifiedName()`

Recebe o nome local e o prefixo do namespace do nó Element, no formato [namespacePrefix]:[localName]. Se o nó não tiver um prefixo de namespace, use getName().

Retornar

String: o nome local e o prefixo do namespace do nó Element, no formato [namespacePrefix]:[localName]

`getText()`

Recebe o valor de texto do nó Element.

Retornar

String: o valor do texto do nó Element.

`getValue()`

Extrai o valor de texto de todos os nós que são filhos diretos ou indiretos do nó, na ordem como eles aparecem no documento.

Retornar

String: o valor do texto de todos os nós que são filhos diretos ou indiretos do nó

`isAncestorOf(other)`

Determina se esse nó Element é um pai direto ou indireto de um determinado nó Element.

Parâmetros

Nome	Tipo	Descrição
`other`	`Element`	o outro nó `Element`

Retornar

Boolean: true se esse nó Element for um pai direto ou indireto do nó Element; false se não for

`isRootElement()`

Determina se o nó Element é o nó raiz do documento.

Retornar

Boolean: true se o nó Element for o nó raiz do documento. false se não

`removeAttribute(attribute)`

Remove o atributo fornecido para esse nó Element, se esse atributo existir.

Parâmetros

Nome	Tipo	Descrição
`attribute`	`Attribute`	o atributo

Retornar

Boolean: true se o atributo existiu e tiver sido removido. false se não for

`removeAttribute(attributeName)`

Remove o atributo desse nó Element com o nome fornecido e sem namespace, se esse atributo existe.

Parâmetros

Nome	Tipo	Descrição
`attributeName`	`String`	o nome do atributo

Retornar

Boolean: true se o atributo existiu e tiver sido removido. false se não for

`removeAttribute(attributeName, namespace)`

Remove o atributo desse nó Element com o nome e namespace fornecidos, se tais um atributo existe.

Parâmetros

Nome	Tipo	Descrição
`attributeName`	`String`	o nome do atributo
`namespace`	`Namespace`	o namespace do atributo

Retornar

Boolean: true se o atributo existiu e tiver sido removido. false se não for

`removeContent()`

Remove todos os nós que são filhos imediatos do nó {@code Element}.

Retornar

Content[]: uma matriz de todos os nós que eram filhos imediatos do nó {@code Element} antes deles foram removidos

`removeContent(content)`

Remove o nó determinado, se o nó for um filho imediato do nó {@code Element}. O argumento content pode ser um objeto Element ou qualquer objeto de nó que corresponda a uma tipo listado em ContentType.

Parâmetros

Nome	Tipo	Descrição
`content`	`Content`	o nó a ser removido

Retornar

Boolean: true se o nó era um filho imediato e foi removido. false se não for

`removeContent(index)`

Remove o nó no índice especificado entre todos os nós que são filhos imediatos do {@code Element} . Se não houver nó no índice especificado, esse método retornará null.

Parâmetros

Nome	Tipo	Descrição
`index`	`Integer`	o índice do nó entre todos os nós que são filhos imediatos do Nó {@code Elemento

Retornar

Content: o nó que foi removido, ou null se não houver nenhum nó no índice especificado

`setAttribute(attribute)`

Define o atributo fornecido para este nó Element.

Parâmetros

Nome	Tipo	Descrição
`attribute`	`Attribute`	o atributo a ser definido

Retornar

Element: o nó Element, para encadeamento

`setAttribute(name, value)`

Define o atributo do nó Element com o nome, o valor e sem o namespace fornecidos.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do atributo a ser definido
`value`	`String`	o valor do atributo a ser definido

Retornar

Element: o nó Element, para encadeamento

`setAttribute(name, value, namespace)`

Define o atributo do nó Element com o nome, o valor e o namespace fornecidos.

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome do atributo a ser definido
`value`	`String`	o valor do atributo a ser definido
`namespace`	`Namespace`	o namespace do atributo a ser definido

Retornar

Element: o nó Element, para encadeamento

`setName(name)`

Define o nome local do nó Element. Para definir um prefixo de namespace para o nó, use setNamespace(namespace) em conjunto com XmlService.getNamespace(prefix, uri).

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	o nome local a ser definido

Retornar

Element: o nó Element, para encadeamento

`setNamespace(namespace)`

Define o namespace do nó Element.

Parâmetros

Nome	Tipo	Descrição
`namespace`	`Namespace`	o namespace a ser definido

Retornar

Element: o nó Element, para encadeamento

`setText(text)`

Define o valor de texto do nó Element. Se o nó já tiver um valor de texto ou qualquer nó filho, esse método substitui o conteúdo antigo. Para anexar ou inserir conteúdo, faça o seguinte: use addContent(content) ou addContent(index, content).

Parâmetros

Nome	Tipo	Descrição
`text`	`String`	o texto a ser definido

Retornar

Element: o nó Element, para encadeamento