Atrybuty
- caseSensitive - określa, czy przy sortowaniu rozróżniana jest wielkość liter (wartość domyślna: true)
- multiSelect - określa, czy zaznaczonych może być więcej niż jeden wiersz (wartość domyślna: true)
- selectClass - klasa zaznaczonego wiersza
- exclude - tablica zawierająca wiersze wykluczone z zaznaczania
- excludeFirstRow - określa, czy wykluczyć pierwszy wiersz przy sortowaniu (wartość domyślna: true)
- excludeLastRow - określa, czy wykluczyć ostatni wiersz przy sortowaniu (wartość domyślna: false)
- remoteRowSeparator - separator oddzielający wiersze pobrane z serwera (wartość domyślna: ";") (w wersjach przed 1.2.4 wartością domyślną było "\r\n")
- remoteDataSeparator - separator oddzielający dane wiersza pobrane z serwera (wartość domyślna: ",")
- supportPolishChars - sortowanie polskich znaków (wartość domyślna: true)
- reqConfig - ustawienia zapytań wysyłanych przez kontrolkę (patrz Uwagi)
- OnSelect(row) - funkcja wywoływana po zaznaczeniu wiersza
- OnDeselect(row) - funkcja wywoływana po odznaczeniu wiersza
- OnSort(index) - funkcja wywoływana przy sortowaniu tabel
- index - numer kolumny sortującej
- OnAscSort(index) - funkcja wywoływana przy sortowaniu rosnącym tabeli
- index - numer kolumny sortującej
- OnDescSort(index) -funkcja wywoływana przy sortowaniu malejącym tabeli
- index - numer kolumny sortującej
- OnChange(cell) - funkcja wywoływana przy zmianie kolumny sortującej
- cell - komórka poprzedniej kolumny sortującej
- OnInsert(row) - funkcja wywoływana przy wstawianiu nowego wiersza
- OnDelete(row) - funkcja wywoływana przy usuwaniu wiersza
- OnRemoteLoading() - funkcja wywoływana podczas oczekiwania na odbiór danych z serwera
- OnRemoteDone() - funkcja wywoływana po odebraniu danych z serwera
- OnError() - funkcja wywoływana przy wystąpieniu błędu w odbiorze danych z serwera
Metody
- AddSortCell(index) - ustawia daną kolumnę jako sortowalną
- AddSortCells(index_1, index_2, ...) - dodaje kilka kolumn sortowalnych na raz; funkcja może być również wywołana bez żadnych argumentów - w takim wypadku wszystkie kolumny zostaną ustawione jako sortowalne
- index_1, index_2, ... - kolejny numery kolumn, które mają zostać ustawione jako sortowalne
- SortBy(index, [desc]) - sortuje tabelę według kolumny o podanym numerze
- index - numer kolumny
- desc - wartość true oznacza sortowanie malejące, false rosnące (wartość domyślna: true)
- SetSelective() - ustawia zaznaczanie wierszy
- LoadTextData(url) - dynamicznie pobiera dane z serwera i wstawia je do tabeli; wiersze oddzielone są znakiem określonym w atrybucie remoteRowSeparator, natomiast dane oddzielone są znakiem określonym w atrybucie remoteDataSeparator
- url - adres, skąd pobrane mają zostać dane
- LoadJSONData(url) - dynamicznie pobiera dane z serwera w formacie JSON i wstawia je do tabeli; każdy wiersz powinien być osobnym obiektem, zawierającym tablicę danych (patrz Uwagi)
- url - adres, skąd pobrane mają zostać dane
- SelectAll() - zaznacza wszystkie wiersze
- DeselectAll() - odznacza wszystkie zaznaczone wiersze
- IsSelected(row) - sprawdza, czy dany wiersz jest zaznaczony
- row - element wiersza lub jego pozycja
- GetRow(index) - zwraca wiersz na danej pozycji
- GetSelRows() - zwraca tablicę zaznaczonych wierszy
- DeleteRow(row) - usuwa dany wiersz
- row - element wiersza lub jego pozycja
- DeleteSelRows() - usuwa zaznaczone wiersze
- DeleteAllRows() - usuwa wszystkie wiersze
- InsertRow(values) - wstawia nowy wiersz z danymi na końcu tabeli; zwraca wstawiony wiersz
- values - dane kolejnych komórek wiersza; mogą być przekazane albo w postaci tablicy, albo jako osobne argumenty
- InsertBefore(before, values) - wstawia nowy wiersz z danymi przed podanym; zwraca wstawiony wiersz
- before - element wiersza lub jego pozycja, przed którym wstawiony zostanie nowy wiersz
- values - dane kolejnych komórek wiersza; mogą być przekazane albo w postaci tablicy, albo jako osobne argumenty
Uwagi
- Dane pobierane dynamicznie z serwera w formacie JSON powinny zostać zwrócone w poniższej postaci:
[
["komorka1_wiersz1", "komorka2_wiersz1", "komorka3_wiersz1"],
["komorka1_wiersz2", "komorka2_wiersz2", "komorka3_wiersz2"]
]
- Atrybut reqConfig zawiera ustawienia zapytań wysyłanych przez
kontrolkę w postaci obiektu zawierającego pary "atrybut: wartość",
przykładowe ustawienia:
grid.reqConfig = {
username: "lorem",
password: "ipsum",
encoding: "iso-8859-2"
}
|