Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

`HTMLElement.draggable` e `tabIndex`: trascinamento e focus

`draggable` controlla se un elemento può essere l’origine di un trascinamento. `tabIndex` influisce sulla sua raggiungibilità con Tab e sull’ordine di navigazione. Le due proprietà non si sostituiscono.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

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

HTMLElement.draggable legge e imposta un booleano che indica se l’elemento HTML può essere l’origine di un trascinamento nativo. Assegnare true o false scrive il testo "true" o "false" nell’attributo draggable. L’attributo è enumerato, non booleano: la sua sola presenza non abilita il trascinamento. Se è assente o contiene un valore non valido, si usa il comportamento automatico: ad esempio, le immagini e i link con href sono trascinabili, un normale div no. Per ripristinare tale comportamento, rimuovi l’attributo invece di impostare false.

HTMLElement.tabIndex legge un intero e, quando viene impostato, scrive l’attributo tabindex. 0 normalmente include l’elemento nell’ordine naturale di tabulazione. Un valore negativo, di solito -1, normalmente lo esclude, ma focus() resta utilizzabile se l’elemento può ricevere il focus. Nello stesso ambito di navigazione del focus, i valori positivi precedono 0 e le posizioni predefinite: prima i valori più bassi e, a parità di valore, vale l’ordine nell’albero. Evita i valori positivi e usa un ordine logico nel documento. Senza l’attributo, un button normalmente restituisce 0 e un normale div restituisce -1; leggere il valore non garantisce che il focus possa essere assegnato, ad esempio a un controllo disabilitato o in una regione inert.

Queste sono API HTML del browser, non fanno parte di ECMAScript 2024. tabIndex non implementa il trascinamento da tastiera e draggable non stabilisce che cosa accade al rilascio. Il comportamento dipende dal browser, dalla piattaforma e dal metodo di input. Per riordinare gli elementi, offri anche pulsanti come «Sposta su» e «Sposta giù», utilizzabili con tastiera e touch.

Esempi

<!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>

Risultato

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

Salva l’esempio come file `.html`, aprilo in un browser e controlla la console per sviluppatori. Ogni riga mostra le due proprietà seguite dai relativi attributi. `null` indica che l’attributo è assente. Impostare `tabIndex` a `-1` non modifica `draggable`; l’esempio non verifica i gesti né lo spostamento del focus.

Lezioni correlate

  • JavaScript · Lezione 34 · Intermedio · Versione: 3

Fonti