Tabela
Powiązanie danych
Na karcie właściwości Ogólne można ustawiać i modyfikować powiązanie danych widoku. Widok Tabela jest powiązany z listą obiektów, które zapełniają wiersze.
Właściwości konfiguracyjne
W obszarze Konfiguracja można ustawić lub zmodyfikować właściwości konfiguracyjne widoku.
- Wielkość ekranu
- Właściwość konfiguracyjna, na której znajduje się ikona Rozmiarów ekranu
obok nazwy właściwości, może mieć różne wartości dla każdej wielkości ekranu. Jeśli nie zostanie ustawiona wartość, wielkość ekranu dziedziczy wartość następnej większej wielkości ekranu jako swoją wartość domyślną.
- Definicje kompozycji
- Definicje kompozycji służą do podawania kolorów i stylów widoku oraz do określania jego wyglądu. W edytorze kompozycji można wyświetlić podgląd wyglądu i zachowania widoku. Patrz Kompozycje.
| Właściwość konfiguracyjna wyglądu | Opis | Typ danych |
|---|---|---|
| Styl tabeli | Styl tabeli. Dostępne są następujące opcje:
|
TableStyle |
| Styl koloru | Styl koloru tabeli. Kolory odpowiadają zmiennym w podanej kompozycji. Dostępne są następujące opcje:
|
TableColorStyle |
| Wyróżnij wybór | Służy do zacieniania wybranych wierszy. Ta opcja nie działa, jeśli nie jest podany styl koloru. | Boolean |
Szerokość![]() |
Służy do podawania szerokości tabeli. Szerokość jest wyrażana w pikselach (px), jako wartość procentowa (%) lub w firetach (em). Na przykład: 50px, 20%lub 0.4em. Jeśli nie jest podany typ jednostki, domyślnie używana jest jednostka px (piksele). | String |
Wysokość ![]() |
Służy do podawania wysokości widoku, która jest wyrażana w pikselach (px) lub w firetach (em). Jeśli nie jest podany typ jednostki, domyślnie używana jest jednostka px (piksele). Wysokość nie uwzględnia nagłówka ani stopki. Jeśli podano wysokość, a wiersze nie mieszczą się w pionie w miejscu dostępnym dla treści tabeli, treść tabeli można przewijać w pionie. | String |
| Zawijaj nagłówki kolumn | Zawija nagłówki kolumn w zależności od dostępnej w tabeli ilości miejsca. | Boolean |
| Pokaż elementy wywoływane | Wywoływane menu i widoki są wyświetlane nad tabelą, jeśli nie została podana wysokość. Jeśli na przykład ta opcja jest zaznaczona, widok Okno wyboru daty i godziny jest wyświetlane nad tabelą. W przeciwnym razie element sterujący Okno wyboru daty i godziny jest osadzany w komórce tabeli. | Boolean |
| Styl nagłówka i stopki | Umożliwia zastosowanie innego stylu nagłówka i stopki. Na przykład styl Nowoczesny usprawnia stronicowanie w nagłówku i stopce. | TableHFStyle |
| Właściwość konfiguracyjna zachowania | Opis | Typ danych |
|---|---|---|
| Tryb wyboru | Służy do podawania liczby wierszy, które może wybrać użytkownik:
|
TableSelectionMode |
| Pokaż przycisk Usuń | Służy do pokazywania lub ukrywania przycisku usuwania wiersza. | Boolean |
Pokaż stopkę![]() |
Służy do pokazywania lub ukrywania stopki. Stopka jest także wyświetlana, jeśli są włączone jakiekolwiek widoki stopki, na przykład Pokaż przycisk Dodaj. | Boolean |
| Pokaż przycisk Dodaj | Służy do pokazywania lub ukrywania przycisku dodawania wiersza. Jeśli tabela jest posortowana lub przefiltrowana, nowo dodany wiersz
może nie zostać wyświetlony jako ostatni wiersz w tabeli lub może nie zostać w
ogóle wyświetlony aż do momentu anulowania sortowania lub filtrowania. Należy zwrócić uwagę, że jeśli zostanie wybrany styl nagłówka i stopki Nowoczesny i ma zostać wyświetlony przycisk Dodaj , należy również wybrać opcję Pokaż stopkę . |
Boolean |
Pokaż statystyki tabeli![]() |
Służy do wyświetlania w stopce statystyki dotyczącej tabeli. Na przykład: Showing
1 to 5 of 59 entries.Uwaga: Należy także wybrać opcję Pokaż stopkę. |
Boolean |
Pokaż pager![]() |
Służy do pokazywania lub ukrywania liczby stron. Paginator
wyświetla tylko 5 stron i dlatego, w zależności od początkowej wielkości
strony i liczby rekordów, strony mogą nie być kolejne (1,
2, 3...). Na przykład: Tabela ma 50 pozycji, a początkowa wielkość strony jest ustawiona na 5. Wyświetlane numery stron to 1, 3, 5, 7 i 10. Użytkownik może klikać przycisk Dalej, aby przejść kolejno przez strony, lub może użyć przycisków numerów stron, aby szybko przechodzić między stronami. Uwaga: Należy także wybrać opcję Pokaż stopkę. |
Boolean |
Pokaż sizer strony![]() |
Służy do pokazywania lub ukrywania elementu sterującego wielkością strony, który wyświetla liczbę wierszy na stronie. | Boolean |
Początkowa wielkość strony![]() |
Liczba wierszy wyświetlanych na stronie. | Integer |
| Zmień wielkość kolumn | Zezwalaj użytkownikom na zmianę wielkości kolumn poprzez przeciąganie ich separatorów. | Boolean |
| Dowolny typ | Specyfikacja typu definicji obiektu biznesowego, gdy widok jest powiązany z listą typów ANY. | TableANYType |
| Właściwość konfiguracyjna kolumn | Opis | Typ danych |
|---|---|---|
| Renderuj jako | Sposób wyświetlania zawartości komórek:
Widoki, które są zagnieżdżone w komórkach tabeli, takie jak Liczba całkowita i Okno wyboru daty (nieaktualny), zwykle mają widoczną ramkę. Tabela także ma własną ramkę. Aby usunąć ramki widoków zagnieżdżonych, należy użyć widoku jednolitego. Jeśli używany jest widok formatki lub jednolity widok formatki, wybierz opcję showLabel, aby wyświetlić etykietę widoku zagnieżdżonego. Więcej informacji na ten temat zawiera sekcja Typy renderowania. |
String |
| Widoczność | Widoczność kolumny. | String |
| Sortowalne | Umożliwia sortowanie danych wg tej kolumny. Domyślnie
można sortować tylko te kolumny, które są powiązane z typami prostymi. Aby
można było sortować dane wg kolumny typu złożonego, należy w przypadku właściwości
Wyświetl jako ustawić opcję
Niestandardowy i trzeba użyć zdarzenia Przy
istnieniu komórki niestandardowej. Na przykład: |
Boolean |
| Opcje | Opcje formatowania danych w kolumnie (w zależności od
typu danych).
|
String |
| Arkusz CSS | Styl CSS do zastosowania do kolumny. Istnieje
możliwość użycia stylu CSS (np. color:#00ff00) lub klas CSS. Jeśli w tym polu
znajduje się dwukropek, w widoku Tabela przyjmuje się, że podano styl CSS. W
przeciwnym razie zakłada, że podano co najmniej jedną nazwę klasy CSS. |
String |
| Szerokość | Szerokość kolumny wyrażona w pikselach (px), w firetach (em) lub jako wartość procentowa (%). Jeśli nie jest podana żadna jednostka, domyślnie jest używana jednostka px (piksele). Uwaga: Zaleca się pozostawienie szerokości jednej kolumny jako niezdefiniowanej, dzięki czemu przeglądarka będzie mogła obliczyć ilość pozostałego miejsca i przypisać je do kolumny, której szerokość nie jest podana. | String |
| Etykieta | Etykieta kolumny. | String |
| showLabel | Jeśli komórka jest wyświetlana w widoku formatki lub jednolitym widoku formatki, określa wyświetlanie lub ukrywanie etykiety widoku. | Boolean |
| Właściwość konfiguracyjna wydajności | Opis | Typ danych |
|---|---|---|
| Ładowanie asynchroniczne | Zapewnia lepsze działanie interfejsu użytkownika w przypadku dużych zestawów danych (kosztem dłuższego całkowitego czasu ładowania wierszy po rozpoczęciu ładowania sekcji). | Boolean |
| Wielkość partii asynchronicznej | Służy do podawania liczby wierszy ładowanych synchronicznie w ramach partii asynchronicznej. Może to pomóc w dostrojeniu lub zoptymalizowaniu wydajności operacji ładowania synchronicznego względem operacji ładowania asynchronicznego. | Integer |
Przykład
- Parametr name typu String.
- Parametr favoriteSport typu String.
- Parametr favoritePlayer typu String.
var autoObject = [];
autoObject[0] = {};
autoObject[0].name = "Dylan";
autoObject[0].favoriteSport = "Tennis";
autoObject[0].favoritePlayer = "Federer";
autoObject[1] = {};
autoObject[1].name = "Max";
autoObject[1].favoriteSport = "Soccer";
autoObject[1].favoritePlayer = "Messi";
autoObjectUsługa personelu po stronie klienta ma zmienną prywatną profile typu Profile[].
- Ogólne > Etykieta: Profile – formatka 1
- Ogólne > Powiązanie: profile[]
- Kolumna Imię z powiązaniem profile.currentItem.name
- Kolumna Ulubiony sport z powiązaniem profile.currentItem.favoriteSport
- Kolumna Ulubiony gracz z powiązaniem profile.currentItem.favoritePlayer
- Konfiguracja > Zachowanie
- Tryb wyboru: Pojedynczy
- Jest wybrana właściwość Pokaż przycisk Usuń.
- Jest wybrana właściwość Pokaż stopkę.
- Jest wybrana właściwość Pokaż przycisk Dodaj.
- Jest wybrana właściwość Pokaż statystykę dotyczącą tabeli.
- Obszar Konfiguracja > Kolumny zawiera trzy wpisy z następującymi
ustawieniami:
- W przypadku właściwości Wyświetl jako jest ustawiona opcja Widok formatki.
- W przypadku właściwości Widoczność jest ustawiona opcja Widoczne.
- Jest wybrana właściwość Sortowalne.
W usłudze personelu po stronie klienta należy utworzyć kopię strony i połączyć ją z pierwszą stroną. W drugiej stronie należy zmienić etykietę elementu sterującego Tabela na Profile – formatka 2.
Typy wyświetlania
- Widok formatki
- Ten typ wyświetlania (domyślny) służy do wyświetlania zawartości kolumny tabeli jako widoku, który wykonuje logikę JavaScript. Użycie tego typu wiąże się z intensywnym przetwarzaniem danych, więc może mieć negatywny wpływ na wydajność wyświetlania kolumn. Aby na przykład uzyskać sekcję modalną dołączoną do tabeli, która stała się widoczna po kliknięciu przycisku, można użyć typu wyświetlania widoku formatki i logiki podobnej do następującego kodu JavaScript w przypadku wystąpienia przycisku:
- Jednolity widok formatki
- Ten typ wyświetlania służy do usuwania krawędzi widoków, które podczas wyświetlania są zawarte w tabeli. Za pomocą tego typu wyświetlania można zmienić wygląd wyświetlany typowych widoków wejściowych formularza, takich jak Liczba całkowita lub Liczba dziesiętna. Inny wygląd jest jedyną rzeczą, która odróżnia go od widoku.
- Prosty kod HTML
- Ten typ wyświetlania służy do wyświetlania zawartości tabeli przy użyciu czystego języka HTML. Należy go używać tylko wtedy, gdy w polach tabeli nie jest wykonywana żadna logika JavaScript. Jeśli jest używany z polami, w których jest wykonywana logika JavaScript (np. w przypadku zdarzenia widoku), widok nie jest wyświetlany na stronie. Ten typ wyświetlania jest związany z najmniejszym przetwarzaniem danych spośród wszystkich opisanych tutaj typów.
- Użytkownika
- Ten typ wyświetlania służy do podawania opcji wyświetlania w kolumnie niestandardowej tabeli lub do określania wyglądu pola. Gdy edytujesz dane konfiguracyjne kolumny tabeli, możesz użyć pola edycyjnego Opcje, aby określić opcjonalne formatowanie, które ma zostać zastosowane do już utworzonych obiektów. Na przykład:
Zdarzenia
We właściwościach Zdarzenia można ustawiać i modyfikować procedury obsługi zdarzeń widoku. Zdarzenia mogą być uruchamiane w sposób programowy lub w wyniku interakcji użytkownika z widokiem. Informacje na temat definiowania zdarzeń i kodu zdarzeń zawiera sekcja Zdarzenia zdefiniowane przez użytkownika.
Element Tabela ma następujące typy procedur obsługi zdarzeń:
- : Aktywowany podczas ładowania tabeli. Na przykład:
me.setPageIndex(0); - : Aktywowane, gdy jest ładowana komórka, która ma niestandardowe opcje wyświetlania (ustawione w konfiguracji Kolumny). Aby użyć tego zdarzenia, należy ustawić wartość konfiguracyjna Renderuj jako wartość w konfiguracji Kolumny. Tego zdarzenia można również użyć do ustawienia dla typów złożonych. Na przykład:
var div = document.createElement("div"); div.innerHTML = cell.row.data[cell.varName]; return div; - : Aktywowane po wyświetleniu wierszy. To zdarzenie ma zastosowanie tylko w przypadku tabel z
podziałem na strony. Na przykład:
alert("All rows have " + (all ? "" : "NOT") + " been loaded"); - : To zdarzenie jest wyzwalane po załadowaniu wierszy z możliwością przyspieszania. Aby można było użyć tego zdarzenia, należy włączyć opcję konfiguracji zezwalającą na rozwijane wiersze. Na przykład, gdy wiersz jest renderowany jako:
Przykład, gdy wiersz jest wyświetlany jako:row.views.forEach(function(view) { switch(view.context.viewid) { case "Text1": view.setData(row.data[varName]); break; case "Text2": view.setData(row.data[varName]); break; } });var div = document.createElement("div"); div.innerHTML = row.data[varName] + " " + row.data[varName]; return div; - : Wyzwalacze, gdy wiersz zostanie rozwinięty. Na przykład:
${Service_Call1}.execute(); - : Wyzwalacze, gdy wiersz zostanie zwijany. Na przykład:
alert("Collapsed row has index " + row.recordIndex); - : Aktywowane po wybraniu przez użytkownika wiersza. Na przykład:
alert("Selected row has index " + row.recordIndex); - : Aktywowane, gdy użytkownik korzysta z opcji Wybierz wszystko w celu wybrania wszystkich wierszy w tabeli, która znajduje się w trybie wyboru Wielokrotny lub w celu wyczyszczenia wyboru we wszystkich wierszach tabeli. Udostępnia zmienną kontekstową o nazwie all, która wskazuje, że wszystkie lub żadne wiersze nie są zaznaczone. Na przykład:
alert("All rows selected: " + all); - : To zdarzenie jest wywoływane po dodaniu wiersza przez użytkownika za pomocą przycisku. Jeśli zwraca obiekt JavaScript, obiekt ten jest dodawany, w przeciwnym razie dodawany jest pusty obiekt. Na przykład:
alert("New row will be added"); - : Aktywowane, gdy użytkownik prosi o usunięcie rekordu. Jeśli zdarzenie zwróci wartość, rekord nie zostanie usunięty. Tego zdarzenia można użyć do żądania od użytkownika
potwierdzenia przed usunięciem rekordu. Na przykład:
return confirm("Are you sure you want to delete item " + item.str1); - : Aktywowane, gdy użytkownik kliknie ikonę sortowania w nagłówku kolumny tabeli. Funkcja ta wraca do sortowania niestandardowego i pomija domyślne sortowanie tabeli. Tego zdarzenia można użyć do ustawienia na liście sortowanej niestandardowych. Na przykład:
alert("Sorting " + col + " column in " + order + " order"); me.context.binding.set("value", myCustomSortedList); return false; - : Aktywowane, gdy użytkownik zmieni wartość dla pola wprowadzania danych na stronie. Na przykład:
me.showPager(true); - 21.0.2 : Aktywowano, gdy użytkownik zmienia wielkość kolumny. Na przykład:
alert("Column resized"); - : Aktywowane, gdy użytkownik przeciągnie i upuszcza kolumnę.
alert("Column dropped");
metody
Szczegółowe informacje na temat dostępnych metod dla tabeli można znaleźć w sekcji Interfejs API języka JavaScript tabeli.
Zasoby dodatkowe
Więcej informacji na temat sposobu tworzenia formatki lub strony zawiera sekcja Budowanie formatek.
Informacje na temat standardowych właściwości (Ogólne, Konfiguracja, Pozycjonowanie, Widocznośći Atrybuty HTML) można znaleźć w sekcji Właściwości widoku.