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.

Document Tags and Contributors

Contributors to this page: danielwebsistemas
Last updated by: danielwebsistemas,