Bewertung

Die Bewertungs-Komponente ermöglicht es Benutzern, eine Bewertung abzugeben, indem sie eine Anzahl von Symbolen auswählen (typischerweise Sterne, aber auch andere Symbole können verwendet werden). Es ist eine visuell ansprechende Methode, um Benutzerfeedback zu sammeln oder Bewertungsdaten darzustellen.

Übersicht

Die Bewertungs-Komponente ist eine Eingabe Komponente, die eine Reihe von Symbolen anzeigt und es dem Benutzer ermöglicht, auf ein Symbol zu klicken, um einen Bewertungswert auszuwählen. Die Komponente kann sowohl im schreibgeschützten als auch im interaktiven Modus verwendet werden.

Hauptmerkmale

• Anpassbares Symbol: Wählen Sie das Symbol zur Darstellung der Bewertung (Sterne sind üblich, aber viele andere Optionen sind verfügbar).

• Konfigurierbare Skala: Legen Sie die minimalen und maximalen Bewertungswerte fest.

• Schreibgeschützter/Deaktivierter Modus: Bewertungen anzeigen, ohne Benutzereingaben zuzulassen.

• Interaktionen: Aktionen auslösen, wenn der Benutzer die Bewertung ändert.

• Kontinuierliche Auswahl: Wählen Sie mehrere Symbole gleichzeitig durch Ziehen über die Bewertungs-Komponente aus.

Einrichtung Ihrer Bewertung

Wählen Sie die Bewertungs-Komponente auf der Arbeitsfläche aus, um auf ihre Eigenschaften im Eigenschaftenbereich (rechter Bereich) zuzugreifen.

Grundlegende Eigenschaften

Diese Eigenschaften steuern die grundlegenden Daten und die Beschriftung der Bewertungs-Komponente.

• API-Name: (Text) Ein einzigartiger Bezeichner für diese spezifische Bewertungs-Komponente innerhalb Ihrer dynamischen Komponente. Verwenden Sie einen beschreibenden Namen (z. B. ProduktBewertung, KundenzufriedenheitsBewertung). Dieser Name wird zur Referenzierung der Komponente in Interaktionen und Formeln verwendet.

• Bezeichnung: (Text) Das Textlabel, das über oder neben den Bewertungssymbolen angezeigt wird. Beispiel: "Bewerten Sie dieses Produkt:", "Ihre Zufriedenheit:", "Gesamtbewertung:".

• Feldniveau-Hilfe: (Text, optional) Hilfetext, der neben dem Label angezeigt wird und zusätzlichen Kontext oder Anweisungen bietet.

• Wert: (Zahl) Dies ist die wichtigste Eigenschaft für die Interaktion mit der Bewertungs-Komponente. Sie enthält den aktuell ausgewählten Bewertungswert (z. B. 3, 5, 1).

  • Datenbindung: Sie sollten binden diese Eigenschaft an eine Zahl Variable-Ressource binden. Dadurch können Sie:

    • Die vom Benutzer ausgewählte Bewertung speichern.

    • Den Bewertungswert in anderen Teilen Ihrer Komponente verwenden (z. B. in Filtern, Formeln oder Interaktionen).

    • Setzen Sie eine Standard Bewertung, indem Sie die Variable-Ressource initialisieren.

Aussehens-Eigenschaften

Diese Eigenschaften steuern die visuelle Darstellung der Bewertungs-Komponente

• Symbolname: (Text) Der Name des Symbols, das für die Bewertung verwendet werden soll. Avonni verwendet Salesforce SLDS-Symbole. Häufige Beispiele:

  • utility:star (für Sternbewertungen)

  • utility:like (für Daumen hoch/Daumen runter)

  • utility:smiley_and_people (für Smileys)

  • Siehe die [Salesforce SLDS Icon Dokumentation](Link hier einfügen) für eine vollständige Liste der verfügbaren Symbole.

  • Sie können diese Eigenschaft auch binden an eine Variable- oder Formel-Ressource binden, um das Symbol basierend auf Daten oder Bedingungen dynamisch zu ändern.

• Variante: (Text - Auswahl aus Optionen) Steuert den visuellen Stil und die Positionierung des Labels:

  • standard: Label wird über den Bewertungssymbolen angezeigt.

  • label-inline: Label wird links von den Bewertungssymbolen angezeigt.

  • label-stacked: Label wird über den Bewertungssymbolen angezeigt (ähnlich wie standard, könnte aber unterschiedliche Abstände/Styling haben).

  • label-hidden: Das Label ist ausgeblendet. Verwenden Sie dies nur, wenn der Zweck der Bewertung aus dem Kontext oder anderen UI-Elementen klar ist.

• Min: (Zahl) Der zulässige minimale Bewertungswert. Dies ist normalerweise 0 oder 1. Prüfen Sie die spezifische Dokumentation der Komponente für den Standardwert.

• Max: (Zahl) Der zulässige maximale Bewertungswert. Dies bestimmt die Gesamtanzahl der angezeigten Symbole. Der Standard ist oft 5.

• Wert verborgen: (Boolean - Kontrollkästchen) Wenn aktiviert, wird der numerische Bewertungswert ausgeblendet und nur die Symbole werden angezeigt. Wenn deaktiviert, kann der numerische Wert je nach Styling der Komponente neben den Symbolen angezeigt werden.

Verhaltens-Eigenschaften

Diese Eigenschaften steuern, wie der Benutzer mit der Bewertungs-Komponente interagiert und deren allgemeines Verhalten

