org.w3c.dom
인터페이스 Attr

모든 슈퍼 인터페이스:

Node

public interface Attr

extends Node

Attr 인터페이스는 Element 오브젝트의 속성의 1 개입니다. 통상, 속성의 허용치는 문서 타입 정의에 정의되고 있습니다.

Attr 오브젝트는 Node 인터페이스를 계승하고 있습니다만, 자신이 기술하는 요소의 아이 노드로는 되고 있지 않습니다. 이 때문에, DOM 에서는 문서 트리의 일부라고는 보여지지 않습니다. Node 속성인 parentNode,previousSibling,nextSibling 의 Attr 오브젝트의 값은 null 가 됩니다. DOM 에서는 속성은 그것들을 관련지을 수 있고 있는 요소로부터 독립한 존재는 아니고, 이러한 요소의 프로퍼티이다고 보여집니다. 이러한 관점으로부터, 속성의 기능은 소정의 형태를 가지는 모든 요소에 관련지을 수 있었던 디폴트 속성으로서 한층 더 효율적으로 구현되게 됩니다. 또,Attr 노드는 DocumentFragment 의 직접적인 아이 노드는 되지 않기는 하지만,DocumentFragment 내의 Element 노드에 관련짓는 것이 가능합니다. 유저와 DOM 의 구현자는 Attr 노드가 Node 인터페이스를 계승하는 그 외의 오브젝트와 공통점을 가지고 있는 것만으로 있어, 그것들과는 완전히 별개인 것에 주의할 필요가 있습니다.

이하에서는 속성의 실효가의 특정 방법에 대해 설명합니다. 속성에 어떠한 값을 명시적으로 할당할 수 있고 있으면, 그 값이 속성의 실효가가 됩니다. 속성의 선언이 존재해, 거기에 디폴트 값가 포함되어 있으면, 그 디폴트 값가 속성의 실효가가 됩니다. 그 이외의 경우, 구조 모델에 있어서의 현재의 요소에는 속성이 존재하지 않습니다 (명시적으로 추가할 필요 있어). Attr 인스턴스상의 nodeValue 속성을 사용해, 속성의 값에 상당하는 캐릭터 라인을 취득할 수도 있습니다.

XML 에서는 속성치에 엔티티 참조가 포함되어 있는 경우가 있습니다. 이 때문에,Attr 노드의 아이 노드는 Text 노드나 EntityReference 노드가 됩니다 (이것들을 사용할 때는 EntityReference 의 기술을 참조해 충분히 심의). DOM Core 는 속성의 형태를 인식하지 않고 모든 속성치를 단순한 캐릭터 라인으로서 취급합니다. 이것은 속성이 DTD 나 schema에 의해 「토큰화형」으로서 선언되고 있는 경우도 바뀌지 않습니다.

「Document Object Model (DOM) Level 2 Core Specification」를 참조해 주세요.

필드의 개요

인터페이스 org.w3c.dom. Node 에서 상속받은 필드

ATTRIBUTE_NODE , CDATA_SECTION_NODE , COMMENT_NODE , DOCUMENT_FRAGMENT_NODE , DOCUMENT_NODE , DOCUMENT_TYPE_NODE , ELEMENT_NODE , ENTITY_NODE , ENTITY_REFERENCE_NODE , NOTATION_NODE , PROCESSING_INSTRUCTION_NODE , TEXT_NODE

메소드의 개요

String	getName () 이 속성의 이름을 돌려줍니다.
Element	getOwnerElement () 이 속성의 접속처인 Element 노드.
boolean	getSpecified () 이 속성에 대해서, 원의 문서내에서 명시적으로 값을 할당할 수 있고 있으면 true 입니다.
String	getValue () 취득시, 속성치는 캐릭터 라인으로서 돌려주어집니다.
void	setValue (String value) 취득시, 속성치는 캐릭터 라인으로서 돌려주어집니다.

