Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

ondragenter — obsługa wejścia przeciąganego obiektu

Atrybut ondragenter definiuje kod JavaScript uruchamiany przy zdarzeniu dragenter, gdy przeciągany obiekt znajdzie się nad elementem docelowym. Pozwala zareagować na wejście nad cel, ale sam nie obsługuje upuszczenia.

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

Składnia

ondragenter="JavaScript statements"

ondragenter jest atrybutem obsługi zdarzenia dragenter, dostępnym na elementach HTML. Jego wartość zawiera instrukcje JavaScript, a nie samą nazwę funkcji: wywołanie funkcji wymaga nawiasów. W kodzie atrybutu event oznacza przekazane zdarzenie. Odpowiadająca mu właściwość JavaScript, element.ondragenter, przyjmuje funkcję albo null.

dragenter sygnalizuje wejście przeciąganego obiektu nad cel; nie oznacza upuszczenia. Zdarzenie propaguje się w górę drzewa i można je anulować. W modelu przetwarzania określonym przez standard HTML anulowanie dragenter jest jednym ze sposobów wyznaczenia bieżącego celu operacji przeciągania i upuszczania. W praktyce współczesne przeglądarki nie wymagają anulowania dragenter, aby umożliwić upuszczenie. Aby własny cel mógł przyjąć upuszczenie, wywołaj event.preventDefault() w procedurze obsługi dragover, a upuszczenie obsłuż w procedurze obsługi drop. W odróżnieniu od ondragenter, ondragover uruchamia się wielokrotnie, gdy obiekt pozostaje nad celem.

Przykład wysyła syntetyczne zdarzenie dragenter, aby wynik był powtarzalny bez ręcznego przeciągania. Po kliknięciu Run test wynik to dragenter: true: potwierdza to jedynie, że wywołanie event.preventDefault() w kodzie atrybutu anulowało wysłane zdarzenie. Test nie sprawdza rzeczywistego przeciągania, przyjęcia upuszczenia ani transferu danych. Zasady bezpieczeństwa strony mogą blokować kod w atrybutach; alternatywą jest addEventListener('dragenter', handler).

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragenter demo</title>
<div id="target" ondragenter="event.preventDefault(); document.getElementById('result').textContent = event.type + ': ' + event.defaultPrevented;">Target</div>
<button id="test" type="button">Run test</button>
<output id="result"></output>
<script>
  document.getElementById('test').addEventListener('click', () => {
    document.getElementById('target').dispatchEvent(
      new DragEvent('dragenter', { bubbles: true, cancelable: true })
    );
  });
</script>
</html>

Wynik

dragenter: true

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

Źródła