Wizualizacja: tabela

Jeśli ma wartość Prawda, sformatowane wartości w komórkach zawierających tagi HTML będą renderowane jako HTML. Jeśli ustawisz wartość Fałsz, większość niestandardowych elementów formatujących nie będzie działać prawidłowo.

Określa, czy do wierszy nieparzystych i parzystych zostanie przypisany styl z naprzemiennymi kolorami.

Obiekt, w którym każda nazwa właściwości opisuje element tabeli, a wartością właściwości jest ciąg znaków określający klasę, która zostanie przypisana do tego elementu tabeli. Ta właściwość pozwala przypisać niestandardowy kod CSS do określonych elementów tabeli. Aby użyć tej właściwości, przypisz obiekt, gdzie nazwa właściwości określa element tabeli, a wartością właściwości jest ciąg znaków. Podaj nazwę klasy, która ma zostać przypisana do tego elementu. Następnie musisz zdefiniować styl CSS dla tej klasy na stronie. Obsługiwane są te nazwy właściwości:

• headerRow – przypisuje nazwę klasy do wiersza nagłówka tabeli (element <tr>).
• tableRow – powoduje przypisanie nazwy klasy do wierszy bez nagłówka (elementy <tr>).
• oddTableRow – przypisuje nazwę klasy do wierszy w tabeli nieparzystych (elementy <tr>). Uwaga: opcja naprzemiennaRowStyle musi mieć wartość true (prawda).
• selectedTableRow – przypisuje nazwę klasy do wybranego wiersza tabeli (element <tr>).
• hoverTableRow – przypisuje nazwę klasy do wiersza tabeli, który znajduje się po najechaniu kursorem (element <tr>).
• headerCell – przypisuje nazwę klasy do wszystkich komórek w wierszu nagłówka (element <td>).
• tableCell – powoduje przypisanie nazwy klasy do wszystkich komórek tabeli bez nagłówka (element <td>).
• rowNumberCell – przypisuje nazwę klasy do komórek w kolumnie z numerem wiersza (element <td>). Uwaga: opcja showRowNumber musi mieć wartość true (prawda).

Przykład: var cssClassNames = {headerRow: 'bigAndBoldClass',
hoverTableRow: 'highlightClass'};

Uwaga: w CSS niektóre elementy zastępują inne. Jeśli na przykład określisz kolor tła dla elementu <tr> i elementu <td>, ten drugi będzie miał pierwszeństwo przed pierwszym. Aby uniknąć konfliktów, pamiętaj, aby w atrybucie cssClassNames określić wszystkie odpowiednie style CSS.

Numer pierwszego wiersza w tabeli danych. Używana tylko wtedy, gdy showRowNumber ma wartość true (prawda).

Liczba kolumn od lewej, które zostaną zablokowane. Pozostaną one bez zmian podczas przewijania pozostałych kolumn w poziomie. Jeśli showRowNumber ma wartość false, ustawienie frozenColumns na 0 wygląda tak samo jak wtedy, gdy ma wartość null, ale jeśli showRowNumber ma wartość true, kolumna z numerem wiersza jest zablokowana.

Ustawia wysokość elementu kontenera wizualizacji. Możesz użyć standardowych jednostek HTML (np. „100px”, „80em”, „60”). Jeśli nie podasz żadnych jednostek, zakłada się, że podana liczba to piksele. Jeśli wysokość nie zostanie określona, przeglądarka automatycznie dostosuje wysokość do tabeli, zmniejszając ją maksymalnie w trakcie procesu. Jeśli wysokość będzie mniejsza niż wymagana wysokość, tabela doda pionowy pasek przewijania (wiersz nagłówka również zostanie zablokowany). Jeśli ustawisz wartość „100%”, tabela maksymalnie rozwinie się do elementu kontenera.

Czy i jak włączyć stronicowanie danych. Wybierz jedną z tych wartości ciągu znaków:

