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)ElementElement 노드의 직계 하위인 모든 노드 중에서 지정된 색인에 지정된 노드를 삽입합니다.
cloneContent()Content[]{@code Element} 노드의 직계 하위 노드인 모든 노드의 연결되지 않은 복사본을 만듭니다.
detach()Content상위 Element 노드에서 노드를 분리합니다.
getAllContent()Content[]{@code Element} 노드의 직계 하위 노드인 모든 노드를 가져옵니다.
getAttribute(name)AttributeElement 노드의 속성을 가져오고 네임스페이스는 사용하지 않습니다.
getAttribute(name, namespace)Attribute지정된 이름과 네임스페이스를 사용하여 이 Element 노드의 속성을 가져옵니다.
getAttributes()Attribute[]Element 노드의 모든 속성을 문서에 표시된 순서대로 가져옵니다.
getChild(name)Element지정된 이름을 가진 첫 번째 Element 노드를 가져오고 이 Element 노드의 직계 하위 요소인 네임스페이스를 가져오지 않습니다.
getChild(name, namespace)ElementElement 노드의 직계 하위 요소인 지정된 이름과 네임스페이스를 가진 첫 번째 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()StringElement 노드의 로컬 이름을 가져옵니다.
getNamespace()NamespaceElement 노드의 네임스페이스를 가져옵니다.
getNamespace(prefix)NamespaceElement 노드에 지정된 접두사가 있는 네임스페이스를 가져옵니다.
getParentElement()Element노드의 상위 Element 노드를 가져옵니다.
getQualifiedName()StringElement 노드의 로컬 이름과 네임스페이스 접두사를 [namespacePrefix]:[localName] 형식으로 가져옵니다.
getText()StringElement 노드의 텍스트 값을 가져옵니다.
getValue()String노드의 직접 또는 간접 하위 요소인 모든 노드의 텍스트 값을 문서에 표시되는 순서대로 가져옵니다.
isAncestorOf(other)BooleanElement 노드가 지정된 Element 노드의 직접 상위 요소인지 간접적인 상위 요소인지를 결정합니다.
isRootElement()BooleanElement 노드가 문서의 루트 노드인지 확인합니다.
removeAttribute(attribute)BooleanElement 노드에 지정된 속성이 있는 경우 삭제합니다.
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)ElementElement 노드에 지정된 속성을 설정합니다.
setAttribute(name, value)Element지정된 이름, 값, 네임스페이스 없이 이 Element 노드의 속성을 설정합니다.
setAttribute(name, value, namespace)Element지정된 이름, 값, 네임스페이스로 이 Element 노드의 속성을 설정합니다.
setName(name)ElementElement 노드의 로컬 이름을 설정합니다.
setNamespace(namespace)ElementElement 노드의 네임스페이스를 설정합니다.
setText(text)ElementElement 노드의 텍스트 값을 설정합니다.

자세한 문서

addContent(content)

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

매개변수

이름유형설명
contentContent추가할 노드

리턴

Element: 체이닝을 위한 Element 노드


addContent(index, content)

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

매개변수

이름유형설명
indexIntegerElement 노드의 직계 하위인 모든 노드 중에서 노드를 삽입할 색인입니다.
contentContent삽입할 노드

리턴

Element: 체이닝을 위한 Element 노드


cloneContent()

{@code Element} 노드의 직계 하위 노드인 모든 노드의 연결되지 않은 복사본을 만듭니다.

리턴

Content[] - {@code Element} 노드의 직계 하위 요소인 모든 노드의 연결되지 않은 사본 배열


detach()

상위 Element 노드에서 노드를 분리합니다. 노드에 상위 요소가 없으면 이 메서드는 아무런 영향을 미치지 않습니다.

리턴

Content — 분리된 노드


getAllContent()

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

리턴

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


getAttribute(name)

Element 노드의 속성을 가져오고 네임스페이스는 사용하지 않습니다. 이러한 속성이 없으면 이 메서드는 null를 반환합니다.

매개변수

이름유형설명
nameString속성의 이름

리턴

Attribute — 속성 또는 지정된 이름의 속성이 없고 네임스페이스가 없는 경우 null


getAttribute(name, namespace)

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

매개변수

이름유형설명
nameString속성의 이름
namespaceNamespace속성의 네임스페이스는

리턴

Attribute — 속성 또는 지정된 이름 및 네임스페이스의 속성이 없는 경우 null


getAttributes()

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

리턴

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


getChild(name)

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

매개변수

