DropZone PDF Drukuj

Atrybuty

  • insertInside - wstawianie przeciąganego elementu pomiędzy elementami znajdującymi się w konterze; wartość false oznacza że element będzie dodawany na końcu kontenera bez względu na to gdzie został upuszczony (wartość domyślna: true)
  • autoInline - wprowadzanie zmian w stylach elementów dodawanych do kontenera dzięki czemu będą one umieszczone obok siebie (wartość domyślna: true)
  • useDummyNode - rozsuwanie elementów znajdujacych się pod przeciąganym elementem (wartość domyślna: true)
  • dummyNodeClass - klasa elementu pomocnicznego używanego przy rozsuwaniu elementów w miejscu upuszczenia przeciąganego elementu (wartość domyślna: null)
  • returnItems - zwracanie elementów przeciągniętych z tego kontenera jeśli nie zostały przeniesione do nowego (wartość domyślna: false)
  • limit - maksymalna ilość elementów jaka może znaleźć się w kontenerze; wartość null oznacza dowolną ilość (wartość domyślna: null)
  • reqConfig - ustawienia zapytań wysyłanych podczas pobierania/zapisywania listy elementów (patrz Uwagi) (wartość domyślna: {})
  • overClass - klasa elementu znajdującego się pod przeciąganym elementem
  • hoverClass - klasa kontenera podczas przeciągania nad nim elementu
  • acceptClass - klasa akceptowana przez kontener (patrz Uwagi aby dowiedzieć się więcej)

Metody

  • InsertItem(obj, [before]) - wstawia element do kontenera
    • obj - identyfikator elementu lub element
    • before - element, przed którym ma być umieszczony wstawiany element; null oznacza wstawienie elementu na końcu kontenera (opcjonalne)
  • RemoveItem(obj) - usuwa element z kontenera
    • obj - identyfikator elementu lub element
  • SendItems(url) - wysyła listę identyfikatorów elementów znajdujących się w kontenerze do serwera (patrz Uwagi)
    • url - adres na który ma zostać wysłana lista identyfikatorów
  • LoadItems(url) - pobiera listę identyfikatorów elementów z serwera i automatycznie wstawia wszystkie dostępne z listy elementy do kontenera (patrz Uwagi)
    • url - adres skąd pobrana ma zostać lista identyfikatorów
  • OnAdd(obj) - funkcja wywoływana podczas dodawania elementu obj do kontenera
  • OnRemove(obj) - funkcja wywoływana podczas usuwania elementu obj z kontenera
  • OnOver(obj, over) - funkcja wywoływana podczas przesuwania elementu obj nad elementem over wewnątrz kontenera
  • OnOverIn(obj, over) - funkcja wywoływana podczas przesunięcia elementu obj nad element over wewnątrz kontenera
  • OnOverOut(obj, over) - funkcja wywoływana podczas przesunięcia elementu obj poza element over wewnątrz kontenera
  • OnHover(obj) - funkcja wywoływana podczas przesuwania elementu obj nad kontenerem
  • OnHoverIn(obj) - funkcja wywoływana podczas przesunięcia elementu obj nad kontener
  • OnHoverOut(obj) - funkcja wywoływana podczas przesunięcia elementu obj poza kontener
  • OnAccept(obj) - funkcja wywoływana podczas przesunięcia elementu obj nad kontener; jeśli funkcja zwraca wartość true, oznacza to że element obj może zostać upuszczony w kontenerze; jeśli funkcja zwraca wartość false, oznacza to że element obj jest ignorowany przez kontener (nie są wywoływane żadne funkcje zdarzeniowie)
  • OnLimit(obj) - funkcja wywoływana gdy w kontenerze znajduje się już maksymalna ilość elementów (określona w atrybucie limit) i element obj nie może zostać dodany
  • OnSendDone() - funkcja wywoływana po wysłaniu listy elementów do serwera funkcją SendItems
  • OnLoadDone() - funkcja wywoływana po odebraniu listy elementów z serwera funkcją LoadItems

Uwagi

  • Selekcję elementów, które są przyjmowane przez kontener, można wykonać na dwa sposoby. Pierwszym z nich jest ustawienie atrybutu acceptClass określającego nazwę klasy akceptowanej - w tym wypadku do kontenera będzie można upuszczać tylko elementy z ustawioną podaną klasą. Drugim sposobem jest zdefiniowanie funkcji OnAcccept(obj), gdzie wykonać możemy bardziej skomplikowane operacje selekcyjne - jeśli funkcja zwraca wartość true, oznacza to że element przekazany jako parametr może zostać upuszczony do kontenera, jeśli natomiast funkcja zwraca wartość false, oznacza to że element jest odrzucony przez kontener. W przypadku elementów odrzuconych nie są wywoływane funkcje zdarzeniowe (funkcje z przedrostkiem On).
  • Lista elementów znajdujących się w kontenerze może zostać wysłana lub pobrana przy użyciu funkcji SendItems oraz LoadItems. Lista składa się z identyfikatorów elementów (warunek konieczny, inaczej element nie zostanie uwzględniony na liście) oddzielonych przecinkiem. Po pobraniu listy wszystkie elementy przeciągalne o identyfikatorze znajdującym się na pobranej liście zostaną automatycznie wstawione do kontenera.

 

 

 

 
« poprzedni artykuł   następny artykuł »