Selectie
De Table-component biedt verschillende selectiemogelijkheden. Er zijn methoden voor het selecteren van een enkel item, meerdere items of het programmatically beheren van selecties.
Voor informatie over het gebruik van het Repository-patroon om verzamelingen te beheren en te raadplegen, zie de Repository-artikelen.
Selectiemodus
De selectiemodus in de tabel bepaalt hoe items door de gebruiker kunnen worden geselecteerd. Het biedt opties om het gedrag van itemselectie te configureren. De Table-klasse biedt een methode om de selectiemodus in te stellen:
setSelectionMode(SelectionMode selectionMode)
Beschikbare opties voor SelectionMode zijn:
SINGLE- (enkele selectie)MULTI- (meerdere selecties)NONE- (geen selectie).
Selectie-gebeurtenis
Het Table-componentpakket geeft verschillende gebeurtenissen weer met betrekking tot rijenselectie. Deze gebeurtenissen vangen veranderingen in de selectiestatus van Table-rijen. Hieronder staan de belangrijkste selectiegemeenten met hun beschrijvingen:
TableItemSelectEvent- Emitted wanneer een tabelitem wordt geselecteerd.TableItemDeselectEvent- Emitted wanneer een tabelitem wordt gedeselecteerd.TableItemSelectionChange- Emitted wanneer de algehele selectie in de tabel verandert, of wanneer een aanvullende selectie wordt gemaakt.
De TableItemSelectEvent en TableItemDeselectEvent worden niet geactiveerd wanneer de modus voor meerdere selecties is ingeschakeld en de selectie wordt gemaakt via het selectievakje in de header. In dit geval moet TableItemSelectionChange worden gebruikt.
In het onderstaande voorbeeld wordt een TableItemSelectEvent-gebeurtenis geactiveerd telkens wanneer een gebruiker een rij selecteert. De gebeurtenis kan worden afgehandeld door een luisteraar aan de tabel toe te voegen met de methode onItemSelect().
Selectie met selectievakjes
Selectie met selectievakjes is ingeschakeld wanneer de selectiemodus MULTI is, en stelt gebruikers in staat om een of meer items gemakkelijk te selecteren met behulp van selectievakjes die aan elke rij zijn gekoppeld. Deze functie is bijzonder nuttig voor scenario's waarin gebruikers bulkacties moeten uitvoeren op geselecteerde items. De Table-klasse biedt methoden om selectie met selectievakjes in te schakelen en aan te passen.
Door de methode setCheckboxSelection(boolean checkboxSelection) te gebruiken, kunnen selectievakjes worden geconfigureerd om naast elke rij te worden weergegeven, zodat gebruikers items kunnen selecteren. Het onderstaande programma toont meerdere selecties en ingeschakelde selectie met selectievakjes:
Programmatically selecteren
De Table-component biedt programmatic selectiemethoden, waarmee je geselecteerde items kunt manipuleren, hetzij op basis van hun sleutels of op basis van de hele items.
Selecteren op sleutel
De methode selectKey(Object... keys) stelt je in staat om programmatically items te selecteren met behulp van hun sleutels. Je kunt een of meer sleutels naar deze methode doorgeven, en het zal de selectie dienovereenkomstig bijwerken.
Items selecteren
Tot slot stelt de methode select(T... items) je in staat om programmatically items te selecteren door een of meer items zelf naar deze methode door te geven om de selectie dienovereenkomstig bij te werken.
Blijf leren
ArtikelSpring Data JPA grid: sort, filter, and page in Java
ArtikelJava Data Grid: Build Fast, Sortable Tables with webforJ
ArtikelJava CRUD web app with Spring Boot and webforJ, step by step
ArtikelMulti-select in Java UI: ListBox and ChoiceBox with webforJ
ArtikelNatural language search for a Java table with webforJ
ArtikelJava web front end for a database: browse and edit