AccordionWidget PDF Drukuj

Atrybuty

  • items - tablica zawierająca panele należące do akordeonu
  • name - nazwa kontrolki wysyłana do serwera jako parametr określony w atrybucie widgetParam
  • link - domyślny adres wywoływany na serwerze przez panele
  • useCache - użycie pamięci podręcznej; zawartość każdego panelu ładowana jest tylko raz; wartość false oznacza ładowanie zawartości panelu za każdym razem kiedy zostanie wybrany (wartość domyślna: true)
  • useHash - dynamiczna zmiana adresu (patrz Uwagi) (wartość domyślna: false)
  • useSaving - zapamiętywanie aktywnego panelu (patrz Uwagi) (wartość domyślna: false)
  • autoTextUpdate - wartość true oznacza, że odpowiedź tekstowa będzie automatycznie wstawiana do elementu target (wartość domyślna: true)
  • itemParam - nazwa parametru wysyłanego do serwera zawierającego nazwę panelu (wartość domyślna: "item")
  • widgetParam - nazwa parametru wysyłanego do serwera zawierającego nazwę kontrolki (wartość domyślna: "widget")
  • selectFirstItem - wartość true oznacza, że pierwszy dodany panel zostania automatycznie wybrana (wartość domyślna: true)
  • reqConfig - ustawienia zapytań wysyłanych przez kontrolkę (patrz Uwagi) (wartość domyślna: {})
  • fading - animowana zmiana zawartości (wartość domyślna: true)
  • fadeSteps - ilość kroków animacj zmiany zawartości (wartość domyślna: 25)
  • fadeDuration -czas trwania animacji zmiany zawartości (wartość domyślna: 500ms)
  • overOpen - otwieranie/zamykanie paneli po najechaniu kursorem na nagłówek (wartość domyślna: false)
  • overWait - czas jaki musi upłynąć od najechania kursorem na nagłówek aby panel został otwarty/zamknięty (wartość domyślna: 200)
  • activeClass - nazwa klasy aktywnego nagłówka
  • hoverClass - nazwa klasy ustawianej po najechaniu kursorem na nagłówek
  • openClass - nazwa klasy otwartego elementu z zawartością
  • alwaysOpen - określa, czy akordeon musi być zawsze otwarty (wartość domyślna: true)
  • slideSteps - ilość kroków animacji zwijania/rozwijania elementu z zawartością (wartość domyślna: 15)
  • slideDuration - czas trwania animacji zwijania/rozwijania elementu z zawartością (wartość domyślna: 450)
  • slideWait - odstęp pomiędzy zamknięciem poprzedniego elementu z zawartością a otwarciem nowego (wartość domyślna: 80)
  • staticHeight - określa stałą wysokość dla wszystkich elementów z zawartością; domyślnie wysokość dostosywana jest do zawartości
  • OnOpen(item) - funkcja wywoływana przy otwieraniu panelu
    • item - obiekt AccordionItem otwieranego panelu
  • OnClose(item) - funkcja wywoływana przy zamykaniu panelu
    • item - obiekt AccordionItem zamykanego panelu
  • OnSelect(item) - funkcja wywoływana po wybraniu zakładki
    • item - obiekt AccordionItem wybranej zakładki
  • OnDeselect(item) - funkcja wywoływana przy zmianie zakładki
    • item - obiekt AccordionItem poprzedniej zakładki
  • OnUpdate(item, response) - funkcja wywoływana po odebraniu odpowiedzi z serwera
    • item - obiekt AccordionItem, którego zawartość została pobrana
    • response - odebrana odpowiedź
  • OnRetrieve(item) - funkcja wywoływana przy wysyłaniu zapytania do serwera
    • item - obiekt AccordionItem, którego zawartość jest pobierana
  • OnError() - funkcja wywoływana przy problemie w odbiorze zawartości zakładki

Metody

  • AddItem(header, target, [name, type, link]) - dodaje nowy panel; zwraca obiekt AccordionItem
    • header - identyfikator elementu lub element, służący jako nagłówek
    • target - identyfikator element lub element, gdzie wstawiana będzie zawartość
    • name - nazwa panelu wysyłana do serwera jako parametr określony w atrybucie itemParam
    • type - typ pobieranej zawartości ("text", "json" lub "xml") (wartość domyślna: "text")
    • link - adres strony, skąd pobierana jest zawartość zakładki; domyślnie adres ustawiony w kontrolce jako atrybut link
  • AddStatic(container, header, target, [offset]) - dodaje panele ze statyczną zawartością (nie ładowaną z serwera)
    • container - element zawierający pary nagłówek-zawartość
    • header - znacznik nagłówka
    • target - znacznik elementu z zawartością
    • offset - oddalenie nagłówka od elementu z zawartością
  • GetItem(name) - zwraca panel o podanej nazwie
    • name - nazwa szukanego panelu

Uwagi

  • Zapamiętywanie aktywnego panelu (atrybut useSaving) polega na automatycznym wybraniu zapamiętanego panelu po przeładowaniu strony (mechanizm oparty jest na ciasteczkach).
  • Dynamiczna zmiana adresu (atrybut useHash) polega na dopisaniu nazwy aktywnego panelu po znaku #, adres zmienia się następująco:

    http://www.przyklad.com#nazwa_panelu

    Mechanizm ten umożliwia zapamiętywanie dynamicznych stron, ponieważ w przypadku wywołania takiego adresu automatycznie wybrany zostanie panel o nazwie nazwa_panelu.
  • Domyślnie zawartość paneli ładowana jest ze strony określonej w parametrze link w obiekcie kontrolki. W celu ładowania zawartości z innego adresu, należy przekazać ten adres podczas dodawania nowego panelu jako argument link w funkcji AddItem. Możliwa jest także późniejsza zmiana tego adresu poprzez ustawienie atrybutu link w obiekcie AccordionItem.
  • Atrybut reqConfig zawiera ustawienia zapytań wysyłanych przez kontrolkę w postaci obiektu zawierającego pary "atrybut: wartość", przykładowe ustawienia:

    accordion.reqConfig = {
        username: "lorem",
        password: "ipsum",
        encoding: "iso-8859-2"
    }
 
« poprzedni artykuł   następny artykuł »