Seleção

Selection.anchorNodeSomente leitura

Retorna o Node onde a seleção começou.

Selection.anchorOffsetSomente leitura

Retorna um número representando o deslocamento do anchor dentro do elemento Se o elemento for do tipo text node, o número retornado será o número de caracteres no elemento que precedem o anchor (clique inicial da seleção). Se o elemento for do tipo element (qualquer tag html que não seja text node), o número retornado será o número de nós filhos do elemento que precedem o anchor.

Selection.focusNodeSomente leitura

Retorna o Node onde a seleção termina.

Selection.focusOffsetSomente leitura

Retorna um número representando o deslocamento do focus dentro do elemento Se o elemento for do tipo text node, o número retornado será o número de caracteres no elemento que precedem o focus (posição onde o mouse foi solto). Se o elemento for do tipo element (qualquer tag html que não seja text node), o número retornado será o número de nós filhos do elemento que precedem o focus.

Selection.isCollapsedSomente leitura

Retorna um valor booleano indicando se o início e o final da seleção são a mesma posição, ou seja, começou e terminou no mesmo lugar.

Selection.rangeCountSomente leitura

Retorna no número de intervalos da seleção.

Selection.typeSomente leitura

Retorna um DOMString descrevento o tipo da seleção atual.

Selection.addRange()

Um objeto Range que será adicionado na seleção.

Selection.collapse()

Colapsa a seleção atual em um único ponto.

Selection.collapseToEnd()

Colapsa a seleção para o final do último intervalo na seleção.

Selection.collapseToStart()

Colapsa a seleção para o início do primeiro intervalo na seleção.

Selection.containsNode()

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

Selection.deleteFromDocument()

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

Selection.empty()

Remove todos os intervalos da seleção. Este é um apelido para removeAllRanges() — Veja Selection.removeAllRanges() para mais detalhes.

Selection.extend()

Move o focus (final da seleção) para um ponto específico.

Selection.getRangeAt()

Retorna um objeto Range represetando um dos intervalos atualmente selecionados.

Selection.modify() Non-standard

Altera a seleção atual.

Selection.removeRange()

Remove um intervalo da seleção.

Selection.removeAllRanges()

Remove todos os intervalos da seleção.

Selection.selectAllChildren()

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

Selection.setBaseAndExtent()

Define que a seleção será um intervalo incluindo todos ou partes dos dois nós DOM especificados, e qualquer conteúdo entre esses nós.

Selection.setPosition()

Colapsa a seleção atual para um único ponto. Este é um apelido para collapse() — Veja Selection.collapse() para mais detalhes.

Selection.toString()

Retorna uma string atualmente representada pelo objeto selection, i.e. o texto atualmente selecionado.

Chamando a função Selection.toString() retorna o texto selecionado, e.g.:

var selObj = window.getSelection();
window.alert(selObj);

Perceba que usando um objeto selection como argumento de window.alert executará o metodo toString automaticamente.

Um objeto selection representa os intervalos que o usuário selecionou. Normalmente é apenas um intervalo, acessado da seguinte forma:

var selObj = window.getSelection();
var range = selObj.getRangeAt(0);

• selObj é um objeto selection
• range é um objeto Range

Como consta nas Especificações da API de seleção, a API foi inicialmente criada pela Netscape e usados multiplos intervalos, por instância, para permitir ao usuário selecionar uma coluna de uma <table>. Outros navegadores como Gecko não implementaram multiplos intervalos, e a especificação exige que a seleção sempre tenha um único intervalo.

Seleção e foco de input (indicado por Document.activeElement) tem uma relação complexa, que depende do navegador. Para um código compatível com vários navegadores, o melhor é manter os códigos separados.

O Safari e o Chrome (ao contrário do Firefox) historicamente foca no elemento contendo a seleção quando a seleção é modificada programaticamente, mas isto pode mudar no futuro (veja W3C bug 14383 e WebKit bug 38696).

A API de Seleção tem um comportamento comum (i.e. compartilhado entre navegadores) que define como o comportamento do foco muda para elemento editável, após alguns desses métodos serem executados.

Os comportamentos são que um elemento editado recebe o foco se anteriormente a seleção estiver fora dele, então um método da API de seleção é executado e causa uma nova seleção que será feita em um único intervalo dentro do elemento sendo editado. O foco então é movido para o final do elemento.

O comportamento acima é aplicado para as seleções feitas usando os seguintes métodos:

• Selection.collapse()
• Selection.collapseToStart()
• Selection.collapseToEnd()
• Selection.extend()
• Selection.selectAllChildren()
• Selection.addRange()
• Selection.setBaseAndExtent()

e quando o intervalo é modificado usando os seguintes métodos:

• Range.setStart()
• Range.setEnd()
• Range.setStartBefore()
• Range.setStartAfter()
• Range.setEndBefore()
• Range.setEndAfter()
• Range.collapse()
• Range.selectNode()
• Range.selectNodeContents()

Outras palavras chaves usadas nesta seção.

anchor

O anchor de uma seleção é o ponto inicial da seleção. Quando a seleção é feita com um mouse, é onde o botão do mouse é inicialmente pressionado. Quando o usuário altera a seleção usando o mouse ou teclado, o anchor não move.

Elemento editável

Um elemento editável — i.e. um elemento HTML com o atributo contenteditable definido, ou o HTML filho de um documento estiver com o designMode habilitado.

foco de uma seleção

O foco da seleção é o ponto final da seleção. Quando feita a seleção com um mouse, o focus é onde o botão do mouse foi solto. Quando o usuário muda a seleção usando o mouse ou teclado, o focus é o final da seleção que move. Nota: Não é o mesmo que o elemento selecionado do documento, como retornado em document.activeElement.

intervalo

Um intervalo é uma parte contínua do documento. Um intervalo pode conter nós inteiros ou partes de nós, como uma parte de um text node. Um usuário normalmente irá selecionar um único intervalo por vez, mas é possível que o usuário selecione multiplos intervalos (e.g. usando a tecla Control). Um intervalo pode ser obtido de uma seleção como um objeto range. Um objeto de intervalo pode ser criado no DOM e programaticamente adicionada ou removida de uma seleção.

• Window.getSelection, Document.getSelection, Range
• Selection-related events: selectionchange and selectstart
• HTML inputs provide simpler helper APIs for working with selection (see HTMLInputElement.setSelectionRange())
• Document.activeElement, HTMLElement.focus(), and HTMLElement.blur()