Évaluation

Le composant Évaluation permet aux utilisateurs de fournir une note en sélectionnant un certain nombre d'icônes (généralement des étoiles, mais d'autres icônes peuvent être utilisées). C'est un moyen visuel et attrayant de collecter les retours des utilisateurs ou de représenter des données d'évaluation.

Aperçu

Le composant Évaluation est un élément d'entrée composant qui affiche une série d'icônes, permettant à l'utilisateur de cliquer sur une icône pour sélectionner une valeur d'évaluation. Le composant peut être utilisé en mode lecture seule ou interactif.

Principales caractéristiques

• Icône personnalisable : Choisissez l'icône pour représenter l'évaluation (les étoiles sont courantes, mais de nombreuses autres options sont disponibles).

• Échelle configurable : Définissez les valeurs minimale et maximale de l'évaluation.

• Modes lecture seule/désactivé : Affichez les évaluations sans permettre la saisie par l'utilisateur.

• Interactions : Déclenchez des actions lorsque l'utilisateur modifie l'évaluation.

• Sélection continue : sélectionnez plusieurs icônes à la fois en glissant sur le composant d'évaluation.

Configurer votre Évaluation

Sélectionnez le composant Évaluation sur la zone de travail pour accéder à ses propriétés dans le panneau Propriétés (panneau de droite).

Propriétés de base

Ces propriétés contrôlent les données fondamentales et l'étiquetage du composant Évaluation.

• Nom API : (Texte) Un identifiant unique pour ce composant Évaluation spécifique au sein de votre Composant Dynamique. Utilisez un nom descriptif (par ex., ProductRating, CustomerSatisfactionRating). Ce nom est utilisé pour référencer le composant dans les interactions et les formules.

• Étiquette : (Texte) Le libellé affiché au-dessus ou à côté des icônes d'évaluation. Exemple : "Notez ce produit :", "Votre satisfaction :", "Évaluation globale :".

• Aide au niveau du champ : (Texte, Optionnel) Texte d'aide affiché à côté du libellé, fournissant un contexte ou des instructions supplémentaires.

• Valeur : (Nombre) Ceci est la propriété la plus importante pour interagir avec le composant Évaluation. Il contient la valeur d'évaluation actuellement sélectionnée (par ex., 3, 5, 1).

  • Liaison de données : Vous devriez lier lier cette propriété à une Nombre ressource Variable. Cela vous permet de :

    • Stocker l'évaluation sélectionnée par l'utilisateur.

    • Utiliser la valeur d'évaluation dans d'autres parties de votre composant (par ex., dans des filtres, des formules ou des interactions).

    • Définir une par défaut évaluation en initialisant la ressource Variable.

Propriétés d'apparence

Ces propriétés contrôlent la présentation visuelle du composant Évaluation

• Nom de l'icône : (Texte) Le nom de l'icône à utiliser pour l'évaluation. Avonni utilise les icônes SLDS de Salesforce. Exemples courants :

  • utility:star (pour les évaluations par étoiles)

  • utility:like (pour pouces levés/pouces baissés)

  • utility:smiley_and_people (pour les visages souriants)

  • Voir la [Documentation des icônes SLDS de Salesforce](Insérer le lien ici) pour une liste complète des icônes disponibles.

  • Vous pouvez également lier lier cette propriété à une ressource Variable ou Formule pour changer dynamiquement l'icône en fonction des données ou des conditions.

• Variante : (Texte - Sélectionnez parmi les options) Contrôle le style visuel et le positionnement du libellé:

  • standard : Le libellé est affiché au-dessus des icônes d'évaluation.

  • label-inline : Le libellé est affiché à gauche des icônes d'évaluation.

  • label-stacked : Le libellé est affiché au-dessus des icônes d'évaluation (similaire à standard, mais peut avoir un espacement/une mise en forme différente).

  • label-hidden : Le libellé est masqué. N'utilisez ceci que si l'objectif de l'évaluation est clair à partir du contexte ou d'autres éléments de l'interface.

• Min : (Nombre) La valeur minimale autorisée pour l'évaluation. Il s'agit généralement de 0 ou 1. Consultez la documentation spécifique du composant pour la valeur par défaut.

• Max : (Nombre) La valeur maximale autorisée pour l'évaluation. Cela détermine le nombre total d'icônes affichées. La valeur par défaut est souvent 5.

• Valeur masquée : (Booléen - Case à cocher) Si activé, la valeur numérique d'évaluation est masquée, et seules les icônes sont affichées. Si désactivé, la valeur numérique peut être affichée à côté des icônes (selon le style du composant).

Propriétés de comportement

Ces propriétés contrôlent la façon dont l'utilisateur interagit avec le composant Évaluation et son comportement global

