|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
public interface Element
Element
인터페이스는, HTML 문서 또는 XML 문서내의 요소를 나타냅니다. 이러한 요소는, 자신이 관련지을 수 있었던 속성을 가질 수가 있습니다. Element
인터페이스는 Node
를 상속하므로, 범용의 Node
인터페이스 속성인 attributes
를 사용해, 어느 요소의 속성 전부를 취득할 수 있습니다. Element
인터페이스상에는, 이름을 지정해 Attr
객체를 취득하는 메소드나, 이름을 지정해 속성치를 취득하는 메소드가 있습니다. XML 에서는, 속성치에 엔티티 참조를 포함할 수가 있습니다. 따라서,Attr
객체를 취득하는 것으로써, 속성치를 나타내는 서브 트리 ( 꽤 복잡한 것을 포함한다)를 검사할 필요가 있습니다. 한편, HTML 에서는, 속성은 모두 단순한 캐릭터 라인치를 가지게 됩니다. 따라서, 속성치에 직접 액세스 하는 메소드를 안전하고 편리하게 사용할 수 있습니다.
주: DOM 레벨 2 에서는, 메소드 normalize
는, 그 이동처 Node
인터페이스로부터 상속됩니다.
「Document Object Model (DOM) Level 3 Core Specification」를 참조해 주세요.
필드의 개요 |
---|
메소드의 개요 | |
---|---|
String |
getAttribute (String name)
이름을 지정해 속성을 가져옵니다. |
Attr |
getAttributeNode (String name)
이름을 지정해 속성 노드를 가져옵니다. |
Attr |
getAttributeNodeNS (String namespaceURI,
String localName)
로컬명과 이름 공간 URI 를 지정해 Attr 노드를 가져옵니다. |
String |
getAttributeNS (String namespaceURI,
String localName)
로컬명과 이름 공간 URI 를 지정해 속성치를 가져옵니다. |
NodeList |
getElementsByTagName (String name)
주어진(given) 태그명과 함께, 모든 자손 Elements 의 NodeList 를 문서순서에 돌려줍니다. |
NodeList |
getElementsByTagNameNS (String namespaceURI,
String localName)
주어진(given) 로컬명과 이름 공간 URI 와 함께, 모든 자손 Elements 의 NodeList 를 문서순서에 돌려줍니다. |
TypeInfo |
getSchemaTypeInfo ()
이 요소에 관련하는 형태 정보입니다. |
String |
getTagName ()
요소의 이름입니다. |
boolean |
hasAttribute (String name)
이 요소상에 주어진(given) 이름의 속성이 지정되었을 경우, 또는 속성에 디폴트 값가 있는 경우는 true , 그 이외의 경우는 false |
boolean |
hasAttributeNS (String namespaceURI,
String localName)
이 요소상에 주어진(given) 로컬명과 이름 공간 URI 를 가지는 속성이 지정되었을 경우, 또는 그 속성에 디폴트 값가 있는 경우는 true , 그 이외의 경우는 false 를 돌려줍니다. |
void |
removeAttribute (String name)
이름을 지정해 속성을 삭제합니다. |
Attr |
removeAttributeNode (Attr oldAttr)
지정된 속성 노드를 삭제합니다. |
void |
removeAttributeNS (String namespaceURI,
String localName)
로컬명과 이름 공간 URI 를 지정해 속성을 삭제합니다. |
void |
setAttribute (String name,
String value)
새로운 속성을 추가합니다. |
Attr |
setAttributeNode (Attr newAttr)
새로운 속성을 추가합니다. |
Attr |
setAttributeNodeNS (Attr newAttr)
새로운 속성을 추가합니다. |
void |
setAttributeNS (String namespaceURI,
String qualifiedName,
String value)
새로운 속성을 추가합니다. |
void |
setIdAttribute (String name,
boolean isId)
isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. |
void |
setIdAttributeNode (Attr idAttr,
boolean isId)
isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. |
void |
setIdAttributeNS (String namespaceURI,
String localName,
boolean isId)
isId 파라미터가 true 의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. |
인터페이스 org.w3c.dom. Node 로부터 상속된 메소드 |
---|
appendChild , cloneNode , compareDocumentPosition , getAttributes , getBaseURI , getChildNodes , getFeature , getFirstChild , getLastChild , getLocalName , getNamespaceURI , getNextSibling , getNodeName , getNodeType , getNodeValue , getOwnerDocument , getParentNode , getPrefix , getPreviousSibling , getTextContent , getUserData , hasAttributes , hasChildNodes , insertBefore , isDefaultNamespace , isEqualNode , isSameNode , isSupported , lookupNamespaceURI , lookupPrefix , normalize , removeChild , replaceChild , setNodeValue , setPrefix , setTextContent , setUserData |
메소드의 상세 |
---|
String getTagName()
Node.localName
가 null
이외의 경우, 이 속성은 수식명입니다. 다음에 예를 나타냅니다.
<elementExample id="demo"> ... </elementExample> ,
tagName
의 값은 「elementExample
」입니다. XML 에서는, DOM 의 조작과 같게 알파벳의 대문자와 소문자의 구별이 보존됩니다. HTML DOM 는, 소스가 되는 HTML 문서로 대문자와 소문자의 어느 쪽이 사용되고 있어도, HTML 요소의 tagName
를 표준의 대문자로 돌려줍니다.
String getAttribute(String name)
name
- 취득하는 속성의 이름
Attr
의 값.
그 속성이 지정된 값 또는 디폴트 값를 가지지 않는 경우는 공문자열void setAttribute(String name, String value) throws DOMException
Attr
노드 외에 Text
노드와 EntityReference
노드를 작성할 필요가 있습니다. 다음에, 적절한 서브 트리를 구축해,setAttributeNode
를 사용해, 이것을 속성치로서 할당합니다. setAttributeNS
메소드를 사용합니다.
name
- 작성 또는 변경하는 속성의 이름value
- 설정하는 값을 나타내는 캐릭터 라인
DOMException
- INVALID_CHARACTER_ERR:지정된 이름이, 사용중의 XML 버젼
(Document.xmlVersion
속성으로 지정되고 있다)
에 정해져 있는 XML 명이 아닌 경우
void removeAttribute(String name) throws DOMException
Document.normalizeDocument()
를 사용해, 정보가 최신의 정보인 것을 보증할 필요가 있습니다. removeAttributeNS
메소드를 사용합니다.
name
- 삭제하는 속성의 이름
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우Attr getAttributeNode(String name)
getAttributeNodeNS
메소드를 사용합니다.
name
- 취득하는 속성의 이름
(nodeName
)
nodeName
)의 Attr
노드.
해당하는 속성이 존재하지 않는 경우는
null
Attr setAttributeNode(Attr newAttr) throws DOMException
nodeName
)을 가지는 속성이 벌써 요소내에 존재하는 경우는, 새로운 속성으로 옮겨집니다. 속성 노드를 그 속성 노드 자체에 옮겨놓아도 영향은 전혀 없습니다. setAttributeNodeNS 메소드를 사용합니다.
- 파라미터:
newAttr
- 속성 리스트에 추가하는 Attr
노드
- 반환값:
- 기존의 속성이
newAttr
속성으로 옮겨놓을 수 있는 경우는
치환의 대상이 되는 Attr
노드.
그 이외의 경우는 null
- 예외:
DOMException
- WRONG_DOCUMENT_ERR:요소를 작성한 문서와는 다른 문서로부터 newAttr
하지만 작성되었을 경우
NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
INUSE_ATTRIBUTE_ERR:newAttr
가 벌써 다른
Element
객체의 속성으로서 사용되고 있는 경우. Attr
노드를
다른 요소로 재사용하려면 , 이 노드를 DOM 사용자의 손으로 명시적으로 복제한다
필요가 있다
Attr removeAttributeNode(Attr oldAttr) throws DOMException
Attr
노드의 디폴트 값가 DTD 로 정의되고 있으면(자), 디폴트 값 뿐만이 아니라, 해당하는 경우는 대응하는 이름 공간 URI, 로컬명, 접두사와 함께 새로운 노드가 곧바로 표시됩니다. 구현에서는, 똑같이 다른 schema의 디폴트 값를 처리할 수 있습니다만, 어플리케이션에서는 Document.normalizeDocument()
를 사용해, 정보가 최신의 정보인 것을 보증할 필요가 있습니다.
oldAttr
- 속성 리스트로부터 삭제하는 Attr
노드
Attr
노드
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
oldAttr
가 이 요소의 속성
(이)가 아닌 경우NodeList getElementsByTagName(String name)
Elements
의 NodeList
를 문서순서에 돌려줍니다.
name
- 일치하는 태그의 이름. 특수한 값 「*」은
모든 태그에 일치한다.
Element
노드의 리스트String getAttributeNS(String namespaceURI, String localName) throws DOMException
namespaceURI
파라미터에 null
치를 사용할 필요가 있습니다.
namespaceURI
- 취득하는 속성의 이름 공간 URIlocalName
- 취득하는 속성의 로컬명
Attr
의 값.
그 속성이 지정된 값 또는 디폴트 값를 가지지 않는 경우는 공문자열
DOMException
- NOT_SUPPORTED_ERR:구현이 「XML
」기능을 지원하고 있지 않고,
문서를 통해서 공개된 언어가 XML 이름 공간
(「HTML 4.01」등)(을)를 지원하고 있지 않는 경우void setAttributeNS(String namespaceURI, String qualifiedName, String value) throws DOMException
qualifiedName
의 전치부분으로 변경됩니다. 또, 그 값은,value
파라미터의 값으로 변경됩니다. 이 값은 단순한 캐릭터 라인이며, 설정시에 해석은 행해지지 않습니다. 그 결과, 모든 마크 업 (엔티티 참조로서 인식되는 구문을 포함한다)이 문자 텍스트라고 보여집니다. 구현은, 서두를 실시할 때, 이것을 적절한 방법으로 이스케이프 할 필요가 있습니다. 엔티티 참조를 포함한 속성치를 할당하려면 ,Attr
노드 외에 Text
노드와 EntityReference
노드를 작성할 필요가 있습니다. 다음에, 적절한 서브 트리를 구축해,setAttributeNodeNS
나 setAttributeNode
를 사용해, 이것을 속성치로서 할당합니다. namespaceURI
파라미터에 null
치를 사용할 필요가 있습니다.
namespaceURI
- 작성 또는 변경하는 속성의 이름 공간
URIqualifiedName
- 작성 또는 변경하는 속성의
수식명value
- 설정하는 값을 나타내는 캐릭터 라인
DOMException
- INVALID_CHARACTER_ERR:지정된 수식명이, 사용중의 XML 버젼
(Document.xmlVersion
속성으로 지정)
그리고 정해져 있는 XML 명이 아닌 경우
qualifiedName
가
XML 스펙의 이름 공간의 정의에 따른 것 나오지 않는 경우.
qualifiedName
가 접두사를 가져
namespaceURI
가 null
인 경우.
qualifiedName
가 접두사 「xml」를 가져,
한편 namespaceURI
가 "
http://www.w3.org/XML/1998/namespace " 와는 다른 경우. qualifiedName
또는 그 접두사가 「xmlns」로,
namespaceURI
가 "http://www.w3.org/2000/xmlns/ " 와는 다른 경우. namespaceURI
가 "http://www.w3.org/2000/xmlns/ " 이며,qualifiedName
도 그 접두사도 「xmlns」가 아닌 경우
XML
」기능을 지원하고 있지 않고,
문서를 통해서 공개된 언어가 XML 이름 공간
(「HTML 4.01」등)(을)를 지원하고 있지 않는 경우void removeAttributeNS(String namespaceURI, String localName) throws DOMException
Document.normalizeDocument()
를 사용해, 정보가 최신의 정보인 것을 보증할 필요가 있습니다. namespaceURI
파라미터에 null
치를 사용할 필요가 있습니다.
namespaceURI
- 삭제하는 속성의 이름 공간 URIlocalName
- 삭제하는 속성의 로컬명
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
XML
」기능을 지원하고 있지 않고,
문서를 통해서 공개된 언어가 XML 이름 공간
(「HTML 4.01」등)(을)를 지원하고 있지 않는 경우Attr getAttributeNodeNS(String namespaceURI, String localName) throws DOMException
Attr
노드를 가져옵니다. namespaceURI
파라미터에 null
치를 사용할 필요가 있습니다.
namespaceURI
- 취득하는 속성의 이름 공간 URIlocalName
- 취득하는 속성의 로컬명
Attr
노드.
해당하는 속성이 존재하지 않는 경우는
null
DOMException
- NOT_SUPPORTED_ERR:구현이 「XML
」기능을 지원하고 있지 않고,
문서를 통해서 공개된 언어가 XML 이름 공간
(「HTML 4.01」등)(을)를 지원하고 있지 않는 경우Attr setAttributeNodeNS(Attr newAttr) throws DOMException
namespaceURI
파라미터에 null
치를 사용할 필요가 있습니다.
newAttr
- 속성 리스트에 추가하는 Attr
노드
newAttr
속성으로 옮겨놓을 수 있는 경우는
치환의 대상이 되는 Attr
노드. 그 이외의 경우는
null
DOMException
- WRONG_DOCUMENT_ERR:요소를 작성한 문서와는 다른 문서로부터 newAttr
하지만 작성되었을 경우
newAttr
가 벌써 다른
Element
객체의 속성으로서 사용되고 있는 경우. Attr
노드를
다른 요소로 재사용하려면 , 이 노드를 DOM 사용자의 손으로 명시적으로 복제한다
필요가 있다
XML
」기능을 지원하고 있지 않고,
문서를 통해서 공개된 언어가 XML 이름 공간
(「HTML 4.01」등)(을)를 지원하고 있지 않는 경우NodeList getElementsByTagNameNS(String namespaceURI, String localName) throws DOMException
Elements
의 NodeList
를 문서순서에 돌려줍니다.
namespaceURI
- 일치하는 요소의 이름 공간 URI. 특수한
값 「*」은 모든 이름 공간에 일치하는localName
- 일치하는 요소의 로컬명. 특수한
값 「*」은 모든 로컬명에 일치한다
Elements
를 포함한 새로운 NodeList
객체
DOMException
- NOT_SUPPORTED_ERR:구현이 「XML
」기능을 지원하고 있지 않고,
문서를 통해서 공개된 언어가 XML 이름 공간
(「HTML 4.01」등)(을)를 지원하고 있지 않는 경우boolean hasAttribute(String name)
true
, 그 이외의 경우는 false
name
- 검색하는 속성의 이름
true
,
그 이외의 경우는
false
boolean hasAttributeNS(String namespaceURI, String localName) throws DOMException
true
, 그 이외의 경우는 false
를 돌려줍니다. namespaceURI
파라미터에 null
치를 사용할 필요가 있습니다.
namespaceURI
- 검색하는 속성의 이름 공간 URIlocalName
- 검색하는 속성의 로컬명
true
,
그 이외의 경우는 false
DOMException
- NOT_SUPPORTED_ERR:구현이 「XML
」기능을 지원하고 있지 않고,
문서를 통해서 공개된 언어가 XML 이름 공간
(「HTML 4.01」등)(을)를 지원하고 있지 않는 경우TypeInfo getSchemaTypeInfo()
void setIdAttribute(String name, boolean isId) throws DOMException
isId
파라미터가 true
의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. 이것은,Attr.isId
의 값과 Document.getElementById
의 동작에 영향을 미칩니다만, 사용중의 schema는 변경되지 않습니다. 특히, 지정된 Attr
노드의 Attr.schemaTypeInfo
에는 영향을 주지 않습니다. isId
파라미터의 false
치를 사용하면(자), 속성이 사용자 결정 ID 속성인 것은 선언되지 않습니다. setIdAttributeNS
메소드를 사용합니다.
name
- 속성의 이름isId
- 속성이 형태 ID 의 속성일지 어떨지를 판정
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
void setIdAttributeNS(String namespaceURI, String localName, boolean isId) throws DOMException
isId
파라미터가 true
의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. 이것은,Attr.isId
의 값과 Document.getElementById
의 동작에 영향을 미칩니다만, 사용중의 schema는 변경되지 않습니다. 특히, 지정된 Attr
노드의 Attr.schemaTypeInfo
에는 영향을 주지 않습니다. isId
파라미터의 false
치를 사용하면(자), 속성이 사용자 결정 ID 속성인 것은 선언되지 않습니다.
namespaceURI
- 속성의 이름 공간 URIlocalName
- 속성의 로컬명isId
- 속성이 형태 ID 의 속성일지 어떨지를 판정
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
void setIdAttributeNode(Attr idAttr, boolean isId) throws DOMException
isId
파라미터가 true
의 경우, 이 메소드는 지정된 속성이 사용자 결정 ID 속성인 것을 선언합니다. 이것은,Attr.isId
의 값과 Document.getElementById
의 동작에 영향을 미칩니다만, 사용중의 schema는 변경되지 않습니다. 특히, 지정된 Attr
노드의 Attr.schemaTypeInfo
에는 영향을 주지 않습니다. isId
파라미터의 false
치를 사용하면(자), 속성이 사용자 결정 ID 속성인 것은 선언되지 않습니다.
idAttr
- 속성 노드isId
- 속성이 형태 ID 의 속성일지 어떨지를 판정
DOMException
- NO_MODIFICATION_ALLOWED_ERR:이 노드가 읽어내 전용의 경우
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.