이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class Element

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

메서드

메서드	반환 유형	간략한 설명
`addContent(content)`	`Element`	지정된 노드를 `Element` 노드의 마지막 하위 요소로 추가합니다.
`addContent(index, content)`	`Element`	지정된 노드의 `Element` 노드의 바로 하위 노드인 모든 노드 간에 지정된 노드를 삽입합니다.
`cloneContent()`	`Content[]`	{@code 요소} 노드의 바로 하위 노드인 모든 노드의 연결되지 않은 사본을 만듭니다.
`detach()`	`Content`	상위 `Element` 노드에서 노드를 분리합니다.
`getAllContent()`	`Content[]`	{@code Element} 노드의 바로 하위 노드인 모든 노드를 가져옵니다.
`getAttribute(name)`	`Attribute`	네임스페이스가 아닌 지정된 이름으로 이 `Element` 노드의 속성을 가져옵니다.
`getAttribute(name, namespace)`	`Attribute`	지정된 이름과 네임스페이스로 이 `Element` 노드의 속성을 가져옵니다.
`getAttributes()`	`Attribute[]`	이 `Element` 노드의 모든 속성을 문서에 표시되는 순서대로 가져옵니다.
`getChild(name)`	`Element`	지정된 이름의 첫 번째 `Element` 노드를 가져오고 이 `Element` 노드의 직계 하위인 네임스페이스를 가져오지 않습니다.
`getChild(name, namespace)`	`Element`	이 `Element` 노드의 직계 하위 요소인 지정된 이름과 네임스페이스를 가진 첫 번째 `Element` 노드를 가져옵니다.
`getChildText(name)`	`String`	노드가 `Element` 노드의 하위 노드인 경우 지정된 이름이 없는 노드의 텍스트 값을 가져옵니다.
`getChildText(name, namespace)`	`String`	노드가 `Element` 노드의 직계 하위 요소인 경우 지정된 이름과 네임스페이스가 있는 노드의 텍스트 값을 가져옵니다.
`getChildren()`	`Element[]`	이 `Element` 노드의 바로 하위 노드인 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getChildren(name)`	`Element[]`	지정된 이름의 모든 `Element` 노드를 가져오고 이 `Element` 노드의 바로 하위 요소인 네임스페이스를 문서에 표시되는 순서대로 가져옵니다.
`getChildren(name, namespace)`	`Element[]`	이 `Element` 노드의 직계 하위 요소인 지정된 이름과 네임스페이스를 가진 모든 `Element` 노드를 문서에 표시되는 순서대로 가져옵니다.
`getContent(index)`	`Content`	{@code Element} 노드의 바로 하위 노드인 모든 노드 간에 지정된 색인의 노드를 가져옵니다.
`getContentSize()`	`Integer`	{@code Element} 노드의 바로 하위 노드인 노드 수를 가져옵니다.
`getDescendants()`	`Content[]`	{@code Element} 노드의 직접 또는 간접 하위 노드를 문서에 표시되는 순서대로 모두 가져옵니다.
`getDocument()`	`Document`	{@code 요소} 노드가 포함된 XML 문서를 가져옵니다.
`getName()`	`String`	`Element` 노드의 로컬 이름을 가져옵니다.
`getNamespace()`	`Namespace`	`Element` 노드의 네임스페이스를 가져옵니다.
`getNamespace(prefix)`	`Namespace`	`Element` 노드에 지정된 접두사가 있는 네임스페이스를 가져옵니다.
`getParentElement()`	`Element`	노드의 상위 `Element` 노드를 가져옵니다.
`getQualifiedName()`	`String`	`Element` 노드의 로컬 이름 및 네임스페이스 프리픽스를 `[namespacePrefix]:[localName]` 형식으로 가져옵니다.
`getText()`	`String`	`Element` 노드의 텍스트 값을 가져옵니다.
`getValue()`	`String`	노드의 직접 또는 간접 하위 요소인 모든 노드의 텍스트 값을 문서에 표시되는 순서대로 가져옵니다.
`isAncestorOf(other)`	`Boolean`	이 `Element` 노드가 지정된 `Element` 노드의 직접 또는 간접 상위 항목인지 확인합니다.
`isRootElement()`	`Boolean`	`Element` 노드가 문서의 루트 노드인지 확인합니다.
`removeAttribute(attribute)`	`Boolean`	이 `Element` 노드에 해당 속성이 있으면 이 속성을 삭제합니다.
`removeAttribute(attributeName)`	`Boolean`	지정된 이름이 있고 이 네임스페이스가 있는 경우 네임스페이스가 없는 `Element` 노드의 속성을 삭제합니다.
`removeAttribute(attributeName, namespace)`	`Boolean`	지정된 이름과 네임스페이스가 있는 경우 이 `Element` 노드의 속성을 삭제합니다.
`removeContent()`	`Content[]`	{@code Element} 노드의 바로 아래에 있는 하위 노드를 모두 제거합니다.
`removeContent(content)`	`Boolean`	노드가 {@code 요소} 노드의 직계 하위 노드인 경우 지정된 노드를 삭제합니다.
`removeContent(index)`	`Content`	지정된 색인에서 {@code Element} 노드의 바로 하위 노드인 모든 노드 간에 노드를 삭제합니다.
`setAttribute(attribute)`	`Element`	이 `Element` 노드에 지정된 속성을 설정합니다.
`setAttribute(name, value)`	`Element`	지정된 이름, 값, 네임스페이스 없이 이 `Element` 노드의 속성을 설정합니다.
`setAttribute(name, value, namespace)`	`Element`	지정된 이름, 값, 네임스페이스로 이 `Element` 노드의 속성을 설정합니다.
`setName(name)`	`Element`	`Element` 노드의 로컬 이름을 설정합니다.
`setNamespace(namespace)`	`Element`	`Element` 노드의 네임스페이스를 설정합니다.
`setText(text)`	`Element`	`Element` 노드의 텍스트 값을 설정합니다.

자세한 문서

`addContent(content)`

지정된 노드를 Element 노드의 마지막 하위 요소로 추가합니다. content 인수는 Element 객체이거나 ContentType에 나열된 유형에 해당하는 노드 객체일 수 있습니다.

매개변수

이름	유형	설명
`content`	`Content`	추가할 노드

Return

Element — 체이닝용 Element 노드

`addContent(index, content)`

지정된 노드의 Element 노드의 바로 하위 노드인 모든 노드 간에 지정된 노드를 삽입합니다. content 인수는 Element 객체이거나 ContentType에 나열된 유형에 해당하는 노드 객체일 수 있습니다.

매개변수

이름	유형	설명
`index`	`Integer`	`Element` 노드의 바로 하위 노드인 모든 노드 간에 노드를 삽입할 색인입니다.
`content`	`Content`	삽입할 노드

Return

Element — 체이닝용 Element 노드

`cloneContent()`

{@code 요소} 노드의 바로 하위 노드인 모든 노드의 연결되지 않은 사본을 만듭니다.

Return

Content[] — {@code Element} 노드의 즉시 하위 요소인 모든 노드의 연결되지 않은 사본 배열입니다.

`detach()`

상위 Element 노드에서 노드를 분리합니다. 노드에 상위 항목이 없으면 이 메서드는 적용되지 않습니다.

Return

Content — 분리된 노드

`getAllContent()`

{@code Element} 노드의 바로 하위 노드인 모든 노드를 가져옵니다.

Return

Content[] — {@code Element} 노드의 바로 하위 노드인 모든 노드의 배열입니다.

`getAttribute(name)`

네임스페이스가 아닌 지정된 이름으로 이 Element 노드의 속성을 가져옵니다. 이러한 속성이 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	속성 이름

Return

Attribute: 속성 또는 해당 이름을 사용하는 속성이 없고 네임스페이스도 없는 경우 null입니다.

`getAttribute(name, namespace)`

지정된 이름과 네임스페이스로 이 Element 노드의 속성을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	속성 이름
`namespace`	`Namespace`	속성의 네임스페이스입니다.

Return

Attribute: 속성 또는 해당 이름과 네임스페이스의 속성이 없는 경우 null

`getAttributes()`

이 Element 노드의 모든 속성을 문서에 표시되는 순서대로 가져옵니다.

Return

Attribute[]: 이 Element 노드의 모든 속성 배열

`getChild(name)`

지정된 이름의 첫 번째 Element 노드를 가져오고 이 Element 노드의 직계 하위인 네임스페이스를 가져오지 않습니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름

Return

Element: Element 노드 또는 해당 이름을 사용하는 즉각적인 하위 Element 노드가 없고 네임스페이스가 없는 경우 null입니다.

`getChild(name, namespace)`

이 Element 노드의 직계 하위 요소인 지정된 이름과 네임스페이스를 가진 첫 번째 Element 노드를 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름
`namespace`	`Namespace`	하위 `Element` 노드의 네임스페이스

Return

Element: Element 노드 또는 지정된 이름과 네임스페이스가 있는 바로 아래 하위 노드 Element이 없는 경우 null입니다.

`getChildText(name)`

노드가 Element 노드의 하위 노드인 경우 지정된 이름이 없는 노드의 텍스트 값을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 노드의 이름

Return

String: 하위 노드의 텍스트 값입니다. 이름이 지정된 네임스페이스가 즉시 있는 하위 노드가 없으면 null입니다.

`getChildText(name, namespace)`

노드가 Element 노드의 직계 하위 요소인 경우 지정된 이름과 네임스페이스가 있는 노드의 텍스트 값을 가져옵니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`name`	`String`	하위 노드의 이름
`namespace`	`Namespace`	하위 노드의 네임스페이스입니다.

Return

String: 하위 노드의 텍스트 값입니다. 지정된 이름과 네임스페이스가 있는 즉시 하위 노드가 없으면 null입니다.

`getChildren()`

이 Element 노드의 바로 하위 노드인 모든 Element 노드를 문서에 표시되는 순서대로 가져옵니다.

Return

Element[]: 이 Element 노드의 바로 하위 요소인 모든 Element 노드의 배열입니다.

`getChildren(name)`

지정된 이름의 모든 Element 노드를 가져오고 이 Element 노드의 바로 하위 요소인 네임스페이스를 문서에 표시되는 순서대로 가져옵니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름

Return

Element[] - 지정된 이름을 사용하고 이 Element 노드의 바로 하위 요소인 네임스페이스가 없는 모든 Element 노드의 배열입니다.

`getChildren(name, namespace)`

이 Element 노드의 직계 하위 요소인 지정된 이름과 네임스페이스를 가진 모든 Element 노드를 문서에 표시되는 순서대로 가져옵니다.

매개변수

이름	유형	설명
`name`	`String`	하위 `Element` 노드의 이름
`namespace`	`Namespace`	하위 `Element` 노드의 네임스페이스

Return

Element[]: 이 Element 노드의 바로 하위 요소인 지정된 이름과 네임스페이스를 가진 모든 Element 노드의 배열입니다.

`getContent(index)`

{@code Element} 노드의 바로 하위 노드인 모든 노드 간에 지정된 색인의 노드를 가져옵니다. 지정된 색인에 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`index`	`Integer`	{@code 요소} 노드의 바로 하위 노드인 모든 노드의 노드 색인입니다.

Return

Content: 노드 또는 지정된 색인에 노드가 없는 경우 null입니다.

`getContentSize()`

{@code Element} 노드의 바로 하위 노드인 노드 수를 가져옵니다.

Return

Integer — {@code Element} 노드의 바로 하위 노드인 노드 수입니다.

`getDescendants()`

{@code Element} 노드의 직접 또는 간접 하위 노드를 문서에 표시되는 순서대로 모두 가져옵니다.

Return

Content[]: {@code Element} 노드의 직접 또는 간접 하위 요소인 모든 노드의 배열입니다.

`getDocument()`

{@code 요소} 노드가 포함된 XML 문서를 가져옵니다.

Return

Document — {@code 요소} 노드가 포함된 문서

`getName()`

Element 노드의 로컬 이름을 가져옵니다. 노드에 네임스페이스 프리픽스가 있는 경우 getQualifiedName() 또는 getNamespace()를 사용합니다.getPrefix(): 프리픽스를 가져옵니다.

Return

String — Element 노드의 로컬 이름

`getNamespace()`

Element 노드의 네임스페이스를 가져옵니다.

Return

Namespace: Element 노드의 네임스페이스

`getNamespace(prefix)`

Element 노드에 지정된 접두사가 있는 네임스페이스를 가져옵니다.

매개변수

이름	유형	설명
`prefix`	`String`	네임스페이스 프리픽스

Return

Namespace: Element 노드에 지정된 프리픽스가 있는 네임스페이스입니다.

`getParentElement()`

노드의 상위 Element 노드를 가져옵니다. 노드에 상위 항목이 없으면 이 메서드는 null를 반환합니다.

Return

Element — 상위 Element 노드

`getQualifiedName()`

Element 노드의 로컬 이름 및 네임스페이스 프리픽스를 [namespacePrefix]:[localName] 형식으로 가져옵니다. 노드에 네임스페이스 프리픽스가 없는 경우 getName()를 사용합니다.

Return

String: Element 노드의 로컬 이름 및 네임스페이스 프리픽스([namespacePrefix]:[localName] 형식)입니다.

`getText()`

Element 노드의 텍스트 값을 가져옵니다.

Return

String: Element 노드의 텍스트 값입니다.

`getValue()`

노드의 직접 또는 간접 하위 요소인 모든 노드의 텍스트 값을 문서에 표시되는 순서대로 가져옵니다.

Return

String: 노드의 직접 또는 간접 하위 노드인 모든 노드의 텍스트 값입니다.

`isAncestorOf(other)`

이 Element 노드가 지정된 Element 노드의 직접 또는 간접 상위 항목인지 확인합니다.

매개변수

이름	유형	설명
`other`	`Element`	다른 `Element` 노드

Return

Boolean — 이 Element 노드가 지정된 Element 노드의 직접 또는 간접 상위 항목인 경우 true이고 그렇지 않은 경우 false입니다.

`isRootElement()`

Element 노드가 문서의 루트 노드인지 확인합니다.

Return

Boolean — Element 노드가 문서의 루트 노드인 경우 true, 그렇지 않은 경우 false입니다.

`removeAttribute(attribute)`

이 Element 노드에 해당 속성이 있으면 이 속성을 삭제합니다.

매개변수

이름	유형	설명
`attribute`	`Attribute`	속성

Return

Boolean: 속성이 존재하고 삭제된 경우 true, 그렇지 않은 경우 false

`removeAttribute(attributeName)`

지정된 이름이 있고 이 네임스페이스가 있는 경우 네임스페이스가 없는 Element 노드의 속성을 삭제합니다.

매개변수

이름	유형	설명
`attributeName`	`String`	속성 이름

Return

Boolean: 속성이 존재하고 삭제된 경우 true, 그렇지 않은 경우 false

`removeAttribute(attributeName, namespace)`

지정된 이름과 네임스페이스가 있는 경우 이 Element 노드의 속성을 삭제합니다.

매개변수

이름	유형	설명
`attributeName`	`String`	속성 이름
`namespace`	`Namespace`	속성의 네임스페이스입니다.

Return

Boolean: 속성이 존재하고 삭제된 경우 true, 그렇지 않은 경우 false

`removeContent()`

{@code Element} 노드의 바로 아래에 있는 하위 노드를 모두 제거합니다.

Return

Content[] — 삭제되기 전에 {@code Element} 노드의 바로 하위 노드인 모든 노드의 배열입니다.

`removeContent(content)`

노드가 {@code 요소} 노드의 직계 하위 노드인 경우 지정된 노드를 삭제합니다. content 인수는 Element 객체이거나 ContentType에 나열된 유형에 해당하는 노드 객체일 수 있습니다.

매개변수

이름	유형	설명
`content`	`Content`	삭제할 노드

Return

Boolean — 노드가 직계 하위 요소이고 삭제된 경우 true, 삭제되지 않은 경우 false입니다.

`removeContent(index)`

지정된 색인에서 {@code Element} 노드의 바로 하위 노드인 모든 노드 간에 노드를 삭제합니다. 지정된 색인에 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`index`	`Integer`	{@code 요소} 노드의 바로 하위 노드인 모든 노드의 노드 색인입니다.

Return

Content: 삭제된 노드 또는 지정된 색인에 노드가 없는 경우 null입니다.

`setAttribute(attribute)`

이 Element 노드에 지정된 속성을 설정합니다.

매개변수

이름	유형	설명
`attribute`	`Attribute`	설정할 속성

Return

Element — 체이닝용 Element 노드

`setAttribute(name, value)`

지정된 이름, 값, 네임스페이스 없이 이 Element 노드의 속성을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	설정할 속성의 이름
`value`	`String`	설정할 속성의 값

Return

Element — 체이닝용 Element 노드

`setAttribute(name, value, namespace)`

지정된 이름, 값, 네임스페이스로 이 Element 노드의 속성을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	설정할 속성의 이름
`value`	`String`	설정할 속성의 값
`namespace`	`Namespace`	설정할 속성의 네임스페이스입니다.

Return

Element — 체이닝용 Element 노드

`setName(name)`

Element 노드의 로컬 이름을 설정합니다. 노드의 네임스페이스 프리픽스를 설정하려면 setNamespace(namespace)을 XmlService.getNamespace(prefix, uri)과 함께 사용합니다.

매개변수

이름	유형	설명
`name`	`String`	설정할 로컬 이름

Return

Element — 체이닝용 Element 노드

`setNamespace(namespace)`

Element 노드의 네임스페이스를 설정합니다.

매개변수

이름	유형	설명
`namespace`	`Namespace`	설정할 네임스페이스

Return

Element — 체이닝용 Element 노드

`setText(text)`

Element 노드의 텍스트 값을 설정합니다. 노드에 텍스트 값이나 하위 노드가 이미 있는 경우 이 메서드는 이전 콘텐츠를 덮어씁니다. 콘텐츠를 추가하거나 삽입하려면 addContent(content) 또는 addContent(index, content)를 사용하세요.

매개변수

이름	유형	설명
`text`	`String`	설정할 텍스트

Return

Element — 체이닝용 Element 노드