• Sélection : (Texte - Sélectionnez parmi les options) Contrôle la manière dont l'utilisateur peut sélectionner une évaluation :

  • continue : L'utilisateur peut sélectionner une valeur en glissant sur le composant.

  • unique : L'utilisateur peut sélectionner une valeur à la fois.

• Requis : (Booléen - Case à cocher) Si activé, l'utilisateur doit doit sélectionner une évaluation avant de pouvoir effectuer d'autres actions (par ex., soumettre un formulaire). Vous utiliserez généralement cela en conjonction avec une logique de validation.

• Lecture seule : (Booléen - Case à cocher) Si activé, l'utilisateur peut voir l'évaluation, mais il ne peut pas la modifier . Ceci est utile pour afficher des évaluations existantes.

• Désactivé : (Booléen - Case à cocher) Si activé, le composant Évaluation est entièrement désactivé et ne peut pas être manipulé. Ceci indique visuellement que l'évaluation n'est pas applicable ou ne peut pas être modifiée.

• Visible : (Booléen) Contrôle si le composant Évaluation est visible sur la page. Vous pouvez lier cela à une Variable Booléenne ou à une Formule pour une visibilité dynamique

Interactions

Le composant Évaluation prend en charge l' On Change interaction. Cette interaction est déclenchée chaque fois que l'utilisateur modifie sa sélection d'évaluation.

• On Change : Utilisez cette interaction pour :

  • Définir la valeur de la variable : Mettre à jour une ressource Variable avec la nouvelle valeur d'évaluation (depuis @RatingComponent.value). Il s'agit de la plus courante principal.

  • .). Lancer un Flux, en passant la nouvelle évaluation comme variable d'entrée.

  • Actualiser les données : Mettre à jour d'autres composants sur la page en fonction de la nouvelle évaluation.

  • Afficher un Toast : Afficher un message de confirmation.

Dans l'interaction « On Change », vous pouvez accéder à la valeur d'évaluation actuellement sélectionnée en utilisant :

@RatingComponent.value

@RangeSliderName.value RatingComponent RangeSliderName par le véritable de votre composant Évaluation). Cela renverra un Nombre.

: La valeur maximale.

Exemple 1 : Entrée d'évaluation basique

1. Ajoutez un composant Évaluation.

2. Min/Max : Étiquette à "Notez ce produit :".

3. Min/Max : Nom de l'icône sur utility:star.

4. Min/Max : Min sur 5.

5. Créez une ressource Variable de type Nombre nommée productRating.

6. Liez la propriété Liez la propriété {!productRating}.

du composant Évaluation. Cela crée une entrée d'évaluation basique à 5 étoiles. La sélection de l'utilisateur sera stockée dans la productRating variable.

Exemple 2 : Affichage en lecture seule de la note moyenne

1. Ajoutez un composant Évaluation.

2. Min/Max : Étiquette à "Note moyenne :".

3. Min/Max : Nom de l'icône sur utility:star.

4. Min/Max : Min sur 5.

5. Min/Max : Lecture seule pour être vrai.

6. Créez une variable, ou une formule, nommée averageRating.

7. Liez la propriété Liez la propriété {!averageRating}.

8. Utilisez une interaction Récupérer des enregistrements dans une interaction au chargement pour obtenir la valeur depuis Salesforce.

Cela va afficher la note moyenne (en supposant que vous ayez un moyen de la calculer et de la stocker dans la averageRating variable), mais l'utilisateur ne pourra pas la modifier.

Exemple 3 : Interaction On Change

1. Suivez les étapes de l'Exemple 1 pour créer l'Évaluation.

2. Sélectionnez le composant d'évaluation.

3. Allez dans les interactions et sélectionnez l' On Change

4. Ajoutez un Afficher Toast action qui confirme la note de l'utilisateur en utilisant la valeur de votre Composant Évaluation..

5. variable sera mise à jour, et vous pourrez utiliser ces valeurs pour filtrer un Data Table.

   • Liaison de données : La propriété propriété est cruciale. Liezz-la à une Variable de type Nombre pour stocker la sélection de l'utilisateur.

   • Lecture seule vs Désactivé : Comprenez la différence. Lecture seule empêche les modifications mais affiche toujours le composant ; Désactivé met le composant en gris et empêche toute interaction.

   • Interactions : Utilisez l'interaction « On Change » pour rendre votre composant Évaluation dynamique et réactif.

   • Accessibilité : Fournissez un Étiquette.

   • Variante : Adapte l'affichage du libellé.

En résumé : Le composant d'évaluation est un moyen simple de collecter et d'afficher les évaluations des utilisateurs, en utilisant une interface visuelle et intuitive basée sur des icônes