이 페이지는 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 Element} 노드의 바로 하위 노드인 모든 노드의 연결되지 않은 복사본을 생성합니다.
`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 Element} 노드를 포함하는 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 Element} 노드의 바로 하위 노드인 경우 제공된 노드를 삭제합니다.
`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`	추가할 노드

리턴

Element: Element 노드(체이닝용)

`addContent(index, content)`

다음 항목의 직계 하위 노드인 모든 노드 중에서 지정된 색인에 지정된 노드를 삽입합니다. 노드 Element개 content 인수는 Element 객체이거나 ContentType에 나열된 유형에 해당하는 노드 객체의 목록을 반환합니다.

매개변수

이름	유형	설명
`index`	`Integer`	바로 하위 노드인 모든 노드 중에서 노드를 삽입할 색인 (노드 `Element`개)
`content`	`Content`	삽입할 노드

리턴

Element: Element 노드(체이닝용)

`cloneContent()`

{@code Element} 노드의 바로 하위 노드인 모든 노드의 연결되지 않은 복사본을 생성합니다.

리턴

Content[]: {@code Element} 노드

`detach()`

상위 Element 노드에서 노드를 분리합니다. 노드에 상위 요소가 없는 경우 이 메서드는 효과가 없습니다.

리턴

Content - 분리된 노드

`getAllContent()`

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

리턴

Content[]: {@code Element} 노드의 바로 하위 요소인 모든 노드의 배열

`getAttribute(name)`

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

매개변수

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

리턴

Attribute — 속성 또는 null 지정된 이름을 가진 속성이 없고 네임스페이스

`getAttribute(name, namespace)`

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

매개변수

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

리턴

Attribute — 속성 또는 null 지정된 이름과 네임스페이스

`getAttributes()`

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

리턴

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

`getChild(name)`

지정된 이름이 있고 즉시 네임스페이스가 없는 첫 번째 Element 노드를 가져옵니다. 이 Element 노드의 하위 요소입니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

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

리턴

Element: Element 노드 또는 null(지정된 이름과 네임스페이스가 없는 바로 하위 Element 노드가 없는 경우)

`getChild(name, namespace)`

즉시 지정된 이름 및 네임스페이스가 있는 첫 번째 Element 노드를 가져옵니다. 이 Element 노드의 하위 요소입니다. 이러한 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

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

리턴

Element: Element 노드 또는 null(지정된 이름 및 네임스페이스의 바로 하위 Element 노드가 없는 경우)

`getChildText(name)`

노드가 다음과 같은 경우 노드의 텍스트 값을 가져옵니다. Element 노드의 직계 하위 요소입니다. 그러한 노드가 없으면 이 메서드는 null

매개변수

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

리턴

String: 하위 노드의 텍스트 값 또는 바로 아래 하위 노드가 없는 경우 null 지정된 이름 포함, 네임스페이스는 없음

`getChildText(name, namespace)`

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

매개변수

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

리턴

String: 하위 노드의 텍스트 값 또는 바로 아래 하위 노드가 없는 경우 null 지정된 이름 및 네임스페이스로 구성

`getChildren()`

다음에서 이 Element 노드의 직계 하위 요소인 모든 Element 노드를 가져옵니다. 순서대로 해야 합니다.

리턴

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

`getChildren(name)`

지정된 이름을 사용하고 직계 하위 요소인 네임스페이스는 없는 모든 Element 노드를 가져옵니다. 이 Element 노드의 모든 속성을 문서에 표시된 순서대로 표시합니다.

매개변수

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

리턴

Element[]: 지정된 이름을 가진 모든 Element 노드의 배열. 이 Element 노드의 직계 하위 요소

`getChildren(name, namespace)`

지정된 이름 및 네임스페이스가 있는 모든 Element 노드를 가져옵니다. 이 노드에는 이 Element 노드에 할당되며 문서에 표시된 순서대로 생성됩니다.

매개변수

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

리턴

Element[]: 지정된 이름과 네임스페이스가 있는 모든 Element 노드의 배열 이 Element 노드의 직계 하위 요소

`getContent(index)`

다음 항목의 직계 하위 노드인 모든 노드 중에서 지정된 색인의 노드를 {@code Element} 노드. 지정된 색인에 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`index`	`Integer`	노드의 직계 하위 노드인 {@code Element} 노드

리턴

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

`getContentSize()`

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

리턴

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

`getDescendants()`

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

리턴

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

`getDocument()`

{@code Element} 노드를 포함하는 XML 문서를 가져옵니다.

리턴

Document: {@code Element} 노드를 포함하는 문서입니다.

`getName()`

Element 노드의 로컬 이름을 가져옵니다. 노드에 네임스페이스 프리픽스가 있으면 getQualifiedName() 또는 getNamespace()를 사용합니다.getPrefix()부터 접두사를 가져옵니다.

리턴

String: Element 노드의 로컬 이름

`getNamespace()`

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

리턴

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

`getNamespace(prefix)`

Element 노드의 지정된 프리픽스가 있는 네임스페이스를 가져옵니다.

매개변수

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

리턴

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

`getParentElement()`

노드의 상위 Element 노드를 가져옵니다. 노드에 상위 요소가 없는 경우 이 메서드는 null를 반환합니다.

리턴

Element: 상위 Element 노드

`getQualifiedName()`

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

리턴

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

`getText()`

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

리턴

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

`getValue()`

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

리턴

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

`isAncestorOf(other)`

이 Element 노드가 지정된 Element 노드의 직접 상위 요소인지 간접 상위 요소인지를 결정합니다.

매개변수

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

리턴

Boolean: 이 Element 노드가 지정된의 직접 또는 간접 상위 요소인 경우 true 노드 Element개 그렇지 않은 경우 false

`isRootElement()`

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

리턴

Boolean: Element 노드가 문서의 루트 노드인 경우 true입니다. 조건: false 비

`removeAttribute(attribute)`

이 Element 노드에 지정된 속성이 있는 경우 해당 속성을 삭제합니다.

매개변수

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

리턴

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

`removeAttribute(attributeName)`

다음과 같은 경우 네임스페이스가 지정되고 이름이 지정된 이 Element 노드의 속성을 삭제합니다. 이러한 속성이 존재하는지 확인하세요.

매개변수

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

리턴

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

`removeAttribute(attributeName, namespace)`

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

매개변수

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

리턴

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

`removeContent()`

{@code Element} 노드의 바로 하위 노드인 모든 노드를 제거합니다.

리턴

Content[] — 다음 노드를 생성하기 전 {@code Element} 노드의 바로 하위에 있던 모든 노드의 배열 이(가) 삭제되었습니다.

`removeContent(content)`

노드가 {@code Element} 노드의 바로 하위 노드인 경우 제공된 노드를 삭제합니다. content 인수는 Element 객체일 수도 있고, 유형(ContentType에 나열되어 있음)

매개변수

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

리턴

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

`removeContent(index)`

다음 색인의 직계 하위에 있는 모든 노드 중에서 지정된 색인에서 {@code Element} 노드. 지정된 색인에 노드가 없으면 이 메서드는 null를 반환합니다.

매개변수

이름	유형	설명
`index`	`Integer`	노드의 직계 하위 노드인 {@code Element} 노드

리턴

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

`setAttribute(attribute)`

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

매개변수

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

리턴

Element: Element 노드(체이닝용)

`setAttribute(name, value)`

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

매개변수

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

리턴

Element: Element 노드(체이닝용)

`setAttribute(name, value, namespace)`

지정된 이름, 값 및 네임스페이스를 사용하여 이 Element 노드의 속성을 설정합니다.

매개변수

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

리턴

Element: Element 노드(체이닝용)

`setName(name)`

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

매개변수

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

리턴

Element: Element 노드(체이닝용)

`setNamespace(namespace)`

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

매개변수

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

리턴

Element: Element 노드(체이닝용)

`setText(text)`

Element 노드의 텍스트 값을 설정합니다. 노드에 이미 텍스트 값이 포함되어 있거나 모든 하위 노드의 경우 이 방법은 이전 콘텐츠를 덮어씁니다. 대신 콘텐츠를 추가하거나 삽입하려면 addContent(content) 또는 addContent(index, content)를 사용합니다.

매개변수

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

리턴

Element: Element 노드(체이닝용)