Passer au contenu principal

Selection

Ouvrir dans ChatGPT

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

Gestion et interrogation des données

Pour des informations sur la manière d'utiliser le 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 propose 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 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 effectuée via la case à cocher d'en-tête. Dans ce cas, 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 auditeur à la table en utilisant la méthode onItemSelect().

Afficher le code

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 des cases à cocher associées à chaque ligne. Cette fonctionnalité est particulièrement utile pour les scénarios où les utilisateurs doivent effectuer des actions en masse sur les é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 :

Afficher le code

Sélection programmatique​

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

Sélectionner par clé​

La méthode selectKey(Object... keys) vous permet de sélectionner programmatique les éléments 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 d'éléments d'entrée​

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