Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

ondragstart — obsługa początku przeciągania

Atrybut ondragstart definiuje kod JavaScript wykonywany przy zdarzeniu dragstart, gdy rozpoczyna się przeciąganie. Pozwala przygotować dane operacji lub anulować jej rozpoczęcie; sam nie sprawia, że element staje się przeciągalny.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

ondragstart="JavaScript statements"

ondragstart to atrybut obsługi zdarzenia dostępny dla elementów HTML. Jego wartością jest kod JavaScript, a nie wartość logiczna. Reaguje na dragstart na początku operacji przeciągania, nie na każdy ruch wskaźnika.

W kodzie atrybutu event oznacza obiekt zdarzenia DragEvent. Podczas natywnego dragstart magazyn danych jest dostępny do odczytu i zapisu: event.dataTransfer.setData('text/plain', 'Hello') ustawia przesyłany tekst. Wywołanie event.preventDefault() lub wykonanie return false w tej procedurze anuluje rozpoczęcie przeciągania.

Sam ondragstart nie włącza przeciągania. Dla zwykłego elementu źródłowego można ustawić draggable="true". ondragstart jest też nazwą właściwości JavaScript przyjmującej funkcję; przy użyciu addEventListener nazwą zdarzenia jest dragstart, bez prefiksu on.

Przykład celowo anuluje operację po zmianie komunikatu. Pokazuje obsługę początku przeciągania, a nie kompletny mechanizm upuszczania.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragstart example</title>
<p draggable="true"
   ondragstart="document.getElementById('status').textContent = 'dragstart: canceled'; event.preventDefault();">
  Drag this text.
</p>
<p id="status" role="status">Ready</p>
</html>

Wynik

dragstart: canceled

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła