Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

`HTMLElement.draggable` e `tabIndex`: arrastamento e foco

`draggable` controla se um elemento pode ser a origem de um arrastamento. `tabIndex` influencia se o elemento é alcançado pela tecla Tab e em que ordem. Uma propriedade não substitui a outra.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

element.draggable
 element.draggable = true;  // or false
 element.tabIndex
 element.tabIndex = 0;     // or another integer

HTMLElement.draggable lê e define um booleano que indica se o elemento HTML pode ser a origem de um arrastamento nativo. Atribuir true ou false escreve o texto "true" ou "false" no atributo draggable. O atributo é enumerado, não booleano: a sua simples presença não ativa o arrastamento. Se estiver ausente ou tiver um valor inválido, aplica-se o modo automático: por exemplo, as imagens e as ligações com href podem ser arrastadas, mas um div normal não. Para repor esse modo, remove o atributo em vez de atribuir false.

HTMLElement.tabIndex lê um inteiro e, ao receber um valor, escreve o atributo tabindex. 0 normalmente inclui o elemento na ordem natural de tabulação. Um valor negativo, geralmente -1, costuma excluí-lo dessa ordem, mas permite usar focus() se o elemento puder receber o foco. No mesmo âmbito de navegação do foco, os valores positivos precedem 0 e as posições predefinidas: primeiro os menores e, em caso de empate, segue-se a ordem da árvore. Evita valores positivos e usa uma ordem lógica no documento. Sem o atributo, um button normalmente devolve 0 e um div normal devolve -1; a leitura por si só não garante que o foco possa ser atribuído, por exemplo num controlo desativado ou numa região inert.

Estas são API de HTML do navegador e não fazem parte do ECMAScript 2024. tabIndex não implementa o arrastamento pelo teclado e draggable não define o que acontece ao largar. O comportamento depende do navegador, da plataforma e do método de introdução de dados. Para reordenar elementos, disponibiliza também botões como «Mover para cima» e «Mover para baixo», utilizáveis com o teclado e por toque.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>draggable and tabIndex</title>
</head>
<body>
  <script>
    const element = document.createElement('div');
    const report = () => console.log(JSON.stringify([
      element.draggable, element.tabIndex,
      element.getAttribute('draggable'), element.getAttribute('tabindex')
    ]));

    report();
    element.draggable = true;
    element.tabIndex = 0;
    report();
    element.tabIndex = -1;
    report();
  </script>
</body>
</html>

Resultado

[false,-1,null,null]
[true,0,"true","0"]
[true,-1,"true","-1"]

Guarda o exemplo num ficheiro `.html`, abre-o no navegador e consulta a consola de programador. Cada linha mostra as duas propriedades, seguidas dos respetivos atributos. `null` indica que o atributo está ausente. Alterar `tabIndex` para `-1` não muda `draggable`; o exemplo não testa gestos nem a mudança de foco.

Lições relacionadas

  • JavaScript · Lição 34 · Intermédio · Versão: 3

Fontes