Sélection

Ouvrir dans ChatGPT

Le composant Table offre diverses capacités de sélection. Il existe des méthodes pour sélectionner un seul élément, plusieurs éléments, ou gérer les sélections de manière programmatique.

Gestion et requête de données

Pour des informations sur l'utilisation du modèle Repository pour gérer et interroger des collections, consultez les articles sur le Repository.

Mode de sélection

Le mode de sélection dans la table détermine comment les éléments peuvent être sélectionnés par l'utilisateur. Il offre des options pour configurer le comportement de la sélection des éléments. La classe Table fournit une méthode pour définir le mode de sélection :

setSelectionMode(SelectionMode selectionMode)

Les options de SelectionMode disponibles incluent :

• SINGLE - (sélection unique)
• MULTI - (sélection multiple)
• NONE - (pas de sélection).

Événement de sélection

Le package du composant Table émet plusieurs événements liés à la sélection des lignes. Ces événements capturent les changements dans l'état de sélection des lignes de la Table. Voici les principaux événements de sélection avec leurs descriptions :

• TableItemSelectEvent - Émis lorsqu'un élément de la table est sélectionné.
• TableItemDeselectEvent - Émis lorsqu'un élément de la table est désélectionné.
• TableItemSelectionChange - Émis lorsque la sélection globale dans la table change, ou lorsqu'une sélection supplémentaire est choisie.

info

Les événements TableItemSelectEvent et TableItemDeselectEvent ne sont pas déclenchés lorsque le mode de sélection multiple est actif et que la sélection est faite via la case à cocher de l'en-tête. Dans ce cas, le TableItemSelectionChange doit être utilisé à la place.

Dans l'exemple ci-dessous, un événement TableItemSelectEvent sera déclenché chaque fois qu'un utilisateur sélectionne une ligne. L'événement peut être géré en ajoutant un écouteur à la table en utilisant la méthode onItemSelect().

Sélection par case à cocher

La sélection par case à cocher est activée lorsque le mode de sélection est MULTI, et permet aux utilisateurs de sélectionner facilement un ou plusieurs éléments à l'aide de cases à cocher associées à chaque ligne. Cette fonctionnalité est particulièrement utile dans les scénarios où les utilisateurs doivent effectuer des actions en masse sur des éléments sélectionnés. La classe Table fournit des méthodes pour activer et personnaliser la sélection par case à cocher.

En utilisant la méthode setCheckboxSelection(boolean checkboxSelection), les cases à cocher peuvent être configurées pour s'afficher à côté de chaque ligne, permettant aux utilisateurs de sélectionner des éléments. Le programme ci-dessous montre la sélection multiple et la sélection par case à cocher activées :

Sélection programmatique

Le composant Table fournit des méthodes de sélection programmatique, vous permettant de manipuler des éléments sélectionnés soit par leurs clés, soit par les éléments eux-mêmes.

Sélection par clé

La méthode selectKey(Object... keys) vous permet de sélectionner des éléments de manière programmatique en utilisant leurs clés. Vous pouvez passer une ou plusieurs clés à cette méthode, et elle mettra à jour la sélection en conséquence.

Sélection des éléments d'entrée

Enfin, la méthode select(T... items) vous permet de sélectionner des éléments de manière programmatique en passant un ou plusieurs éléments eux-mêmes à cette méthode pour mettre à jour la sélection en conséquence.

Continuez à apprendre.

ArticleSpring Data JPA grid: sort, filter, and page in JavaArticleJava Data Grid: Build Fast, Sortable Tables with webforJArticleJava CRUD web app with Spring Boot and webforJ, step by stepArticleMulti-select in Java UI: ListBox and ChoiceBox with webforJArticleNatural language search for a Java table with webforJArticleJava web front end for a database: browse and edit