Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 integer

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

Źródła