Tabela

Umożliwia utworzenie tabeli przy użyciu innych widoków, takich jak tekst, liczba dziesiętna i tekst wyświetlany.

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 Ikona wielkości 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ści konfiguracyjne wyglądu elementu Tabela znajdują się w poniższej tabeli:
Tabela 1. Właściwości konfiguracyjne wyglądu elementu Tabela
Właściwość konfiguracyjna wyglądu Opis Typ danych
Styl tabeli Styl tabeli. Dostępne są następujące opcje:
  • Domyślny (bez krawędzi, jasnoszare tło)
  • Elegancki (poziome krawędzie, białe tło)
  • Krawędziowy (krawędzie wokół komórek)
  • Pasiasty (wiersze naprzemiennie z białym i jasnoszarym tłem)
  • Wiersz – wskazany myszą (wyróżnianie wierszy szarym kolorem po zatrzymaniu nad nimi wskaźnika)
  • Ścieśniony (zmniejszone odstępy między komórkami)
TableStyle
Styl koloru Styl koloru tabeli. Kolory odpowiadają zmiennym w podanej kompozycji. Dostępne są następujące opcje:
  • Brak
  • Jasny (jasnoszary)
  • Podstawowy (ciemnoniebieski)
  • Informacja (jasnoniebieski)
  • Powodzenie (zielony)
  • Ostrzeżenie (pomarańczowy)
  • Niebezpieczeństwo (czerwony)
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śćIkona wielkości ekranu 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ść Ikona wielkości ekranu 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ści konfiguracyjne zachowania elementu Tabela znajdują się w poniższej tabeli:
Tabela 2. Właściwości konfiguracyjne zachowania elementu Tabela
Właściwość konfiguracyjna zachowania Opis Typ danych
Tryb wyboru Służy do podawania liczby wierszy, które może wybrać użytkownik:
  • Brak
  • Pojedyncze
  • wieloma
W przypadku tabeli w trybie wyboru Wielokrotny użycie opcji Wybierz wszystko powoduje wybranie wszystkich danych, które są powiązane z tą tabelą.
TableSelectionMode
Pokaż przycisk Usuń Służy do pokazywania lub ukrywania przycisku usuwania wiersza. Boolean
Pokaż stopkęIkona wielkości ekranu 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 tabeliIkona wielkości ekranu 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ż pagerIkona wielkości ekranu 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 stronyIkona wielkości ekranu 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ść stronyIkona wielkości ekranu 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ści konfiguracyjne kolumny elementu Tabela znajdują się w poniższej tabeli.
Uwaga: Te właściwości określają sposób renderowania tabeli w czasie wykonywania.
Tabela 3. Właściwości konfiguracyjne kolumn elementu Tabela
Właściwość konfiguracyjna kolumn Opis Typ danych
Renderuj jako Sposób wyświetlania zawartości komórek:
  • Widok formatki
  • Jednolity widok formatki
  • Prosty kod HTML
  • Użytkownika

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:
var div = document.createElement("div");
div.innerHTML = cell.row.data["firstName"];
cell.setSortValue(cell.row.data["firstName"]);
return div;
Boolean
Opcje Opcje formatowania danych w kolumnie (w zależności od typu danych).
Okno wyboru daty
datePattern

Jeśli na przykład pożądany format to poniedziałek 08 cze, 2015, wpisz: "datePattern": "EEEE dd MMM, yyyy"

Wartości dziesiętne
thousandsSeparator, decimalPlaces, decimalSeparator, postfix, prefix

Na przykład:

"decimalPlaces": 2, "decimalSeparator": ".", "thousandSeparator": ",", "prefix": "$"

Liczba całkowita
thousandSeparator
Powiązanie
href
Te opcje działają tylko wtedy, gdy kolumna jest wyświetlana jako kod HTML lub widok niestandardowy. W przypadku wyświetlania widoku niestandardowego w zdarzeniu Przy istnieniu komórki niestandardowej można użyć metody cell.getFormattedValue(), aby pobrać wartość z zastosowanym formatowaniem.
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ści konfiguracyjne wydajności elementu Tabela znajdują się w poniższej tabeli:
Tabela 4. Właściwości konfiguracyjne wydajności elementu Tabela
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

Ten przykład przedstawia tworzenie prostej tabeli, która jest powiązana z listą obiektów biznesowych typu Profile. Obiekt biznesowy typu Profile ma następującą strukturę:
  • Parametr name typu String.
  • Parametr favoriteSport typu String.
  • Parametr favoritePlayer typu String.
Obiekt biznesowy Profile ma następujące wartości domyślne:
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";
autoObject

Usługa personelu po stronie klienta ma zmienną prywatną profile typu Profile[].

Strona zawiera widok Tabela z następującymi właściwościami:
  • 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.
Wskazówka: Aby szybko utworzyć tabelę, przeciągnij zmienną profili na stronę.

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.

To jest wynik w czasie wykonywania:
Należy kliknąć przycisk Dodaj i wprowadzić tekst w nowym wierszu. Na przykład:
Po kliknięciu przycisku OK zostanie załadowana druga strona i w tabeli zostaną wyświetlone dane dołączone do nowego utworzonego wiersza.

Typy wyświetlania

W przypadku właściwości konfiguracyjnej Wyświetl jako, która określa sposób wyświetlania treści w tabeli, są dostępne poniższe typy wyświetlania. Typem domyślnym wyświetlania jest Widok formatki.
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:
    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; } });
    Przykład, gdy wiersz jest wyświetlany jako:
    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.