인터페이스 org.w3c.dom. Node 에서 상속받은 메소드

appendChild , cloneNode , getAttributes , getChildNodes , getFirstChild , getLastChild , getLocalName , getNamespaceURI , getNextSibling , getNodeName , getNodeType , getNodeValue , getOwnerDocument , getParentNode , getPrefix , getPreviousSibling , hasAttributes , hasChildNodes , insertBefore , isSupported , normalize , removeChild , replaceChild , setNodeValue , setPrefix

메소드의 상세

getName

public String  getName()

이 속성의 이름을 돌려줍니다.

getSpecified

public boolean getSpecified()

이 속성에 대해서, 원의 문서내에서 명시적으로 값을 할당할 수 있고 있으면 true 입니다. 그 이외의 경우는 false 가 됩니다. 이 속성이 유저는 아니고 구현에 의존한다고 하는 점에 주의해 주세요. 유저가 속성치를 변경하면(자), 변경 후의 값이 최종적으로 디폴트 값와 같게 되었다고 해도,specified 플래그는 자동적으로 true 를 나타냅니다. 속성을 DTD 의 디폴트 값로서 지정 다시 하려면 , 일단 변경한 속성치를 삭제하지 않으면 안됩니다. 그 후, 구현에 의해 새로운 속성치가 제공됩니다. 이 속성치는 디폴트 값가 존재하는 경우는 그 값을 갖추고 있어 그 specified 플래그는 false 를 나타내고 있습니다.
통계: 문서내에서 속성에 값을 할당할 수 있고 있는 경우,specified 는 true 가 되어, 할당할 수 있고 있는 값이 속성치가 됩니다. 문서내에서는 값을 할당할 수 있지 않지만, DTD 내에 디폴트 값가 존재하는 경우,specified 는 false 가 되어, 그 디폴트 값가 속성치가 됩니다. 문서내에서 값을 할당할 수 있지 않고 DTD 내의 값이 #IMPLIED 의 경우, 그 속성은 문서의 구조 모델내에 존재하지 않습니다. ownerElement 속성이 null 의 경우 (이 속성이 작성된 직후는 null, 다양한 삭제 및 복제 조작에 의해 null 로 설정되는 경우도 있다),specified 는 true 가 됩니다.

getValue

public String  getValue()

취득시, 속성치는 캐릭터 라인으로서 돌려주어집니다. 캐릭터 및 일반적인 엔티티 참조는 이러한 값으로 옮겨놓을 수 있습니다. Element 인터페이스의 getAttribute 메소드를 참조해 주세요.
설정시, 미해석의 캐릭터 라인 컨텐츠를 가지는 Text 노드를 작성합니다. XML 프로세서에 의해 마크 업으로서 인식되는 모든 캐릭터는 리터럴 텍스트로서 취급됩니다. Element 인터페이스의 setAttribute 메소드를 참조해 주세요.

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽어내 전용의 경우

setValue

public void setValue(String  value)
              throws DOMException 

취득시, 속성치는 캐릭터 라인으로서 돌려주어집니다. 캐릭터 및 일반적인 엔티티 참조는 이러한 값으로 옮겨놓을 수 있습니다. Element 인터페이스의 getAttribute 메소드를 참조해 주세요.
설정시, 미해석의 캐릭터 라인 컨텐츠를 가지는 Text 노드를 작성합니다. XML 프로세서에 의해 마크 업으로서 인식되는 모든 캐릭터는 리터럴 텍스트로서 취급됩니다. Element 인터페이스의 setAttribute 메소드를 참조해 주세요.

예외:

DOMException - NO_MODIFICATION_ALLOWED_ERR: 노드가 읽어내 전용의 경우

getOwnerElement

public Element  getOwnerElement()

이 속성의 접속처인 Element 노드. 이 속성이 사용되어 있지 않은 경우는 null

도입된 버젼:

DOM Level 2