이름유형설명
nameString하위 Element 노드의 이름

리턴

Element: Element 노드 또는 지정된 이름을 가진 직계 하위 Element 노드가 없는 경우 null


getChild(name, namespace)

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

매개변수

이름유형설명
nameString하위 Element 노드의 이름
namespaceNamespace하위 Element 노드의 네임스페이스

리턴

Element: Element 노드 또는 지정된 이름 및 네임스페이스를 가진 직계 하위 Element 노드가 없는 경우 null


getChildText(name)

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

매개변수

이름유형설명
nameString하위 노드의 이름

리턴

String - 하위 노드의 텍스트 값 또는 지정된 이름을 가진 직계 하위 노드가 없는 경우 null


getChildText(name, namespace)

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

매개변수

이름유형설명
nameString하위 노드의 이름
namespaceNamespace하위 노드의 네임스페이스로도

리턴

String - 하위 노드의 텍스트 값 또는 지정된 이름 및 네임스페이스를 가진 직계 하위 노드가 없는 경우 null


getChildren()

Element 노드의 직계 하위 노드인 모든 Element 노드를 문서에 나타나는 순서대로 가져옵니다.

리턴

Element[]: 이 Element 노드의 직계 하위 노드인 모든 Element 노드의 배열


getChildren(name)

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

매개변수

이름유형설명
nameString하위 Element 노드의 이름

리턴

Element[] - 지정된 이름을 가지며 이 Element 노드의 직계 하위 요소인 네임스페이스는 없는 모든 Element 노드의 배열


getChildren(name, namespace)

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

매개변수

이름유형설명
nameString하위 Element 노드의 이름
namespaceNamespace하위 Element 노드의 네임스페이스

리턴

Element[] - 이 Element 노드의 직계 하위 요소인 지정된 이름 및 네임스페이스를 가진 모든 Element 노드의 배열


getContent(index)

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

매개변수

이름유형설명
indexInteger{@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 노드에 지정된 접두사가 있는 네임스페이스를 가져옵니다.

매개변수

이름유형설명
prefixString네임스페이스의 프리픽스

리턴

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 노드의 직접 상위 요소인지 간접적인 상위 요소인지를 결정합니다.

매개변수

이름유형설명
otherElement다른 Element 노드

리턴

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


isRootElement()

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

리턴

Boolean - Element 노드가 문서의 루트 노드이면 true이고 그렇지 않으면 false입니다.


removeAttribute(attribute)

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

매개변수

이름유형설명
attributeAttribute속성

리턴

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


removeAttribute(attributeName)

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

매개변수

이름유형설명
attributeNameString속성의 이름

리턴

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


removeAttribute(attributeName, namespace)

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

매개변수

이름유형설명
attributeNameString속성의 이름
namespaceNamespace속성의 네임스페이스는

리턴

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


removeContent()

{@code Element} 노드의 직계 하위 노드인 모든 노드를 삭제합니다.

리턴

Content[] - 삭제되기 전에 {@code Element} 노드의 직계 하위 요소였던 모든 노드의 배열


removeContent(content)

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

매개변수

이름유형설명
contentContent삭제할 노드

리턴

Boolean - 노드가 직계 하위 요소여서 삭제된 경우 true, 그렇지 않은 경우 false


removeContent(index)

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

매개변수

이름유형설명
indexInteger{@code Element} 노드의 직계 하위인 모든 노드 중 노드의 색인

리턴

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


setAttribute(attribute)

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

매개변수

이름유형설명
attributeAttribute설정할 속성

리턴

Element: 체이닝을 위한 Element 노드


setAttribute(name, value)

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

매개변수

이름유형설명
nameString설정할 속성의 이름
valueString설정할 속성의 값입니다.

리턴

Element: 체이닝을 위한 Element 노드


setAttribute(name, value, namespace)

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

매개변수

이름유형설명
nameString설정할 속성의 이름
valueString설정할 속성의 값입니다.
namespaceNamespace설정할 속성의 네임스페이스

리턴

Element: 체이닝을 위한 Element 노드


setName(name)

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

매개변수

이름유형설명
nameString설정할 로컬 이름

리턴

Element: 체이닝을 위한 Element 노드


setNamespace(namespace)

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

매개변수

이름유형설명
namespaceNamespace설정할 네임스페이스

리턴

Element: 체이닝을 위한 Element 노드


setText(text)

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

매개변수

이름유형설명
textString설정할 텍스트

리턴

Element: 체이닝을 위한 Element 노드