Element sterujący Tabela danych usługi
Element sterujący Tabela danych usługi jest podobny do elementu sterującego Tabela i umożliwia utworzenie tabeli powtarzalnej. W elemencie sterującym Tabela danych usługi należy wskazać usługę Ajax zwracającą dane, które będą wyświetlane w tabeli. Z tego powodu nie należy wiązać elementu sterującego Tabela danych usługi ze zmienną.
Właściwości konfiguracyjne
Na karcie właściwości Konfiguracja można ustawiać i modyfikować właściwości konfiguracyjne wyglądu, zachowania, kolumn i wydajności tego elementu sterującego.- Wielkość ekranu
- Jeśli
obok nazwy właściwości konfiguracyjnej znajduje się ikona wielkości ekranu
, ta właściwość może mieć różne wartości w przypadku różnych
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ą. Jeśli używany jest edytor lokalny
Process Designer, ustawiana jest wartość dużej wielkości ekranu. Inne wielkości ekranu dziedziczą tę wartość.
- Definicje kompozycji
- Definicje kompozycji służą do podawania kolorów i stylów elementu sterującego oraz wyglądu elementu sterującego. W edytorze kompozycji można wyświetlić podgląd wyglądu i zachowania elementów sterujących. Więcej informacji zawiera sekcja Kompozycje.
| Właściwość konfiguracyjna wyglądu | Opis | Typ danych |
|---|---|---|
| Styl tabeli | Służy do podawania stylu tabeli. | Łańcuch |
| Styl koloru | Służy do podawania stylu koloru tabeli. | Łańcuch |
| Wyróżnij wybór | Służy do zacieniania wybranych wierszy. Ta opcja wymaga podania stylu koloru innego niż Brak. | Wartość boolowska |
Szerokość
![]() |
Szerokość wyrażana w następujących jednostkach: px (piksle), % (wartość procentowa) lub em (krotność wielkości czcionki). Na przykład: 50 px, 20%, 0,4 em. Jeśli nie jest podany typ jednostki, domyślnie używana jest jednostka px (piksle). | Łańcuch |
Wysokość
![]() |
Wysokość tabeli wyrażana w następujących jednostkach: px (piksle) lub em (krotność wielkości czcionki). Na przykład: 50 px lub 0,4 em (nie jest uwzględniany nagłówek ani stopka). Jeśli nie jest podany typ jednostki, domyślnie używana jest jednostka px (piksle). | Łańcuch |
| Właściwość konfiguracyjna zachowania | Opis | Typ danych |
|---|---|---|
| Usługa danych | Usługa Ajax używana z tym elementem sterującym. Usługa dostarcza dane do tabeli. | Usługa AJAX |
| Dane usługi | Dane wejściowe usługi danych. Ten typ musi być zgodny z typem danych wejściowych usługi. | ANY |
| Rozpocznij od pustej | Tabela jest początkowo pusta. Tabela jest zapełniana przez działającą usługę przy użyciu metody refresh (odświeżanie). | Wartość boolowska |
| Tryb wyboru | Tryb wyboru pozycji tabeli. | Łańcuch |
| Pokaż stopkę | Służy do wyświetlania stopki tabeli. | Wartość boolowska |
| Pokaż statystykę dotyczącą tabeli | Służy do wyświetlania statystyki dotyczącej tabeli (np. "Wyświetlanie pozycji: 1-5 z 59"). | Wartość boolowska |
| Pokaż paginator | Służy do włączania stronicowania. | Wartość boolowska |
| Pokaż element sterujący wielkością strony | Służy do włączania opcji umożliwiającej wybieranie liczby wierszy do wyświetlania na stronie. | Wartość boolowska |
| Początkowa wielkość strony | Początkowa maksymalna liczby pozycji, które mają być wyświetlane na stronie. | Liczba całkowita |
| Właściwość konfiguracyjna kolumn | Opis | Typ danych |
|---|---|---|
| dataElementName | Nazwa elementu danych do wyświetlenia w kolumnie. | Łańcuch |
| renderAs | Służy do wybierania sposobu wyświetlania komórki. | Łańcuch |
| visibility | Widoczność kolumny. | Łańcuch |
| sortable | Jeśli ta opcja jest włączona, użytkownicy mogą sortować tabelę według tej kolumny. | Wartość boolowska |
| options | Opcjonalne dane przekazywane do komórki w zależności od typu danych w kolumnie: - Liczba dziesiętna: thousandsSeparator, decimalPlaces, decimalSeparator, postfix, prefix - Okno wyboru daty: datePattern - Odsyłacz: href - Liczba całkowita: thousandSeparator | Łańcuch |
| css | Opcje CSS do dodania do kolumny (np. color:#00ff00). | Łańcuch |
| width | Szerokość kolumny. | Łańcuch |
| label | Służy do ustawiania etykiety kolumny. | Łańcuch |
| 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 łącznego czasu ładowania wierszy po rozpoczęciu ładowania sekcji). | Wartość boolowska |
| Wielkość partii asynchronicznej | Służy do podawania liczby wierszy ładowanych synchronicznie w ramach partii asynchronicznej. Ta opcja pomaga zoptymalizować wydajność ładowania synchronicznego w porównaniu z ładowaniem asynchronicznym. | ANY |
Zdarzenia
Na karcie Zdarzenia można ustawiać i modyfikować procedury obsługi zdarzeń elementu sterującego. Zdarzenia mogą być uruchamiane w sposób programowy lub w wyniku interakcji użytkownika z elementem sterującym. Informacje na temat definiowania i kodowania zdarzeń można znaleźć w sekcji Zdarzenia definiowane przez użytkownika.Nie ma interakcji między użytkownikiem i elementem sterującym Tabela danych usługi – zdarzenia są aktywowane, gdy użytkownik pobiera wynik lub błąd z wywołania przepływu usługi.
Element sterujący Tabela danych usługi ma następujące typy procedur obsługi zdarzeń:- Przy ładowaniu: aktywowana przy ładowaniu tabeli. Na
przykład:
me.setPageIndex(0); - Przy ładowaniu danych usługi: aktywowana, gdy usługa
Ajax dostarczająca dane do tabeli pomyślnie zakończy działanie. Na przykład:
alert("Usługa AJAX zwróciła dane"); - Przy wystąpieniu błędu danych usługi: aktywowana, gdy
usługa Ajax dostarczająca dane do tabeli pomyślnie zakończy działanie. Na
przykład:
alert("Usługa AJAX zwróciła błąd"); - Przy istnieniu komórki niestandardowej: aktywowana,
gdy jest ładowana komórka z niestandardowymi opcjami wyświetlania (właściwość konfiguracyjna Renderowanie ma wartość
Niestandardowe w sekcji Kolumna). Na przykład:
var div = document.createElement("div"); div.innerHTML =cell.row.data[cell.varName]; return div; - Przy ładowaniu wierszy: ma zastosowanie tylko w
przypadku tabel stronicowanych i jest aktywowana wyłącznie przy wyświetlaniu
wierszy. Na przykład:
alert("Wszystkie wiersze " + (all ? "" : "NOT") + " zostały załadowane"); - Przy wybraniu wiersza przez użytkownika: aktywowana
przy wybraniu wiersza przez użytkownika. Na przykład:
alert("Indeks wybranego wiersza to " + row.index);
Metody
Szczegółowe informacje o metodach dostępnych w elemencie sterującym Tabela danych usługi znajdują się w dokumentacji języka JavaScript.
Dodatkowe zasoby
Informacje na temat tworzenia formatki zawiera sekcja
Budowanie formatek.
Informacje o
standardowych właściwościach (Ogólne,
Konfiguracja, Pozycjonowanie,
Widoczność i Atrybuty HTML)
zawiera sekcja Właściwości widoku formatki.