Atrybuty

• items - tablica zawierająca obiekty zakładek należących do kontrolki
• target - element do którego ładowana jest zawartość zakładek
• name - nazwa kontrolki wysyłana do serwera jako parametr określony w atrybucie widgetParam
• link - domyślny adres wywoływany na serwerze przez zakładki
• useCache - użycie pamięci podręcznej; zawartość każdej zakładki ładowana jest tylko raz; wartość false oznacza ładowanie zawartości zakładki za każdym razem kiedy zostanie wybrana (wartość domyślna: true)
• useHash - dynamiczna zmiana adresu (patrz Uwagi) (wartość domyślna: false)
• useSaving - zapamiętywanie aktywnej zakładki (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ę zakładki (wartość domyślna: "item")
• widgetParam - nazwa parametru wysyłanego do serwera zawierającego nazwę kontrolki (wartość domyślna: "widget")
• selectFirstItem - wartość true oznacza, że pierwsza dodana zakładka 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: false)
• fadeSteps - ilość kroków animacji zmiany zawartości (wartość domyślna: 25)
• fadeDuration - czas trwania animacji zmiany zawartości (wartość domyślna: 500ms)
• overOpen - otwieranie zakładek po najechaniu kursorem (wartość domyślna: false)
• overWait - czas w milisekundach jaki musi minąć od najechania kursorem na zakładkę aby została otwarta (wartość domyślna: 200ms)
• activeClass - nazwa klasy aktywnej zakładki
• hoverClass - nazwa klasy ustawianej po najechaniu na zakładkę
• activeImage - ikona aktywnej zakładki
• inactiveImage - ikona nieaktywnej zakładki
• imageClass - klasa ikony
• imagePosition - położenie ikony; "left" (po lewej) lub "right" (po prawej) (wartość domyślna: "left")
• OnSelect(item) - funkcja wywoływana po wybraniu zakładki
  • item - obiekt TabItem wybranej zakładki
• OnDeselect(item) - funkcja wywoływana przy zmianie zakładki
  • item - obiekt TabItem poprzedniej zakładki
• OnUpdate(item, response) - funkcja wywoływana po odebraniu odpowiedzi z serwera
  
  • item - obiekt TabItem zakładki, której zawartość została pobrana
  • response - odebrana odpowiedź
• OnRetrieve(item) - funkcja wywoływana przy wysyłaniu zapytania do serwera
  • item - obiekt TabItem zakładki, której zawartość jest pobierana
• OnError() - funkcja wywoływana przy problemie w odbiorze zawartości zakładki

Metody

• AddItem(obj, [name, type, link]) - dodaje nową zakładkę do kontrolki; zwraca obiekt TabItem
  • obj - identyfikator elementu lub element, który służyć będzie za zakładkę
  • name - nazwa zakładki wysyłana do serwera
  • 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 atrybuty link
• GetItem(name) - zwraca obiekt zakładki TabItem o podanej nazwie
  • name - nazwa szukanej zakładki
• RemoveItem(item) - usuwa wybraną zakładkę (deaktywuje)
  • item - nazwa lub obiekt TabItem zakładki, która ma zostać usunięta
• AddTab(obj, [name, type, link]) - identycznie jak AddItem; funkcja zachowana w celu kompatybilności z poprzednimi wersjami

Uwagi

• Zapamiętywanie aktywnej zakładki (atrybut useSaving) polega na automatycznym wybraniu zapamiętanej zakładki po przeładowaniu strony (mechanizm oparty jest na ciasteczkach).
• Dynamiczna zmiana adresu (atrybut useHash) polega na dopisaniu nazwy aktywnej zakładki po znaku #, adres zmienia się następująco:
  
  
  http://www.przyklad.com#nazwa_zakładki
  
  Mechanizm ten umożliwia zapamiętywanie dynamicznych stron, ponieważ w przypadku wywołania takiego adresu automatycznie wybrana zostanie zakładka o nazwie nazwa_zakładki.
• Domyślnie zawartość zakładek ł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 nowej zakładki jako argument link w funkcji AddItem. Możliwa jest także późniejsza zmiana tego adresu poprzez ustawienie atrybutu link w obiekcie TabItem.
• Atrybut reqConfig zawiera ustawienia zapytań wysyłanych przez kontrolkę w postaci obiektu zawierającego pary "atrybut: wartość", przykładowe ustawienia:
  
  
  tabs.reqConfig = {
      username: "lorem",
      password: "ipsum",
      encoding: "iso-8859-2"
  }