Composants graphiques

Cette section référence les composants Blazor de Lagoon (préfixe Lg). Chaque page détaille les propriétés, événements et méthodes publiques vérifiés par rapport au code source du framework.

Le tableau ci-dessous recense l'ensemble des composants documentés, regroupés par usage. Cliquez sur un composant pour accéder à sa page de référence.

Interagir avec l'utilisateur

Boutons & actions

Composant	Description
`LgButton`	Bouton standard gérant les actions utilisateur (variantes, icônes, confirmation, lien).
`LgActionPanel`	Zone horizontale combinant une action principale à gauche et une barre d'outils à droite.
`LgCopyButton`	Bouton qui copie une valeur dans le presse-papiers.
`LgPasteButton`	Bouton qui colle le texte du presse-papiers.
`LgLabelAction`	Valeur en lecture accompagnée d'un libellé et d'un bouton d'action.

Barres d'outils

Composant	Description
`LgToolbar`	Conteneur de barre d'outils organisant boutons, groupes et menus.
`LgToolbarButton`	Bouton adapté aux barres d'outils (rendu bouton ou élément de menu).
`LgToolbarGroup`	Regroupe plusieurs éléments d'une toolbar dans un `btn-group`.
`LgToolbarMenu`	Ajoute un menu déroulant à une toolbar.
`LgCrudToolbarButton`	Bouton de toolbar avec actions secondaires (renommer, enregistrer, supprimer).

Composant	Description
`LgHyperlink`	Lien hypertexte.
`LgNavLink`	Lien de navigation avec gestion de l'état actif.
`LgNavigationBox`	Zone de recherche de navigation.

Édition & saisie

Composant	Description
`LgHtmlEditor`	Éditeur HTML (Jodit) lié à `@bind-Value` et validable dans un `LgEditForm`.
`LgInputFile`	Sélection, téléversement, téléchargement et suppression de fichiers liés.

Fenêtres modales

Composant	Description
`LgModal`	Fenêtre modale déplaçable (titre, contenu, pied de page, toolbar, confirmation de fermeture).

Libellés & icônes

Composant	Description
`LgIcon`	Icône de la bibliothèque Lagoon, avec bulle d'aide et clic optionnels.
`LgLabel`	Libellé traduit, associable à un champ par l'attribut `for`.
`LgTitle`	Titre de section rendu en `h1` à `h6`.

Formulaires

Formulaire & validation

Composant	Description
`LgEditForm`	Formulaire d'édition avec validation (DataAnnotations, `IValidatableObject`, ModelState).
`LgValidator`	Ajout d'erreurs de validation personnalisées (règles métier, erreurs serveur) au formulaire.

Champs de saisie

