TSM - Componente vizuale Java FX

Tabelele reprezintă unul dintre cele mai puternice instrumente folosite în JavaFX pentru afişarea datelor, suportând următoarele acţiuni:

• Reordonarea coloanelor afişate de către utilizator,
• Sortarea multiplă a coloanelor,
• Redimensionarea,
• Factories de celulă pentru customizarea conţinutului celulei.

Mai multe clase din JavaFX SDK API sunt folosite pentru reprezentarea datelor în formă tabelară. Dintre acestea cele mai importante sunt TableView, TableColumn şi TableCell. Putem popula un tabel dintr-un model de date şi îi putem aplica apoi un cell factory.

TableView are facilităţi ce includ:

• API-ul TableColumn:

  • Suport pentru cell factories, ce permite o customizare a conţinutului celulei în ambele stări: de afişare şi de editare.
  • Specificarea minWidth, prefWidth, maxWidth, precum şi a coloanelor de dimensiune fixă.
  • La rulare, redimensionarea de către user.
  • La rulare, reordonarea coloanelor de către user.
  • Suport pentru încuibarea coloanelor.
• Diferite politici de redimensionare care determină ce se întâmplă atunci când utilizatorul redimensionează coloanele.
• Suport pentru sortarea pe mai multe coloane prin apăsarea header-ului de coloană (apăsând tasta Shift în timp ce facem click pe header)

Crearea unui tabel

Minimal avem nevoie de clasele următoarele pentru a crea un tabel:

• TableView <S> unde S este tipul obiectului ce conţine lista itemilor din TableView
• TableColumn<S, T>, unde S are tipul generic TableView, iar T este tipul conţinutului tuturor celulelor din acest TableColumn.

TableView este construit dintr-un număr de instanţe TableColumn. Fiecare TableColumn este responsabilă de afişarea şi de editarea conţinutului unei coloane. În plus TableColumn conţine proprietăţi pentru:

• Redimensionare,
• Vizibilitate,
• Afişarea textului de header,
• Afişarea coloanelor încuibate pe care le poate conţine,
• Afişarea unui meniu de context atunci când utilizatorul face click dreapta pe zona capului de coloană,
• Posibilităţi de sortare.

Când creăm o instanţă TableColumn, probabil cele mai importante proprietăţi de setat sunt textul (adică ce afişăm în capul de tabel al coloanei) şi cell value factory (utilizat pentru popularea celulelor individuale din coloană).

Clasa TableCell<S,T> reprezintă intersecţia unei linii cu o coloana în TableView. Conţine următoarele proprietăţi:

