Listbox
Description
La Listbox (listbox) est le composant le plus riche de BWEB. Elle affiche des données tabulaires depuis une table ORDA avec tri, recherche, pagination, sélection et colonnes configurables.
Les colonnes sont ajoutées par glisser-déposer depuis l'onglet Structure. Elle supporte les modes d'affichage fill (remplir), fixed (fixe) et navigation.
Paramètres de la table
| Propriété | Champ technique | Type | Description |
|---|---|---|---|
| Table | vt_TableName | select | Table ORDA source |
| Entités liées | vt_RelatedEntities | text | Relations ORDA à charger |
| Première requête | vt_FirstRequest | text | Requête initiale (expression 4D) |
| Fonction de tri | vt_FunctionSort | text | Fonction 4D pour le tri |
Zone de recherche
| Propriété | Champ technique | Type | Description |
|---|---|---|---|
| Wrapper recherche | vt_searchwrapper | select | UUID du wrapper contenant la recherche |
| Fonction recherche | vt_SearchFunction | text | Fonction 4D de recherche |
| Recherche custom seule | vb_OnlyUseMySeachFunction | checkbox | N'utilise que la fonction custom |
| Cacher au démarrage | vb_hideListboxAtStart | checkbox | Masque la listbox au chargement |
Paramètres des colonnes
| Propriété | Champ technique | Type | Description |
|---|---|---|---|
| Sélection multiple | vb_DisplayCheckbox | checkbox | Colonne de cases à cocher |
| Afficher entêtes | vb_DisplayHead | checkbox | Affiche les en-têtes de colonnes |
| Colonnes dynamiques | vt_DynamicColumnsFunction | text | Fonction 4D pour colonnes dynamiques |
Affichage
| Propriété | Champ technique | Type | Description |
|---|---|---|---|
| Type affichage | vt_DisplayListboxType | radio | fill, fixed, navigation |
| Lignes par page | vl_LengthByPage | number | Pagination |
| Lignes affichées | vl_DisplayLine | number | Nombre de lignes visibles |
| Nb résultats | vb_DisplayResults | checkbox | Affiche le nombre de résultats |
| Fond sélection | vt_SelectedRowBackgroundColor | color | Couleur fond ligne sélectionnée |
| Texte sélection | vt_SelectedRowTextColor | color | Couleur texte ligne sélectionnée |
| Fond survol | vt_HoverRowBackgroundColor | color | Couleur au survol |
Événements supportés :
on-SelectionChange — Déclenché au changement de sélection
on-SelectRows — Déclenché à la sélection de lignes
on-dblclick — Déclenché au double-clic sur une ligne
Paramètre
Table
Permet de sélectionner la table dans laquelle la listbox va chercher ces données.
Type d'affichage
Hauteur libre : la hauteur de la listbox n'a pas de limite et affiche tout ce qu'elle peut.
Hauteur fixe : la hauteur de la listbox a une limite max, une barre de défilement apparaitra pour pouvoir naviguer entre les lignes.
Pagination : la listbox a un nombre de lignes fixes, une pagination apparaitra en bas a droite pour pouvoir naviguer entre les différentes lignes ( regroupées par "page".
Nombre d'éléments chargés à chaque scroll
Nombre d'éléments qui sont chargés dans la listbox, à chaque fois qu'un utilisateur fait défiler les lignes.
Nombre de lignes à afficher
Nombre d'éléments qui sont affichés en même temps dans la listbox.
Nombre minimum de lignes à afficher
Nombre minimum d'éléments qui sont affichés en même temps dans la listbox.
Couleur du fond de la ligne séléctionnée
Permet de définir la couleur de fond que la ligne prendra lorsqu'on la sélectionnera.
Couleur du texte de la ligne séléctionnée
Permet de définir la couleur de texte que la ligne prendra lorsqu'on la sélectionnera.
Si besoin préciser le chemin de relation (ex: Entity.MaRelation)
Permet de lier le champ à une autre entité que celle du module en passant par une relation.
Première requête ou fonction à appeler pour la première requête
Nom de la première fonction / requête à exécuter pour récupérer les données de la listbox.
Fonction pour le tri personnalisé (ex: ds.MATABLE.sortColumn)
Permet de trier les lignes de la listbox en fonction de la méthode passée dans le paramètre.
Tableau avec les champs à afficher
Nécessite 'Table'
Permet de définir quelles sont les colonnes visibles dans la listbox et lesquelles ne le sont pas. Pour cela il suffit de glisser-déposer la propriété à afficher sur la partie droite.
Permettre la sélection multiple
Autorise l'utilisateur à sélectionner plusieurs lignes en même temps.
Afficher les entêtes
Si coché, affiche tout en haut des colonnes de la listbox, le nom de la colonne.
Fonction pour modifier dynamiquement les colonnes
Permet d'appeler une fonction dans le but de modifier dynamiquement les colonnes. Peut par exemple servir pour en rajouter dynamiquement.
Passage en carte en dessous de :
Permet de définir la taille pour laquelle la listbox doit s'afficher sous forme de card.
Nombre de colonnes en mode carte
Défini le nombre de colonnes que la listbox doit avoir lorsqu'elle est en mode card.
Nombre de lignes en mode carte
Défini le nombre de lignes que la listbox doit avoir lorsqu'elle est en mode card.
Couleur ligne paire
Permet de choisir la couleur de fond des lignes paires via un color picker. Attention la première ligne de la listbox étant la ligne n°0.
Couleur ligne impaire
Permet de choisir la couleur de fond des lignes impaires via un color picker. Attention la première ligne de la listbox étant la ligne n°0.
Couleur en survol
Permet de choisir la couleur de fond de la ligne lorsqu'on la survol avec la souris.
Couleur du texte en survol
Permet de choisir la couleur de texte de la ligne lorsqu'on la survol avec la souris.