Range (Intervalo)

Introdução

O objeto Range representa um fragmento de um documento que pode conter partes de nós e nós de texto em um determinado documento. Um intervalo pode ser criado usando o método createRange do objeto Document. Objetos Range também podem ser recuperadas usando o método getRangeAt do objeto Selection.

range = document.createRange();

selection = window.getSelection();
range = selection.getRangeAt(0);

Propriedades

collapsed: Retorna um booleano indicando se o intervalo de pontos de início e fim estão na mesma posição.
commonAncestorContainer: Retorna o nó mais profundo que contém o startContainer e nós EndContainer.
endContainer: Retorna o nó em que o intervalo termina.
endOffset: Retorna um número que representa onde no EndContainer o intervalo termina.
startContainer: Retorna o nó em que o intervalo começa.
startOffset: Retorna um número que representa onde no startContainer o intervalo começa.

Métodos

Métodos de Posicionamento

Estes métodos definem o início e o fim de um intervalo.

collapse: Recolhe o intervalo para um dos seus pontos de fronteira.
selectNode: Define o intervalo para conter o nó e seu conteúdo.
selectNodeContents: Define o intervalo para conter o conteúdo de um nó.
setStart: Define a posição inicial de um intervalo.
setEnd: Define a posição final de um intervalo.
setStartBefore: Define a posição inicial de um intervalo em relação a outro nó.
setStartAfter: Define a posição inicial de um intervalo em relação a outro nó.
setEndBefore: Define a posição final de um intervalo em relação a outro nó.
setEndAfter: Define a posição final de um intervalo em relação a outro nó.

Métodos de Edição

Estes métodos recuperam nós de um intervalo e modificam o conteúdo de um intervalo.

cloneContents: Retorna um fragmento de documento copiando os nós de um intervalo.
deleteContents: Remove o conteúdo de um intervalo do documento.
extractContents: Move o conteúdo de um intervalo da árvore do documento em um fragmento de documento.
insertNode: Inserir um nó no início de um intervalo.
surroundContents: Move o conteúdo de um intervalo em um novo nó.

Outros Métodos

compareBoundaryPoints: Compara os pontos de fronteira dos dois intervalos.
cloneRange: Retorna um objeto Range com pontos de fronteira idêntica à faixa clonada.
detach: Lançamentos do intervalo de utilização para melhorar a performance.
toString: Retorna o texto do intervalo.