ObjectXml요소

XmlElement 개체는 XML 문서의 요소를 나타냅니다.

상속관계

구성원 속성

namespaceURI

문자열, 쿼리 요소 네임스페이스의 URI입니다. 선택한 노드에 네임스페이스가 없으면 이 속성은 NULL을 반환합니다.

1
readonly String XmlElement.namespaceURI;

prefix

요소의 네임스페이스 접두사를 문자열로 쿼리하고 설정합니다. 선택한 노드에 네임스페이스가 없으면 이 속성은 NULL을 반환합니다.

1
String XmlElement.prefix;

localName

문자열은 쿼리 요소의 로컬 이름입니다. 선택한 노드에 네임스페이스가 없으면 이 속성은 nodeName과 동일합니다.

1
readonly String XmlElement.localName;

tagName

문자열, 요소의 태그 이름을 반환합니다.

1
readonly String XmlElement.tagName;

id

요소의 문자열, 쿼리 및 id 속성 설정

1
String XmlElement.id;

innerHTML

선택한 요소의 하위 요소에 대한 HTML 텍스트를 문자열로 쿼리하고 설정합니다. HTML 모드에서만 유효합니다. 쿼리 시 요소 노드 내 모든 하위 노드의 HTML 인코딩을 반환하고, 설정 시 모든 하위 노드를 삭제하고 지정된 HTML 디코딩으로 대체합니다.

1
String XmlElement.innerHTML;

outerHTML

문자열, 선택한 요소와 해당 하위 항목의 HTML 텍스트를 쿼리합니다. html 모드에서만 유효합니다. 쿼리할 때 요소와 노드 내의 모든 하위 노드의 HTML 인코딩을 반환합니다.

1
readonly String XmlElement.outerHTML;

className

요소의 클래스 속성을 문자열로 쿼리하고 설정하며 html 모드에서만 유효합니다.

1
String XmlElement.className;

attributes

XmlNamedNodeMap, 선택한 노드의 속성을 포함하는 NamedNodeMap을 반환합니다. 선택한 노드가 요소가 아닌 경우 이 속성은 NULL을 반환합니다.

1readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

정수, 노드의 노드 유형을 반환합니다.

1readonly Integer XmlElement.nodeType;

다양한 객체의 nodeType은 다양한 값을 반환합니다.

XmlElement: ELEMENT_NODE(1)
XmlAttr:ATTRIBUTE_NODE(2)
XmlText: TEXT_NODE(3)
XmlCDATASection: CDATA_SECTION_NODE(4)
XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
XmlComment:COMMENT_NODE(8)
XmlDocument: DOCUMENT_NODE(9)
XmlDocumentType: DOCUMENT_TYPE_NODE(10)

nodeName

문자열, 해당 유형에 따라 노드 이름을 반환합니다.

1
readonly String XmlElement.nodeName;

다양한 객체의 nodeName은 다양한 값을 반환합니다.

XmlElement:요소 이름
XmlAttr: 속성 이름
XmlText: #텍스트
XmlCDATASection: #cdata-섹션
XmlProcessingInstruction: 지정된 대상 대상을 반환합니다.
XmlComment: #논평
XmlDocument: #문서
XmlDocumentType: 문서 유형 이름

nodeValue

문자열, 해당 유형에 따라 노드 이름을 반환합니다.

1
String XmlElement.nodeValue;

다양한 객체의 nodeName은 다양한 값을 반환합니다.

XmlElement: 없는
XmlAttr: 속성값
XmlText: 노드의 내용
XmlCDATASection: 노드의 내용
XmlProcessingInstruction: 지정된 콘텐츠 데이터를 반환합니다.
XmlComment: 주석 텍스트
XmlDocument: 없는
XmlDocumentType: 없는

ownerDocument

XmlDocument, 노드의 루트 요소를 반환합니다(XmlDocument물체)

1readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode, 노드의 상위 노드를 반환할 수 있습니다.

1readonly XmlNode XmlElement.parentNode;

childNodes

XmlNodeList, 지정된 노드의 하위 노드의 노드 목록을 반환합니다.

1readonly XmlNodeList XmlElement.childNodes;

children

XmlNodeList, 지정된 노드의 하위 요소 노드의 노드 목록을 반환합니다.

1readonly XmlNodeList XmlElement.children;

firstChild

XmlNode, 노드의 첫 번째 하위 노드를 반환합니다.

1readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode, 노드의 마지막 자식 노드를 반환합니다.

1readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNode, 동일한 트리 수준에서 노드 바로 앞에 있는 노드를 반환합니다. 그러한 노드가 없으면 이 속성은 null을 반환합니다.

