Aller au contenu principal

LgIcon

LgIcon affiche une icône de la bibliothèque de l'application (SVG généré à la compilation). Les noms d'icônes sont exposés par les constantes générées IconNames.All.*. L'icône peut porter une bulle d'aide et réagir au clic.

<LgIcon IconName="@IconNames.All.Check" />
  • Espace de noms : Lagoon.UI.Components
  • Hérite de : LgAriaComponentBase → LgComponentBase
  • Package NuGet : Lagoon.UI
Galerie des icônes

Chaque application Lagoon expose la page intégrée LgPageIcons sur la route lg/icon-library : elle liste toutes les icônes disponibles avec leur nom IconNames.All.*.

Utilisation​

Icône simple​

IconName s'utilise avec les constantes générées IconNames.All.* (les icônes du module et celles des modules Lagoon référencés sont fusionnées à la compilation).

StatusPage.razor
<LgIcon IconName="@IconNames.All.CheckCircleFill" CssClass="text-success" />
<LgIcon IconName="@IconNames.All.ExclamationTriangleFill" CssClass="text-warning" />

Bulle d'aide​

HelpPage.razor
<LgIcon IconName="@IconNames.All.InfoCircle"
Tooltip="#FieldHelpText" />

Icône cliquable​

OnClick rend l'icône interactive. Pensez à AriaLabel : l'icône seule n'a pas de libellé accessible.

FilterPage.razor
<LgIcon IconName="@IconNames.All.XCircle"
AriaLabel="#ClearFilters"
Tooltip="#ClearFilters"
OnClick="ClearFiltersAsync" />
FilterPage.razor.cs
public partial class FilterPage : LgPage
{
// Réinitialise les filtres de l'écran : action légère, une icône suffit.
private Task ClearFiltersAsync(ActionEventArgs args)
{
ShowInformation("#FiltersCleared");
return Task.CompletedTask;
}
}
Icône ou bouton ?

Pour une action importante ou soumise à des droits, préférez LgButton avec IconName : il apporte l'état désactivé, les policies, la confirmation et la prévention du double-clic.

Rendu statique​

La méthode statique GetMarkupContent(iconName, cssClass) retourne le SVG de l'icône sous forme de chaîne, utile pour composer du HTML manuellement (par exemple dans un template de cellule).

Propriétés​

Toutes les propriétés [Parameter] du composant, y compris celles héritées.

NomTypeDéfautDéclaré dansDescription
AdditionalAttributesIReadOnlyDictionary<string, object>nullLgIconAttributs HTML additionnels appliqués à l'élément SVG rendu.
CssClassstringnullLgIconClasses CSS additionnelles.
IconNamestringnullLgIconNom de l'icône (IconNames.All.*).
OnClickEventCallback<ActionEventArgs>—LgIconCallback déclenché au clic sur l'icône.
TooltipstringnullLgIconBulle d'aide.
TooltipIsHtmlboolfalseLgIconIndique si le contenu du Tooltip est au format HTML (sinon texte brut).
AriaLabelstringnullLgAriaComponentBaseValeur de l'attribut aria-label.
AriaLabelledBystringnullLgAriaComponentBaseValeur de l'attribut aria-labelledby.

Méthodes & événements​

MembreSignatureDescription
OnClickEventCallback<ActionEventArgs>Au clic sur l'icône.
GetMarkupContentstatic string GetMarkupContent(string iconName, string cssClass = null)Retourne le SVG de l'icône sous forme de chaîne HTML.

Bonnes pratiques / accessibilité​

  • Renseignez AriaLabel (ou associez un texte visible) dès que l'icône porte une information ou une action ; une icône décorative peut rester muette.
  • Utilisez toujours les constantes IconNames.All.* plutôt qu'un nom en dur : le nom est vérifié à la compilation.
Référence complète

Tous les paramètres : Référence API — LgIcon.

Composants liés​

  • LgButton — bouton avec icône, à préférer pour les actions.
  • LgLabel — libellé pouvant accompagner une icône.