• „enable” (włącz) – tabela będzie zawierać przyciski do przodu i do tyłu. Kliknięcie tych przycisków spowoduje uruchomienie stronicowania i zmianę wyświetlanej strony. Możesz też ustawić opcję pageSize.
• „event” – tabela będzie zawierać przyciski do przodu i do tyłu, ale ich kliknięcie wywoła zdarzenie „page” (strona) i nie zmieni wyświetlanej strony. Tej opcji należy używać, gdy kod implementuje własną logikę przewracania stron. W przykładzie TableQueryWrapper znajdziesz przykład ręcznego obsługi zdarzeń stronicowania.
• „disable” – [domyślne] stronicowanie nie jest obsługiwane.
Typ: ciąg znaków
Domyślnie: „disable” (wyłącz)

Liczba wierszy na każdej stronie, gdy stronicowanie jest włączone za pomocą opcji strony.

Ustawia określoną opcję przycisków stronicowania. Dostępne są następujące opcje:

• „zarówno” – włącz przyciski „Wstecz” i „Dalej”
• „poprzedni” – włączony jest tylko przycisk wstecz
• „Dalej” – włączony jest tylko przycisk Dalej
• „auto” – przyciski są aktywne zgodnie z obecną stroną. Tylko na pierwszej stronie wyświetla się następna strona. Na ostatniej stronie wyświetlana jest tylko poprzednia strona. W przeciwnym razie obie opcje będą włączone.
• liczba – liczba przycisków stronicowania do wyświetlenia. Ta jawna liczba zastąpi liczbę obliczoną na podstawie rozmiaru pageSize.

Dodaje podstawową obsługę języków pisanych od prawej do lewej (np. arabskiego i hebrajskiego) przez odwrócenie kolejności kolumn w tabeli, tak aby kolumna zero była skrajnie prawą, a ostatnia – lewa. Nie ma to wpływu na indeks kolumn w danych bazowych, a jedynie na kolejność wyświetlania. Nawet w przypadku tej opcji wizualizacja tabeli nie obsługuje pełnego wyświetlania w języku dwukierunkowym (BiDi). Ta opcja zostanie zignorowana, jeśli włączysz stronicowanie (za pomocą opcji strony) lub jeśli tabela ma paski przewijania, ponieważ określone opcje wysokości i szerokości są mniejsze niż wymagany rozmiar tabeli.

Określa pozycję przewijania w poziomie (w pikselach), jeśli tabela ma poziome paski przewijania, ponieważ ustawiono właściwość szerokości. Tabela otworzy się po przewinięciu o taką liczbę pikseli poza lewą kolumnę.

Jeśli ma wartość Prawda, numer wiersza wyświetla się jako pierwsza kolumna tabeli.

Czy i jak sortować kolumny po kliknięciu przez użytkownika nagłówka kolumny. Jeśli włączone jest sortowanie, rozważ też ustawienie właściwości sortAscending i sortColumn. Wybierz jedną z tych wartości ciągu znaków:

• „enable” – [wartość domyślna] użytkownicy mogą klikać nagłówki kolumn, aby sortować według klikniętej kolumny. Gdy użytkownik kliknie nagłówek kolumny, wiersze zostaną automatycznie posortowane i zostanie wywołane zdarzenie „sort”.
• „event” – gdy użytkownik kliknie nagłówek kolumny, zostanie wywołane zdarzenie „sort”, ale wiersze nie zostaną automatycznie posortowane. Tej opcji należy używać, gdy na stronie jest zaimplementowany własny sposób sortowania. W przykładzie TableQueryWrapper znajdziesz przykład ręcznej obsługi zdarzeń sortowania.
• „disable” – kliknięcie nagłówka kolumny nie powoduje żadnego efektu.

Kolejność sortowania kolumny początkowego sortowania. Wartość „True” (rosnąco), false (fałsz) malejąco. Ignorowana, jeśli nie określono sortColumn.