Composant	Description
`LgTextBox`	Champ texte (simple, multiligne, mot de passe, masque de saisie).
`LgNumericBox`	Saisie numérique (format, décimales, arrondi, boutons d'incrément).
`LgSummaryBox`	Texte long édité dans une fenêtre modale, avec éditeur HTML optionnel.
`LgTagBox`	Saisie d'une liste de valeurs texte sous forme d'étiquettes.
`LgSuggestBox`	Champ texte avec suggestions filtrées pendant la saisie (source locale ou distante).
`LgColorPickerBox`	Sélection d'une couleur depuis une palette, avec saisie hexadécimale.

Sélection

Composant	Description
`LgSelect`	Sélection d'une valeur unique dans une liste déroulante.
`LgCheckBox`	Case à cocher.
`LgCheckBoxList`	Sélection multiple par liste de cases à cocher.
`LgRadioGroup`	Groupe de boutons radio à sélection unique.
`LgToggle`	Interrupteur booléen (on/off) avec textes personnalisables.

Date & heure

Composant	Description
`LgDateBox`	Saisie et sélection d'un jour (calendrier, bornes, formats).
`LgMonthBox`	Sélection d'un mois.
`LgWeekBox`	Sélection d'une semaine (numéro ISO).
`LgYearBox`	Saisie et sélection d'une année (`int`).
`LgTimeBox`	Saisie d'une heure (masque ou horloge interactive).

Conteneurs & mise en page

Frames

Composant	Description
`LgFrame`	Conteneur structurant (en-tête, corps, résumé, pied de page, toolbar, repliable).
`LgFilterFrame`	Panneau de filtres prêt à l'emploi (réinitialisation, filtres avancés).

Autres conteneurs

Composant	Description
`LgAccordion`	Accordéon de panneaux `LgAccordionPane` dont un seul reste ouvert à la fois.
`LgCard`	Carte de contenu cliquable, navigable ou commandable (+ `LgCardSeparator`, `LgCardStripe`).
`LgPager`	Barre de pagination (total de pages connu ou inconnu).
`LgSplitContainer`	Deux panneaux redimensionnables séparés par un grip.

Structure de l'application

Composant	Description
`LgMenuConfiguration`	Déclaration centralisée du menu principal, de la sidebar et des barres d'outils.
`LgMenuItem`	Entrée de navigation ou d'action du menu.
`LgMenuTitle`	Titre de section dans le menu.
`LgMenuSeparator`	Trait de séparation entre groupes d'actions du menu.

Onglets

Composant	Description
`LgTabContainer`	Onglets horizontaux (activation, ouverture, fermeture, déplacement, rechargement).
`LgSideTabContainer`	Onglets latéraux avec colonne redimensionnable.

Repérage

Composant	Description
`LgBreadcrumbTrail`	Fil d'Ariane pour situer l'utilisateur dans la navigation.

Autorisations

Composant	Description
`LgAuthorizeView`	Conditionne l'affichage et l'édition d'une zone de l'UI aux policies.
`LgCascadingPolicies`	Propage des policies validées à un sous-arbre de composants.

Données & listes

Grilles

Composant	Description
`LgGridView`	Grille de données (afficher, filtrer, trier, grouper, paginer, sélectionner, éditer, exporter).

Colonnes de grille

Composant	Description
`LgGridTextColumn`	Colonne texte (valeur `string`) et base des paramètres communs.
`LgGridCustomColumn`	Colonne générique liée à une valeur de type quelconque.
`LgGridBooleanColumn`	Colonne booléenne sous forme de case à cocher.
`LgGridColorColumn`	Colonne d'édition d'une couleur depuis une palette.
`LgGridDateColumn`	Colonne date (précision jour ou mois).
`LgGridMonthColumn`	Colonne mois (`MM/yyyy`) d'une valeur date.
`LgGridWeekColumn`	Colonne semaine (numéro de semaine) d'une valeur date.
`LgGridYearColumn`	Colonne année (`yyyy`) d'une valeur date.
`LgGridTimeColumn`	Colonne heure ou durée.
`LgGridNumericColumn`	Colonne numérique avec formatage, préfixe et suffixe.
`LgGridEnumColumn`	Colonne d'énumération avec filtre de sélection.
`LgGridEnumListColumn`	Colonne de liste d'énumérations (multi-sélection).
`LgGridSelectColumn`	Colonne liée à une source de données pour affichage, édition et filtrage.
`LgGridSelectMultipleColumn`	Colonne d'édition et de filtre d'une collection de valeurs.
`LgGridSelectionColumn`	Colonne de sélection de lignes (multiple ou unique).
`LgGridImageColumn`	Colonne affichant une image à partir d'une URL ou d'un chemin calculé.
`LgGridTagBoxColumn`	Colonne de tags texte libres.
`LgGridSummaryColumn`	Colonne adaptée aux longs textes et au contenu HTML éditable.
`LgGridCommandColumn`	Colonne affichant un bouton ou un menu de commandes.
`LgGridEditColumn`	Colonne d'édition en ligne (Modifier / Sauvegarder / Annuler / Supprimer).
`LgGridSeparatorColumn`	Colonne de séparateur vertical entre groupes de colonnes.

Timeline

Composant	Description
`LgTimelineContainer`	Conteneur d'une suite d'étapes `LgTimelineStep` en timeline horizontale.
`LgTimelineStep`	Étape validable d'une timeline (libellés, contenu central, état cliquable).

Curseurs

Composant	Description
`LgSlider`	Curseur de sélection d'une valeur unique sur une échelle bornée.
`LgSliderRange`	Curseur de sélection d'une plage entre deux bornes.

Autres présentations de données

Composant	Description
`LgCalendar`	Calendrier annuel ou multi-mois, avec une ligne par jour.
`LgListView`	Liste de cartes personnalisable avec chargement local ou distant, tri, filtres, pagination et sélection.
`LgTreeView`	Arborescence repliable pour des données hiérarchiques.
`LgWorkScheduler`	Planning de charge interactif (tâches, jalons, glisser-déposer).
`LgLeafletMap`	Carte Leaflet (conteneur Blazor piloté par l'objet `LeafletMap`).
`LgDocument`	Affichage de documents (image, vidéo, cadre) téléchargés via un blob.
Graphiques (Chart.js)	Intégration de graphiques via un package tiers (pas de composant natif).

Donner du feedback

Messages

Composant	Description
`LgBanner`	Bannière d'information contextuelle persistante dans la page.
`LgBigMessage`	Message centré pleine page (icône, titre, description).
`LgEmptyMessage`	État vide affiché lorsqu'une zone ne contient aucune donnée.
Toasts	Retours brefs non bloquants déclenchés par les méthodes de `LgComponentBase`.

Indicateurs de progression

Composant	Description
`LgProgress`	Barre de progression horizontale (bornée ou indéterminée).
`LgCircleProgress`	Progression circulaire compacte.
`LgLoaderView`	État de chargement remplacé automatiquement par le contenu final.

Notifications

Composant	Description
`LgNotificationMenuItem`	Entrée de notifications dans le menu (icône, compteur de non-lues, liste).
`LgNotificationItem`	Rendu d'une notification individuelle.
`LgNotificationCounter`	Pastille numérique de notifications.
Notifications utilisateur	Guide du système de notifications (module `Lagoon.UI.Notifications`).
Notifications WebPush	Notifications du navigateur au niveau du système d'exploitation.
Remote Progress & Background Task	Suivi d'une tâche longue serveur via SignalR.

Interagir avec l'utilisateur​

Boutons & actions​

Barres d'outils​

Navigation & liens​

Édition & saisie​

Fenêtres modales​

Libellés & icônes​

Formulaires​

Formulaire & validation​

Champs de saisie​

Sélection​

Date & heure​

Conteneurs & mise en page​

Frames​

Autres conteneurs​

Structure de l'application​

Menu​

Onglets​

Repérage​

Autorisations​

Données & listes​

Grilles​

Colonnes de grille​

Timeline​

Curseurs​

Autres présentations de données​

Donner du feedback​

Messages​

Indicateurs de progression​

Notifications​