Range

Range (문서 내용 범위)

Range 인터페이스는 문서의 내용 일부를 나타내는 범위(range)를 다루기 위한 객체예요.

출처: Java API Reference

본문

Range는 문서의 한 지점에서 다른 지점까지의 콘텐츠 조각을 나타내며, 문서 내용을 선택, 복사, 이동, 삭제하는 데 사용돼요. 인접 노드 경계 간의 비교를 위해 다음 상수를 제공해요.

  • START_TO_START, START_TO_END, END_TO_END, END_TO_START

시작 위치와 끝 위치는 각각 컨테이너 노드(getStartContainer, getEndContainer)와 오프셋(getStartOffset, getEndOffset)으로 표현돼요. 범위가 축소되었는지를 getCollapsed()로, 공통 조상 컨테이너를 getCommonAncestorContainer()로 확인할 수 있어요.

범위의 위치는 setStart, setEnd, setStartBefore, setStartAfter, setEndBefore, setEndAfter, collapse, selectNode, selectNodeContents 메서드로 설정할 수 있어요. 잘못된 노드 타입이나 경계점이 지정되면 RangeException이 발생할 수 있어요.

내용을 다루는 메서드로는 deleteContents, extractContents, cloneContents, insertNode, surroundContents, cloneRange가 있어요. 모두 잘못된 사용 시 DOMException이나 RangeException을 던질 수 있어요.

더 알아보기 (Learn more)

Java 공식 API