• Auswahl: (Text - Auswahl aus Optionen) Steuert, wie der Benutzer eine Bewertung auswählen kann:

  • kontinuierlich: Der Benutzer kann einen Wert durch Ziehen auf der Komponente auswählen.

  • einzeln: Der Benutzer kann jeweils einen Wert auswählen.

• Erforderlich: (Boolean - Kontrollkästchen) Wenn aktiviert, muss der Benutzer muss eine Bewertung auswählen, bevor er andere Aktionen ausführen kann (z. B. ein Formular absenden). Dies wird typischerweise zusammen mit Validierungslogik verwendet.

• Schreibgeschützt: (Boolean - Kontrollkästchen) Wenn aktiviert, kann der Benutzer die Bewertung sehen, aber er kann sie nicht ändern. Dies ist nützlich, um vorhandene Bewertungen anzuzeigen.

• Deaktiviert: (Boolean - Kontrollkästchen) Wenn aktiviert, ist die Bewertungs-Komponente vollständig deaktiviert und kann nicht interagiert werden. Dies zeigt visuell an, dass die Bewertung nicht zutreffend ist oder nicht geändert werden kann.

• Sichtbar: (Boolean) Steuert, ob die Bewertungs-Komponente auf der Seite sichtbar ist. Sie können dies an eine boolesche Variable oder Formel binden, um dynamische Sichtbarkeit zu erreichen

Interaktionen

Die Bewertungs-Komponente unterstützt die On Change Interaktion. Diese Interaktion wird ausgelöst, wann immer der Benutzer seine Bewertungswahl ändert.

• On Change: Verwenden Sie diese Interaktion, um:

  • Variable Wert setzen: Aktualisieren Sie eine Variable-Ressource mit dem neuen Bewertungswert (von @RatingComponent.value). Dies ist das häufigste Anwendungsfall.

  • Flow ausführen: Starten Sie einen Flow und übergeben Sie die neue Bewertung als Eingabevariable.

  • Daten aktualisieren: Aktualisieren Sie andere Komponenten auf der Seite basierend auf der neuen Bewertung.

  • Toast anzeigen: Zeigen Sie eine Bestätigungsnachricht an.

Innerhalb der "Bei Änderung"-Interaktion können Sie auf den aktuell ausgewählten Bewertungswert zugreifen mit:

@RatingComponent.value

(Ersetzen Sie RatingComponent durch den tatsächlichen API-Namen Ihrer Bewertungs-Komponente). Dies gibt einen Zahl.

Beispiele

Beispiel 1: Einfaches Bewertungs-Eingabefeld

1. Fügen Sie eine Bewertungs-Komponente hinzu.

2. Setzen Sie die Beschriftung zu "Bewerten Sie dieses Produkt:".

3. Setzen Sie die Symbolname auf utility:star.

4. Setzen Sie die Max auf 5.

5. Erstellen Sie eine Zahlenvariable-Ressource namens produktBewertung.

6. Binden Sie das Wert Eigenschaft des Range-Sliders an {!productRating}.

Dies erstellt eine einfache 5-Sterne-Bewertungseingabe. Die Auswahl des Benutzers wird in der produktBewertung Variable zu.

Beispiel 2: Schreibgeschützte Anzeige der Durchschnittsbewertung

1. Fügen Sie eine Bewertungs-Komponente hinzu.

2. Setzen Sie die Beschriftung zu "Durchschnittsbewertung:".

3. Setzen Sie die Symbolname auf utility:star.

4. Setzen Sie die Max auf 5.

5. Setzen Sie die Schreibgeschützt auf true gesetzt werden.

6. Erstellen Sie eine Variable oder Formel namens durchschnittsBewertung.

7. Binden Sie das Wert Eigenschaft des Range-Sliders an {!averageRating}.

8. Verwenden Sie eine Datensätze abrufen in der Lade-Interaktion, um den Wert von Salesforce abzurufen.

Dies wird anzeigen die Durchschnittsbewertung (vorausgesetzt, Sie haben eine Möglichkeit, sie zu berechnen und in der durchschnittsBewertung Variable zu speichern), aber der Benutzer kann sie nicht ändern.

Beispiel 3: Bei-Änderung-Interaktion

1. Folgen Sie den Schritten aus Beispiel 1, um die Bewertung zu erstellen.

2. Wählen Sie die Bewertungs-Komponente aus.

3. Gehen Sie zu den Interaktionen und wählen Sie die On Change

4. Fügen Sie eine Show Toast Aktion, die die Bewertung des Benutzers bestätigt, wobei der Wert Ihrer Bewertungs- Komponente..

5. Wichtige Überlegungen

   • Datenbindung: Die Wert Eigenschaft ist entscheidend. Binden Sie sie an eine Zahlenvariable, um die Auswahl des Benutzers zu speichern.

   • Schreibgeschützt vs. Deaktiviert: Verstehen Sie den Unterschied. Schreibgeschützt verhindert Änderungen, zeigt die Komponente aber weiterhin an; Deaktiviert macht die Komponente grau und verhindert jede Interaktion.

   • Interaktionen: Verwenden Sie die "Bei Änderung"-Interaktion, um Ihre Bewertungs-Komponente dynamisch und reaktionsfähig zu machen.

   • Barrierefreiheit: Geben Sie eine klare Beschriftung.

   • Variante: Passt die Label-Anzeige an.

Zusammenfassung: Die Bewertungs-Komponente ist eine einfache Möglichkeit, Bewertungen von Benutzern zu sammeln und anzuzeigen, mithilfe einer visuellen und intuitiven, symbolbasierten Oberfläche