diff options
Diffstat (limited to 'files/pt-pt/web/api/selection')
-rw-r--r-- | files/pt-pt/web/api/selection/index.html | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/files/pt-pt/web/api/selection/index.html b/files/pt-pt/web/api/selection/index.html new file mode 100644 index 0000000000..a33e618def --- /dev/null +++ b/files/pt-pt/web/api/selection/index.html @@ -0,0 +1,76 @@ +--- +title: Selection (Seleção) +slug: DOM/Selection +translation_of: Web/API/Selection +--- +<h3 id="Introduction" name="Introduction">Introdução</h3> + +<p>Selection é a classe do objeto retornado por <code><a href="/en/DOM/window.getSelection" title="en/DOM/window.getSelection">window.getSelection()</a></code> e outros métodos. Um objeto Selection representa os intervalos que o usuário tenha selecionado. Normalmente, ele tem apenas um intervalo, acessada assim:</p> + +<pre>selection = window.getSelection(); +range = selection.getRangeAt(0);</pre> + +<p>Chamar o método <code><a href="/en/DOM/Selection/toString" title="en/DOM/Selection/toString">toString()</a></code> retorna o texto contido na seleção, por exemplo:</p> + +<pre>selection = window.getSelection(); +window.alert(selection); +</pre> + +<h3 id="Glossário">Glossário</h3> + +<p>Outros termos utilizados nesta seção.</p> + +<dl> + <dt>Âncora (anchor)</dt> + <dd>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.</dd> + <dt>Foco (focus)</dt> + <dd>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.</dd> + <dt>Intervalo (range)</dt> + <dd>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.</dd> +</dl> + +<h3 id="Properties" name="Properties">Propriedades</h3> + +<dl> + <dt><a href="/en/DOM/Selection/anchorNode" title="en/DOM/Selection/anchorNode">anchorNode</a></dt> + <dd>Retorna o nó em que a seleção começa.</dd> + <dt><a href="/en/DOM/Selection/anchorOffset" title="en/DOM/Selection/anchorOffset">anchorOffset</a></dt> + <dd>Retorna o número de caracteres que a âncora da seleção é compensada dentro do anchorNode.</dd> + <dt><a href="/en/DOM/Selection/focusNode" title="en/DOM/Selection/focusNode">focusNode</a></dt> + <dd>Retorna o nó em que a seleção termina.</dd> + <dt><a href="/en/DOM/Selection/focusOffset" title="en/DOM/Selection/focusOffset">focusOffset</a></dt> + <dd>Retorna o número de caracteres que o foco da seleção é compensado dentro do focusNode.</dd> + <dt><a href="/en/DOM/Selection/isCollapsed" title="en/DOM/Selection/isCollapsed">isCollapsed</a></dt> + <dd>Retorna um booleano indicando se os pontos de início e fim da seleção estão na mesma posição.</dd> + <dt><a href="/en/DOM/Selection/rangeCount" title="en/DOM/Selection/rangeCount">rangeCount</a></dt> + <dd>Retorna o número de faixas na seleção.</dd> +</dl> + +<h3 id="Methods" name="Methods">Métodos</h3> + +<dl> + <dt><a href="/en/DOM/Selection/addRange" title="en/DOM/Selection/addRange">addRange</a></dt> + <dd>Um objeto de intervalo (Range) que será adicionado à seleção.</dd> + <dt><a href="/en/DOM/Selection/collapse" title="en/DOM/Selection/collapse">collapse</a></dt> + <dd>Recolhe a seleção atual para um único ponto.</dd> + <dt><a href="/en/DOM/Selection/collapseToStart" title="en/DOM/Selection/collapseToStart">collapseToStart</a></dt> + <dd>Move o foco da seleção para o mesmo ponto da âncora.</dd> + <dt><a href="/en/DOM/Selection/collapseToEnd" title="en/DOM/Selection/collapseToEnd">collapseToEnd</a></dt> + <dd>Move a âncora da seleção para o mesmo ponto que o foco. O foco não se move.</dd> + <dt><a href="/en/DOM/Selection/containsNode" title="en/DOM/Selection/containsNode">containsNode</a></dt> + <dd>Indica se um determinado nó é parte da seleção.</dd> + <dt><a href="/en/DOM/Selection/deleteFromDocument" title="en/DOM/Selection/deleteFromDocument">deleteFromDocument</a></dt> + <dd>Apaga o conteúdo da seleção do documento.</dd> + <dt><a href="/en/DOM/Selection/extend" title="en/DOM/Selection/extend">extend</a></dt> + <dd>Move o foco da seleção para um ponto especificado.</dd> + <dt><a href="/en/DOM/Selection/getRangeAt" title="en/DOM/Selection/getRangeAt">getRangeAt</a></dt> + <dd>Retorna um objeto de intervalo (Range) representando um dos intervalos atualmente selecionados.</dd> + <dt><a href="/en/DOM/Selection/removeAllRanges" title="en/DOM/Selection/removeAllRanges">removeAllRanges</a></dt> + <dd>Remove todos os intervalos da seleção.</dd> + <dt><a href="/en/DOM/Selection/removeRange" title="en/DOM/Selection/removeRange">removeRange</a></dt> + <dd>Remove uma faixa (range) da seleção.</dd> + <dt><a href="/en/DOM/Selection/selectAllChildren" title="en/DOM/Selection/selectAllChildren">selectAllChildren</a></dt> + <dd>Adiciona todos os filhos do nó especificado para a seleção.</dd> + <dt><a href="/en/DOM/Selection/toString" title="en/DOM/Selection/toString">toString</a></dt> + <dd>Retorna uma string a ser representada pelo objeto de seleção, ou seja, o texto atualmente selecionado.</dd> +</dl> |