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.