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 integerHTMLElement.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