Indeks kolumny w tabeli danych, według której tabela jest początkowo sortowana. Kolumna będzie oznaczona małą strzałką wskazującą kolejność sortowania.

Pierwsza strona tabeli do wyświetlenia. Używany tylko wtedy, gdy page jest w trybie włączania/zdarzenia.

Ustawia szerokość elementu kontenera wizualizacji. Możesz użyć standardowych jednostek HTML (np. „100px”, „80em”, „60”). Jeśli nie podasz żadnych jednostek, zakłada się, że podana liczba to piksele. Jeśli jej nie określisz, przeglądarka automatycznie dostosuje szerokość, by pasowała do tabeli, zmniejszając ją jak najbardziej. Jeśli szerokość jest mniejsza niż wymagana, tabela doda poziomy pasek przewijania. Jeśli ustawisz wartość „100%”, tabela w miarę możliwości rozwinie się do elementu kontenera.

Rysuje tabelę.

Standardowa implementacja getSelection. Zaznaczone elementy to wszystkie elementy wiersza. Może zwrócić więcej niż 1 wybrany wiersz. Indeksy wierszy w obiekcie wyboru odwołują się do pierwotnej tabeli danych niezależnie od interakcji użytkownika (sortowania, stronicowania itp.).

Zwróć uwagę, że przełącznik wyboru: kliknięcie komórki za pierwszym razem powoduje jej zaznaczenie. Ponowne kliknięcie komórki usuwa jej zaznaczenie, co skutkuje zdarzeniem wyboru, ale w pobranym obiekcie zaznaczenia nie ma żadnych elementów.

Wywołaj tę metodę, aby pobrać informacje o bieżącym stanie sortowania tabeli, która została posortowana (zwykle przez użytkownika, który kliknął nagłówek kolumny, aby posortować wiersze według określonej kolumny). Jeśli masz wyłączone sortowanie, ta metoda nie będzie działać.

Jeśli w kodzie nie zostały posortowane dane lub użytkownik nie posortował danych, wybierając kod, zwracane są domyślne wartości sortowania.

• column – (liczba) indeks kolumny, według której tabela jest sortowana.
• ascending – (wartość logiczna) prawda, jeśli sortowanie jest sortowane rosnąco, fałsz w przypadku sortowania malejącego.
• sortedIndexes – (tablica numeryczna) tablica liczb, w której indeks w tablicy to posortowany numer wiersza (w widocznej tabeli), a wartość jest indeksem tego wiersza w bazowej (nieposortowanej) tabeli danych.

Implementacja standardowa setSelection(), ale można wybierać tylko całe wiersze lub ich kilka. Indeksy wierszy w obiekcie wyboru odwołują się do pierwotnej tabeli danych niezależnie od interakcji użytkownika (sortowania, stronicowania itp.).

Czyści wykres i zwalnia wszystkie przydzielone Ci zasoby.

Standardowe zdarzenie wyboru, ale można wybrać tylko całe wiersze.

Wywoływane, gdy użytkownik kliknie przycisk nawigacji na stronie.

Wywoływane, gdy użytkownik kliknie nagłówek kolumny, a opcja sortowania nie jest wyłączona.

• column – (liczba) indeks kolumny, według której tabela jest sortowana.
• ascending – (wartość logiczna) prawda, jeśli sortowanie jest sortowane rosnąco, fałsz w przypadku sortowania malejącego.
• sortedIndexes – (tablica numeryczna) tablica liczb, w której indeks w tablicy to posortowany numer wiersza (w widocznej tabeli), a wartość jest indeksem tego wiersza w bazowej (nieposortowanej) tabeli danych.

Wykres jest gotowy do obsługi wywołań metod zewnętrznych. Jeśli chcesz korzystać z wykresu i metod wywołań po jego narysowaniu, skonfiguruj detektor tego zdarzenia przed wywołaniem metody rysowania i używaj ich dopiero po wywołaniu zdarzenia.