Selection (Seleção)

Introdução

Selection é a classe do objeto retornado por window.getSelection() e outros métodos. Um objeto Selection representa os intervalos que o usuário tenha selecionado. Normalmente, ele tem apenas um intervalo, acessada assim:

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

Chamar o método toString() retorna o texto contido na seleção, por exemplo:

selection = window.getSelection();
window.alert(selection);

Glossário

Outros termos utilizados nesta seção.

Âncora (anchor)

A âncora de uma seleção é o ponto de início da seleção. Ao fazer uma seleção com um mouse, a âncora no documento é o local onde o botão do mouse é inicialmente pressionado. Como o usuário muda a seleção usando o mouse ou o teclado, a âncora não se move.

Foco (focus)

O foco da seleção é o ponto final da seleção. Ao fazer uma seleção com o mouse, o foco está no documento onde o botão do mouse é liberado. Como o usuário muda a seleção usando o mouse ou o teclado, o foco é a final da seleção que se move.

Intervalo (range)

Um intervalo é uma parte contígua de um documento. Um intervalo pode conter nós inteiro, bem como partes de nós, como uma parte de um nó de texto. Um usuário normalmente só seleciona um intervalo de cada vez, mas é possível que um usuário selecione vários intervalos (por exemplo, usando a tecla Control). Um intervalo pode ser recuperado a partir de uma seleção como um objeto Range. Objetos Range também podem ser criadas através do DOM e programaticamente adicionado ou removido de uma seleção.

Propriedades

anchorNode

Retorna o nó em que a seleção começa.

anchorOffset

Retorna o número de caracteres que a âncora da seleção é compensada dentro do anchorNode.

focusNode

Retorna o nó em que a seleção termina.

focusOffset

Retorna o número de caracteres que o foco da seleção é compensado dentro do focusNode.

isCollapsed

Retorna um booleano indicando se os pontos de início e fim da seleção estão na mesma posição.

rangeCount

Retorna o número de faixas na seleção.

Métodos

addRange

Um objeto de intervalo (Range) que será adicionado à seleção.

collapse

Recolhe a seleção atual para um único ponto.

collapseToStart

Move o foco da seleção para o mesmo ponto da âncora.

collapseToEnd

Move a âncora da seleção para o mesmo ponto que o foco. O foco não se move.

containsNode

Indica se um determinado nó é parte da seleção.

deleteFromDocument

Apaga o conteúdo da seleção do documento.

extend

Move o foco da seleção para um ponto especificado.

getRangeAt

Retorna um objeto de intervalo (Range) representando um dos intervalos atualmente selecionados.

removeAllRanges

Remove todos os intervalos da seleção.

removeRange

Remove uma faixa (range) da seleção.

selectAllChildren

Adiciona todos os filhos do nó especificado para a seleção.

toString

Retorna uma string a ser representada pelo objeto de seleção, ou seja, o texto atualmente selecionado.