Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

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();

Ou

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.

Etiquetas do documento e colaboradores

 Colaboradores para esta página: teoli, danielwebsistemas
 Última atualização por: teoli,