1readonly XmlNode XmlElement.previousSibling;

nextSibling

XmlNode는 동일한 트리 수준의 요소 바로 뒤에 있는 노드를 반환합니다. 그러한 노드가 없으면 속성은 null을 반환합니다.

1readonly XmlNode XmlElement.nextSibling;

firstElementChild

XmlNode, 노드의 첫 번째 하위 요소 노드를 반환합니다.

1readonly XmlNode XmlElement.firstElementChild;

lastElementChild

XmlNode, 노드의 마지막 하위 요소 노드를 반환합니다.

1readonly XmlNode XmlElement.lastElementChild;

previousElementSibling

XmlNode, 동일한 트리 수준에서 노드 바로 앞에 있는 요소 노드를 반환합니다. 그러한 노드가 없으면 이 속성은 null을 반환합니다.

1readonly XmlNode XmlElement.previousElementSibling;

nextElementSibling

XmlNode는 요소(동일한 트리 수준) 바로 뒤에 요소 노드를 반환합니다. 그러한 노드가 없으면 속성은 null을 반환합니다.

1readonly XmlNode XmlElement.nextElementSibling;

textContent

문자열은 선택한 요소의 텍스트를 쿼리하고 설정합니다. 쿼리 시에는 요소 노드 내 모든 텍스트 노드의 값을 반환하고, 설정 시에는 모든 하위 노드를 삭제하고 단일 텍스트 노드로 대체합니다.

1
String XmlElement.textContent;

멤버 함수

getAttribute

이름으로 속성 값 쿼리

1
String XmlElement.getAttribute(String name);

호출 매개변수:

name: 문자열, 쿼리의 속성 이름을 지정합니다.

결과 반환:

String, 속성 값을 반환합니다.

getAttributeNS

네임스페이스 URI 및 이름으로 속성 값 가져오기

1
2
String XmlElement.getAttributeNS(String namespaceURI,
    String localName);

호출 매개변수:

namespaceURI: 쿼리의 네임스페이스 URI를 지정하는 문자열
localName: 문자열, 쿼리의 속성 이름을 지정합니다.

결과 반환:

String, 속성 값을 반환합니다.

setAttribute

새 속성 만들기 또는 변경

1
2
XmlElement.setAttribute(String name,
    String value);

호출 매개변수:

name: 문자열, 설정할 속성 이름을 지정합니다.
value: 문자열, 설정할 속성 값을 지정합니다.

이 메서드는 지정된 속성을 지정된 값으로 설정합니다. 지정된 이름의 속성이 존재하지 않는 경우 이 메서드는 새 속성을 생성합니다.

setAttributeNS

네임스페이스 속성 생성 또는 변경

1
2
3
XmlElement.setAttributeNS(String namespaceURI,
    String qualifiedName,
    String value);

호출 매개변수:

namespaceURI: 문자열, 설정할 네임스페이스 URI를 지정합니다.
qualifiedName: 문자열, 설정할 속성 이름을 지정합니다.
value: 문자열, 설정할 속성 값을 지정합니다.

이 메소드는 생성되거나 설정될 속성이 네임스페이스 URI와 네임스페이스 접두사, 콜론 및 네임스페이스의 로컬 이름으로 구성된 정규화된 이름으로 지정된다는 점을 제외하면 setAttribute 메소드와 유사합니다. 속성 값을 변경하는 것 외에도 이 방법을 사용하여 속성의 네임스페이스 접두사를 변경할 수도 있습니다.

removeAttribute

이름으로 지정된 속성 제거

1
XmlElement.removeAttribute(String name);

호출 매개변수:

name: 문자열, 삭제할 속성 이름을 지정합니다.

removeAttributeNS

네임스페이스 및 이름별로 지정된 속성 제거

1
2
XmlElement.removeAttributeNS(String namespaceURI,
    String localName);

호출 매개변수:

namespaceURI: 문자열, 삭제할 네임스페이스 URI를 지정합니다.
localName: 문자열, 삭제할 속성 이름을 지정합니다.

hasAttribute

현재 노드에 지정된 이름의 속성이 있는지 쿼리

1
Boolean XmlElement.hasAttribute(String name);

호출 매개변수:

name: 문자열, 쿼리의 속성 이름을 지정합니다.

결과 반환:

Boolean, 현재 요소 노드에 지정된 속성이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

hasAttributeNS

현재 노드에 지정된 네임스페이스와 이름을 가진 속성이 있는지 쿼리

1
2
Boolean XmlElement.hasAttributeNS(String namespaceURI,
    String localName);

호출 매개변수:

namespaceURI: 문자열, 쿼리할 네임스페이스 URI를 지정합니다.
localName: 문자열, 쿼리의 속성 이름을 지정합니다.

결과 반환:

Boolean, 현재 요소 노드에 지정된 속성이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

getElementsByTagName

지정된 이름을 가진 모든 요소를 반환합니다.XmlNodeList

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

호출 매개변수:

tagName: 문자열, 검색할 태그 이름입니다. "*" 값은 모든 태그와 일치합니다.

결과 반환:

XmlNodeList, 노드 트리에 지정된 태그가 있는 XmlElement 노드XmlNodeList모으다. 반환된 요소 노드의 순서는 소스 문서에 나타나는 순서입니다.

이 메서드는 지정된 요소의 하위 노드를 순회하고 XmlElement 노드를 반환합니다.XmlNodeList지정된 태그 이름을 가진 모든 문서 요소를 나타내는 개체입니다. 반환된 배열의 요소 순서는 문서 소스 코드에 나타나는 순서입니다.

XmlDocument인터페이스는 또한 이 메소드와 유사하지만 요소의 하위 노드를 순회하는 대신 전체 문서를 순회하는 getElementsByTagName 메소드를 정의합니다.

getElementsByTagNameNS

지정된 네임스페이스와 이름을 가진 모든 요소를 반환합니다.XmlNodeList

1
2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
    String localName);

호출 매개변수:

namespaceURI: 문자열, 쿼리할 네임스페이스 URI를 지정합니다.
localName: 문자열, 검색할 태그 이름입니다. "*" 값은 모든 태그와 일치합니다.

결과 반환:

XmlNodeList, 노드 트리에 지정된 태그가 있는 XmlElement 노드XmlNodeList모으다. 반환된 요소 노드의 순서는 소스 문서에 나타나는 순서입니다.

이 메소드는 가져오려는 요소의 태그 이름이 네임스페이스 URI와 네임스페이스에 정의된 로컬 이름의 조합으로 지정된다는 점을 제외하면 getElementsByTagName 메소드와 유사합니다.

getElementById

지정된 id 속성을 가진 요소를 반환합니다.

1
XmlElement XmlElement.getElementById(String id);

호출 매개변수:

id: 문자열, 검색할 ID

결과 반환:

XmlElement, 노드 트리에 지정된 id 속성이 있는 XmlElement 노드

이 메서드는 지정된 요소의 하위 노드를 순회하고 지정된 id 특성을 가진 첫 번째 문서 요소를 나타내는 XmlElement 노드 개체를 반환합니다. .

XmlDocument인터페이스는 또한 이 메소드와 유사하지만 요소의 하위 노드를 순회하는 대신 전체 문서를 순회하는 getElementsByTagName 메소드를 정의합니다.

getElementsByClassName

지정된 클래스 이름을 가진 모든 요소의 노드 목록을 반환합니다.

1
XmlNodeList XmlElement.getElementsByClassName(String className);

호출 매개변수:

className: 문자열, 검색할 클래스 이름

결과 반환:

XmlNodeList, 문서 트리에서 지정된 클래스 이름을 가진 XmlElement 노드XmlNodeList모으다. 반환된 요소 노드의 순서는 소스 문서에 나타나는 순서입니다.

이 메소드는XmlNodeList지정된 클래스 이름을 가진 모든 XmlElement 노드를 문서에 저장하는 개체(읽기 전용 배열로 처리 가능) 저장 순서는 소스 문서에 나타나는 순서와 같습니다.XmlNodeList개체는 "라이브"입니다. 즉, 지정된 태그 이름을 가진 요소가 문서에 추가되거나 삭제되면 해당 내용이 필요에 따라 자동으로 업데이트됩니다.

hasChildNodes

자식 노드가 있는지 쿼리

1
Boolean XmlElement.hasChildNodes();

결과 반환:

Boolean, 하위 노드가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

normalize

인접한 Text 노드를 병합하고 빈 Text 노드 삭제

1XmlElement.normalize();

이 메서드는 현재 노드의 모든 하위 노드를 순회하고 빈 Text 노드를 삭제하고 인접한 모든 Text 노드를 병합하여 문서를 정규화합니다. 이 방법은 노드를 삽입하거나 삭제한 후 문서 트리의 구조를 단순화하는 데 유용합니다.

cloneNode

지정된 노드의 정확한 복사본을 생성합니다.

1
XmlNode XmlElement.cloneNode(Boolean deep = true);

호출 매개변수:

deep: 부울, 전체 복사 여부, true인 경우 복제된 노드는 원본 노드의 모든 하위 노드를 복제합니다.

결과 반환:

XmlNode, 복사된 노드를 반환합니다.

