CKTIS / JavaScript
`HTMLElement.draggable` i `tabIndex`: przeciąganie i fokus
`draggable` określa, czy element może być źródłem przeciągania. `tabIndex` wpływa na to, czy i kiedy można przejść do elementu klawiszem Tab. Jedno ustawienie nie zastępuje drugiego.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
element.draggable
element.draggable = true; // or false
element.tabIndex
element.tabIndex = 0; // or another integerHTMLElement.draggable odczytuje i ustawia wartość logiczną określającą, czy element HTML może być źródłem natywnego przeciągania. Przypisanie true lub false zapisuje w atrybucie draggable tekst "true" lub "false". Atrybut jest wyliczeniowy, a nie logiczny: sama jego obecność nie włącza przeciągania. Brak atrybutu lub nieprawidłowa wartość oznacza tryb automatyczny: np. obrazy i odsyłacze z href są domyślnie przeciągalne, a zwykły div nie. Aby przywrócić ten tryb, usuń atrybut zamiast ustawiać false.
HTMLElement.tabIndex odczytuje liczbę całkowitą i przy zapisie ustawia atrybut tabindex. Wartość 0 zwykle włącza element do naturalnej kolejności nawigacji klawiszem Tab. Wartość ujemna, zazwyczaj -1, zwykle pomija element w tej kolejności, ale nadal pozwala ustawić na nim fokus przez focus(), jeśli element może go przyjąć. Wartości dodatnie w danym zakresie nawigacji mają pierwszeństwo przed 0 i domyślnymi pozycjami: najpierw mniejsze wartości, a przy remisie decyduje kolejność w drzewie. Unikaj ich na rzecz logicznej kolejności w dokumencie. Bez atrybutu button zwraca zwykle 0, a zwykły div — -1; sam odczyt nie gwarantuje, że element przyjmie fokus, np. gdy jest wyłączony lub znajduje się w obszarze inert.
To właściwości przeglądarkowego API HTML, a nie część ECMAScript 2024. Ustawienie tabIndex nie daje obsługi przeciągania klawiaturą, a ustawienie draggable nie definiuje działania po upuszczeniu. Zachowanie zależy od przeglądarki, platformy i sposobu wprowadzania danych. Przy zmianie kolejności elementów zapewnij też np. przyciski „Przenieś w górę” i „Przenieś w dół”, działające klawiaturą i dotykiem.
Przykłady
<!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>Wynik
[false,-1,null,null] [true,0,"true","0"] [true,-1,"true","-1"]
Zapisz przykład jako plik `.html`, otwórz go w przeglądarce i sprawdź wynik w konsoli deweloperskiej. Każdy wiersz pokazuje dwie właściwości, a potem odpowiadające im atrybuty. `null` oznacza brak atrybutu. Zmiana `tabIndex` na `-1` nie zmienia `draggable`; przykład nie testuje gestów ani przepływu fokusu.
Powiązane lekcje
- JavaScript · Lekcja 34 · Średniozaawansowany · Wersja: 3