• tableColumn: instanţa TableColumn din spatele TableCell;
• tableView, TableView-ul asociat cu `TableCell;
• tableRow, TableRow-ul în care TableCell-ul este plasat;

Pentru a identifica intersecţia, TableCell conţine o proprietate de index.

Cell<T> este utilizat pentru o celulă individuală într-un TableView. Fiecare celulă este asociată unui singur item de date, reprezentat de proprietatea item. O celulă este responsabilă de renderizarea itemului care rezidă în el, care este de obicei un text. O celulă permite customizarea printr-un cell factory.

API-ul Cell este utilizat pentru virtualizarea controalelor precum ListView, TreeView şi TableView. Un Cell este un control etichetat, folosit pentru a renderiza o unitate într-unul dintre controalele mai sus amintite. Cell este responsabil atât pentru afişare cât şi pentru editarea item-ului. Pe lângă text, Cell poate fi reprezentată de alte controale precum CheckBox, ChoiceBox sau orice Node precum HBox, GridPane sau chiar Rectangle. Deoarece ListView, TreeView, TableView precum şi alte asemenea controale pot fi folosite pentru afişarea unei cantităţi mari de date, nu este practic să creăm un Cell pentru fiecare item din control. Fiecare celulă este reutilizată, ceea ce face acest control virtualizat.

Deoarece Cell este un Controler are în spate un model. Skin-ul său este responsabil pentru definirea look and layout-ului, în timp ce Behaviour este responsabil pentru manipularea evenimentelor şi utilizarea acelor informaţii continute pentru a modifica starea. Cell este stilizat prin CSS ca orice alt control.

Pentru a specializa o celulă utilizată pentru un TableView trebuie să furnizăm o implementare a funcţiei callback cellFactory() definită pe TableView. Cell factory este apelată de platformă ori de câte ori o nouă celulă trebuie să fie creată. Implementarea unui cell factory este responsabil pentru crearea unei instante Cell și pentru configurarea necesară pentru ca Cell să reacţioneze la schimbările stării sale.

Cell factory este responsabil de virtualizarea skin-urilor de container pentru a renderiza reprezentarea predefinită a unui item Cell. Spre exemplu, într-un ListView converteşte itemii la un String si apelează Labeled.setText(String). Dacă dorim să specializăm celula utilizată în ListView, trebuie să furnizăm implementarea funcţiei callback definită pe ListView.

Cell factory este apelat de platformă ori de câte ori determină că o celula trebuie să fie creată. Spre exemplu, un ListView are 10 milioane de itemi. Crearea tuturor celor 10 milioane este foarte costisitoare. Aşadar, implementarea skin-ului ListView va crea doar atâtea celule cât să umple spaţiul vizual. Dacă se redimensionează spaţiul vizual, sistemul va determina dacă este nevoie de crearea altor celule. În acest caz va apela cellFactory() (dacă există vreuna) pentru a crea o implementare Cell. Dacă nu este furnizată niciuna implementarea predefinită este utilizată.

ObservableList este modelul de date care stă la baza lui TableView. O instanţă TableView este definită astfel:

TableView<Person> table = new TableView<>();

Am definit astfel un tabel primar. Modelul de date este creat pe baza unui ObservableList. Îl putem seta direct în TableView. Spre exemplu:

ObservableList<Person> teamMembers = getTeamMembers();

table.setItems(teamMembers);

O dată setată lista de itemi, TableView este automat updatată ori de câte ori lista teamMembers se modifică. Dacă lista de itemi este disponibilă înainte ca TableView să fie instanţiat, este posibil să o trimitem direct în constructor.

Ceea ce mai trebuie să facem este să împărțim datele conţinute în model în una sau mai multe instanţe TableColumn. Pentru a crea un TableView cu două coloane, ce afişează firstName şi lastName vom folosi codul:

 public class DataTable extends Application {

    TableView<Person> table = new TableView<>();

    BorderPane root = new BorderPane();

    VBox mainBox = new VBox(); // Container for content

    final ObservableList<Person> teamMembers = FXCollections

            ._observableArrayList_(new Person("Ion", "Tech"), new Person("Petre","Petrescu"), new Person("Doru", "Dorescu"), new Person(

                    "Vasile", "Vasilescu"));

    @Override

    public void init() {

        Label centerLbl = new Label("Persons");

        centerLbl.setStyle("-fx-font-size:16pt; -fx-font-weight:bold;");

        table.setItems(teamMembers);

        TableColumn<Person, String> firstNameCol = new TableColumn<Person, String>("First Name");

        firstNameCol    .setCellValueFactory(new PropertyValueFactory<Person, String>("firstName"));

        TableColumn<Person, String> lastNameCol = new TableColumn<Person, String>("Last Name");

        lastNameCol.setCellValueFactory(new PropertyValueFactory<Person, String>("lastName"));

        table.getColumns().setAll(firstNameCol, lastNameCol);

        mainBox.getChildren().add(centerLbl);

        mainBox.getChildren().add(table);

    }

    @Override

    public void start(Stage primaryStage) {

        primaryStage.setTitle("Data Table");

        root.setCenter(mainBox);

        primaryStage.setScene(new Scene(root, 400, 300));

        primaryStage.show();

    }

    public static void main(String[] args) {

        _launch_(args);

    }

}

Prin aceasta am definit complet proprietăţile minime cerute pentru a crea o instanţă TableView. Nici o altă proprietate a clasei Person nu va fi afişată pentru că nu avem definite alte TableColumn.

Implementarea unui cell factory este responsabilă nu doar pentru crearea instanţei Cell, dar şi pentru configurarea acelei celule. În exemplul următor am creat o clasă Callback ce are ca atribute instanţe ale claselor TextAlignment şi Format cu parametrii:

• S, tipul generic al lui TableView;
• T, tipul conţinutului în toate celulele lui TableColumn

public class FormattedTableCellFactory<S, T> implements

        Callback<TableColumn<S, T>, TableCell<S, T>> {

    private TextAlignment alignment;

    private Format format;

    public TextAlignment getAlignment() {

        return alignment;

    }

    public void setAlignment(TextAlignment alignment) {

        this.alignment = alignment;

    }

    public Format getFormat() {

        return format;

    }

    public void setFormat(Format format) {

        this.format = format;

    }

    @Override

    public TableCell<S, T> call(TableColumn<S, T> p) {

        TableCell<S, T> cell = new TableCell() {

            @Override

            public void updateItem(Object item, boolean empty) {

                if (item == getItem())

                    return;

                super.updateItem(item, empty);

                if (item == null) {

                    super.setText(null);

                    super.setGraphic(null);

                } else if (format != null) {

                    super.setText(format.format(item));

                } else if (item instanceof Node) {

                    super.setText(null);

                    super.setGraphic((Node) item);

                } else {

                    super.setText(item.toString());

                    super.setGraphic(null);

                }

            }

        };

        cell.setTextAlignment(alignment);

        switch (alignment) {

        case _CENTER_:

            cell.setAlignment(Pos._CENTER_);

            break;

        case _RIGHT_:

            cell.setAlignment(Pos._CENTER_RIGHT_);

            break;

        default:

            cell.setAlignment(Pos._CENTER_LEFT_);

            break;

        }

        return cell;

    }

}

Respectiv:

FormattedTableCellFactory<Person, String> xx = new FormattedTableCellFactory<>();

xx.setAlignment(TextAlignment._CENTER_);

firstNameCol.setCellFactory(xx);

Beneficiile utilizării CSS-urilor pentru a seta stilul unui tabel constau în eficienţa de timp şi eficienţa de memorie, usurinţa utilizării şi construirii bibliotecilor pentru celule, usurinţa customizării formatării de afişare.

Utilizăm CSS-ul pentru a seta culorile celulei:

• Fiecare celulă poate fi stilizată direct din CSS. Spre exemplu, dacă dorim să schimbăm culoarea predefinită a background-ului fiecarei celule din TableView la alb, trebuie să utilizăm urmatorul CSS

.table-cell { -fx-padding: 3 3 3 3; 
-fx-background-color: white; 

}

• Pentru a seta culorile unor celule selectate dintr-un TableView, la albastru, vom folosi urmatorul CSS:

.table-cell:selected { -fx-background-color: blue; 

} 

Pentru ca table-cell:selected să funcționeze trebuie să setam cellSelectionEnabled la true.

Multe implementări de celulă extind IndexedCell în loc de Cell. Aceasta permite adăugarea altor două pseudoclase: odd și even. Cu acestea putem obține colorarea alternantă a liniilor prin intermediul unui CSS de forma:

.table-row-cell:odd{

    -fx-background-color:lightblue;

}

Vă mulţumim pentru lectură şi aşteptăm cu plăcere, ca întotdeauna, discuţiile cu toţi cei interesaţi.