Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DataTransfer.effectAllowed — dozwolone operacje przeciągania

DataTransfer.effectAllowed określa, jakie operacje dopuszcza źródło przeciągania. Nie wybiera końcowej operacji: tę opisuje dropEffect, którego wartość musi być zgodna z dozwolonym zestawem.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

dataTransfer.effectAllowed
 dataTransfer.effectAllowed = "copyMove";

DataTransfer.effectAllowed to właściwość tekstowa interfejsu przeglądarkowego, nie funkcja ECMAScript. Podczas przeciągania źródło ustawia ją w obsłudze zdarzenia dragstart, gdy magazyn danych przeciągania jest w trybie odczytu i zapisu. W innych trybach lub przy nieprawidłowej wartości przypisanie nie zmienia poprzedniej wartości.

Dozwolone wartości to none (żadna operacja), copy, link, move, pary copyLink, copyMove, linkMove, a także all (wszystkie trzy) i uninitialized (domyślny stan bez jawnego ograniczenia). Wielkość liter ma znaczenie. W rzeczywistym przeciąganiu wartość początkowa to uninitialized.

dropEffect opisuje wybraną operację, a nie zestaw dozwolonych operacji. Cel zwykle anuluje dragover przez preventDefault() i ustawia zgodny dropEffect. Niezgodność uniemożliwia upuszczenie; samo effectAllowed nie kopiuje ani nie przenosi danych aplikacji.

W sprawdzonym uruchomieniu w Chromium konsola pokazuje, że w samodzielnym obiekcie utworzonym przez new DataTransfer() wartość pozostaje none zarówno po przypisaniu prawidłowego copyMove, jak i po przypisaniu nieprawidłowego COPY. Ten wynik odbiega od standardu HTML: magazyn danych obiektu utworzonego przez new DataTransfer() jest w trybie odczytu i zapisu, więc prawidłowe przypisanie powinno ustawić effectAllowed na copyMove, a późniejsze nieprawidłowe przypisanie COPY powinno pozostawić wartość copyMove bez zmian. Wynik z konsoli pokazuje zachowanie w tym uruchomieniu Chromium, a nie regułę przypisywania obowiązującą we wszystkich przeglądarkach.

Gdy użytkownik rozpocznie przeciąganie, procedura obsługi dragstart ustawia copyMove na event.dataTransfer, a późniejsze przypisanie COPY nie zmienia tej wartości. Przykład jest przeznaczony do przeglądarki; obecność Node 24 w repozytorium nie dowodzi obsługi tego API.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DataTransfer.effectAllowed</title>
</head>
<body>
  <h1>Allowed drag operations</h1>
  <p id="source" draggable="true">Drag this text, then press Escape to cancel.</p>
  <p id="status" role="status">Start a drag to see which operations the source allows.</p>
  <script>
    const standalone = new DataTransfer();
    standalone.effectAllowed = 'copyMove';
    console.log('Standalone after copyMove: ' + standalone.effectAllowed);
    standalone.effectAllowed = 'COPY';
    console.log('Standalone after COPY: ' + standalone.effectAllowed);

    document.getElementById('source').addEventListener('dragstart', (event) => {
      const transfer = event.dataTransfer;
      transfer.setData('text/plain', 'Example drag');
      transfer.effectAllowed = 'copyMove';
      const accepted = transfer.effectAllowed;
      transfer.effectAllowed = 'COPY';
      document.getElementById('status').textContent =
        'Drag source after copyMove: ' + accepted +
        '. After invalid COPY: ' + transfer.effectAllowed + '.';
    });
  </script>
</body>
</html>

Wynik

Standalone after copyMove: none
Standalone after COPY: none

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

Źródła