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

CKTIS / HTML

termo ou valor HTML: draggable

O atributo `draggable` controla se um elemento pode iniciar arrasto nativo, mas não implementa por si só transferência de dados nem uma interação de teclado acessível.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<div draggable="true">…</div>

draggable é um atributo enumerado com os tokens true e false; valor ausente ou inválido produz o estado auto. Nesse estado, imagens e ligações com endereço mantêm o arrasto nativo, enquanto um contentor comum não é arrastável por predefinição.

Usa draggable="false" para desativar explicitamente o arrasto nativo de uma imagem ou ligação. Num arrasto personalizado, trata dragstart e coloca tipo e conteúdo adequados em DataTransfer; o atributo não define o destino.

Arrastar e largar depende de um dispositivo apontador e não é uma interação acessível completa. Disponibiliza botões ou outro controlo de teclado para reordenar e anuncia o resultado; o arrasto não pode ser a única via.

O exemplo compara um elemento com draggable="true" e uma imagem sem o atributo. A propriedade draggable devolve true para ambos: pelo token explícito do primeiro e pela predefinição automática da imagem.

Exemplos

<!doctype html><meta charset="utf-8"><img id="auto" alt=""><div id="x" draggable="true">Drag</div><output id="result"></output><script>result.textContent=`explicit=${x.draggable}; imageDefault=${auto.draggable}; raw=${x.getAttribute("draggable")}`;</script>

Resultado

explicit=true; imageDefault=true; raw=true

O exemplo executado verifica a diferença entre o token explícito de um elemento comum e a predefinição nativa de uma imagem.

Fontes