이 글은 기술 검토가 필요합니다. 도울을 줄 수 있는 방법을 살펴보세요.

이 글은 편집 검토가 필요합니다. 도울을 줄 수 있는 방법을 살펴보세요.

현재 번역은 완벽하지 않습니다. 한국어로 문서 번역에 동참해주세요.

Range 객체는 주어진 document 내의 텍스트 노드들의 부분들(parts)과 document의 단편화에 포함된 노드들을 나타내고 있다.

Range 오브젝트는 Document 객체에 포함되어 있는 createRange 메소드를 사용하여 생성할 수 있다. 또한 selection 객체에 포함되어 있는 getRangeAt 메소드를 사용하여 추출할 수 있다.

Range() 생성자 또한 사용 가능하다.

Properties

collapsed
Range의 시작점과 끝점이 같인 위치인지를 알 수 있는 boolean 값을 반환 한다.
commonAncestorContainer
startContainer와 endContainer 노드들을 포함한 최상위 노드를 반환 한다.
endContainer
Range의 끝 위치를 포함하는 Node를 반환 한다.
endOffset
endContainer 안에 있는 Range 끝을 나타내는 숫자(offset)를 반환 한다.
startContainer
Range의 시작 위치를 포함하는 Node를 반환 한다.
startOffset
startContainer 안에 있는 Range 시작을 나타내는 숫자(offset)를 반환 한다.

생성자

Range()
Range 객체의 시작과 끝에 따라 전역 Document 와 함께 Range 객체를 봔환한다.

메소드들

상속한 메소드들은 없다.

Range.setStart()
Range 의 시작 위치를 설정 한다.
Range.setEnd()
Range 의 끝 위치를 설정 한다.
Range.setStartBefore()
다른 Node 와 관계가 있는 Range 의 시작 위치를 설정 한다.
Range.setStartAfter()
다른 Node 와 관계가 있는 Range 의 시작 위치를 설정 한다.
Range.setEndBefore()
다른 Node 와 관계가 있는 Range 의 끝 위치를 설정 한다.
Range.setEndAfter()
다른 Node 와 관계가 있는 Range 의 끝 위치를 설정 한다.
Range.selectNode()
Range 에 Node 와 그것의 내용물을 포함 시킨.
Range.selectNodeContents()
Range 에 Node 의 내용물을 포함 시킨.
Range.collapse()
Range 의 경계 지점 중 하나로 영역을 붕괴 시킨다.
Range.cloneContents()
Range 의 노드들을 복사하여 DocumentFragment 를 반환 한다.
Range.deleteContents()
Document 로 부터 Range 의 컨텐츠들을 삭제한다.
Range.extractContents()
Document 트리로 부터 Range 의 컨텐츠들을 domxref("DocumentFragment") }} 로 이동시킨다.
Range.insertNode()
Insert a Node at the start of a Range.
Range.surroundContents()
Moves content of a Range into a new Node.
Range.compareBoundaryPoints()
Compares the boundary points of the Range with another Range.
Range.cloneRange()
Returns a Range object with boundary points identical to the cloned Range.
Range.detach()
Releases the Range from use to improve performance.
Range.toString()
Returns the text of the Range.
Range.compareNode()
Returns a constant representing whether the Node is before, after, inside, or surrounding the range.
Range.comparePoint()
Returns -1, 0, or 1 indicating whether the point occurs before, inside, or after the Range.
Range.createContextualFragment()
Returns a DocumentFragment created from a given string of code.
Range.getBoundingClientRect()
Returns a ClientRect object which bounds the entire contents of the Range; this would be the union of all the rectangles returned by range.getClientRects().
Range.getClientRects()
Returns a list of ClientRect objects that aggregates the results of Element.getClientRects() for all the elements in the Range.
Range.intersectsNode()
Returns a boolean indicating whether the given node intersects the Range.
Range.isPointInRange()
Returns a boolean indicating whether the given point is in the Range.

Specifications

Specification Status Comment
DOM
The definition of 'Range' in that specification.
Living Standard Do not use RangeException anymore, useDOMException instead.
Made the second parameter of collapse() optional.
Added the methods isPointInRange(),comparePoint(), and intersectsNode().
Added the constructor Range().
DOM Parsing and Serialization
The definition of 'Extensions to Range' in that specification.
Living Standard Added the method createContextualFragment().
CSS Object Model (CSSOM) View Module
The definition of 'Extensions to Range' in that specification.
Working Draft Added the methods getClientRects() andgetBoundingClientRect().
Document Object Model (DOM) Level 2 Traversal and Range Specification
The definition of 'Range' in that specification.
Recommendation Initial specification.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) 1.0 (1.7 or earlier) [1] 9.0 9.0 (Yes)
Range() constructor (Yes) 24.0 (24.0) Not supported 15.0 (Yes)
compareNode()  Not supported 1.0 (1.7 or earlier)
Removed in 3.0 (1.9)
Not supported Not supported Not supported
isPointInRange(), and comparePoint() (Yes) (Yes) Not supported 15.0 ?
intersectsNode()  (Yes) 17.0 (17.0) [2] Not supported 15.0 ?
getClientRects() and getBoundingClientRect() (Yes) 4.0 (2.0) 9 15.0 5
createContextualFragment() (Yes) (Yes) Not supported 15.0 ?
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0) [1] 9.0 9.0 (Yes)

[1] Starting with Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10) the Range object throws a DOMException as defined in DOM 4, instead of a RangeException defined in prior specifications.

[2] Gecko supported it up to Gecko 1.9, then removed it until Gecko 17 where it was reimplemented, matching the spec.

See also

 

문서 태그 및 공헌자

태그: 
 이 페이지의 공헌자: gblue1223, pjc0247, coremaker, fscholz, khalid32, teoli, pusanbear
 최종 변경: gblue1223,