이 메서드는 호출된 노드의 복사본을 복사하고 반환합니다. 전달된 인수가 true이면 현재 노드의 모든 하위 노드도 재귀적으로 복사합니다. 그렇지 않으면 현재 노드만 복사합니다. 반환된 노드는 문서 트리에 속하지 않으며 해당 parentNode 속성은 null입니다. 요소 노드가 복사되면 모든 속성이 복사됩니다.

lookupPrefix

현재 노드의 지정된 네임스페이스 URI와 일치하는 접두사를 반환합니다.

1
String XmlElement.lookupPrefix(String namespaceURI);

호출 매개변수:

namespaceURI: 문자열, 일치하는 네임스페이스 URI를 지정합니다.

결과 반환:

String, 일치하는 접두사를 반환하고 일치하지 않으면 null을 반환합니다.

lookupNamespaceURI

현재 노드의 지정된 접두사와 일치하는 네임스페이스 URI를 반환합니다.

1
String XmlElement.lookupNamespaceURI(String prefix);

호출 매개변수:

prefix: 문자열, 일치하는 접두사를 지정합니다.

결과 반환:

String, 일치하는 네임스페이스 URI를 반환하고, 일치하지 않으면 null을 반환합니다.

insertBefore

기존 하위 노드 앞에 새 하위 노드를 삽입합니다.

1
2
XmlNode XmlElement.insertBefore(XmlNode newChild,
    XmlNode refChild);

호출 매개변수:

newChild:XmlNode, 새 노드 삽입
refChild:XmlNode, 이 노드 앞에 새 노드를 삽입합니다.

결과 반환:

XmlNode, 새 자식 노드를 반환합니다.

newChild가 문서 트리에 이미 존재하는 경우 문서 트리에서 제거되고 새 위치에 다시 삽입됩니다. 한 문서의 노드(또는 한 문서에서 생성된 노드)는 다른 문서에 삽입할 수 없습니다. 즉, newChild의 ownerDocument 속성은 현재 노드의 ownerDocument 속성과 동일해야 합니다.

insertAfter

기존 하위 노드 뒤에 새 하위 노드 삽입

1
2
XmlNode XmlElement.insertAfter(XmlNode newChild,
    XmlNode refChild);

호출 매개변수:

newChild:XmlNode, 새 노드 삽입
refChild:XmlNode, 이 노드 뒤에 새 노드를 삽입합니다.

결과 반환:

XmlNode, 새 자식 노드를 반환합니다.

appendChild

노드의 하위 노드 목록 끝에 새 하위 노드를 추가합니다.

1XmlNode XmlElement.appendChild(XmlNode newChild);

호출 매개변수:

newChild:XmlNode, 추가된 노드를 지정

결과 반환:

XmlNode, 이 새로운 하위 노드를 반환합니다.

replaceChild

하위 노드를 다른 노드로 교체

1
2
XmlNode XmlElement.replaceChild(XmlNode newChild,
    XmlNode oldChild);

호출 매개변수:

newChild:XmlNode, 새 노드를 지정합니다
oldChild:XmlNode, 교체할 노드를 지정합니다.

결과 반환:

XmlNode, 교체에 성공하면 이 메서드는 교체된 노드를 반환할 수 있으며, 교체에 실패하면 null을 반환합니다.

removeChild

하위 노드 목록에서 노드 제거

1XmlNode XmlElement.removeChild(XmlNode oldChild);

호출 매개변수:

oldChild:XmlNode, 삭제할 노드를 지정합니다.

결과 반환:

XmlNode, 삭제에 성공하면 삭제된 노드를 반환하고, 실패하면 null을 반환한다.

toString

객체의 문자열 표현을 반환하며 일반적으로 "[Native Object]"를 반환하며 객체 자체의 특성에 따라 다시 구현될 수 있습니다.

1
String XmlElement.toString();

결과 반환:

String, 객체의 문자열 표현을 반환합니다.

toJSON

객체의 JSON 형식 표현을 반환하며 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 컬렉션을 반환합니다.

1
Value XmlElement.toJSON(String key = "");

호출 매개변수:

key: 문자열, 사용되지 않음

결과 반환:

Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.

개발 가이드

기본 모듈

내장 객체

커뮤니티 모듈

ObjectXml요소

상속관계

구성원 속성

namespaceURI

prefix

localName

tagName

id

innerHTML

outerHTML

className

attributes

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

멤버 함수

getAttribute

getAttributeNS

setAttribute

setAttributeNS

removeAttribute

removeAttributeNS

hasAttribute

hasAttributeNS

getElementsByTagName

getElementsByTagNameNS

getElementById

getElementsByClassName

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON