Statusparameter für Clients
Verwenden Sie Client-Statusparameter, um Werte an Komponentenkonfigurationen zu binden. Wenn sich der Wert des Client-Statusparameters ändert, wird die Komponente aktualisiert, um den neuen Wert zu verwenden.
Was ist eine clientseitige Interaktion
- Klicken auf eine Schaltfläche
- Filter wird angewendet
- Sortieren einer Liste
- Liste wird aktualisiert
- Inline-Suchergebnisse werden bereitgestellt
- Warnt einen Anwender vor unvollständigen oder falschen Daten
Anwender interagieren manchmal mit Seiten, um zu anderen Seiten zu navigieren. In anderen Fällen möchten Anwender den Inhalt, die Darstellung oder die Daten einer Seite aktualisieren. Anstatt die gesamte Seite zu aktualisieren, aktualisieren clientseitige Interaktionen nur die betroffenen Teile einer Seite.
Ein Anwender kann beispielsweise eine Liste sortieren, indem er auf einen Spaltenheader klickt. Beim Sortieren wird nur die Liste und nicht die gesamte Seite neu erstellt.
- Statusparameter für Clients
- Events
- Client-Skripts
Was sind Client-Statusparameter
Clientstatusparameter sind Seitenvariablen. Definieren und konfigurieren Sie einen Client-Statusparameter, und verwenden Sie den Wert, um Komponenten zu konfigurieren. Client-Statusparameter zentralisieren die Verwaltung von Konfigurationswerten für Seitenkomponenten. UI BuilderVerwendet Client-Statusparameter, um die Anwender-Experience zu verbessern und personalisierte Inhalte und Services bereitzustellen.
Beispiel für Client-Statusparameter
Im Beispiel hat eine Seite einen Client-Statusparameter namens Farbe. Zwei der drei Komponenten sind so konfiguriert, dass der Statusparameter des Farb-Clients verwendet wird. Wenn die Farbe auf Orange festgelegt ist, sind die Komponenten orange. Wenn die Farbe auf Lila festgelegt ist, sind die Komponenten lila. Wenn die Farbe auf Grün festgelegt ist, sind die Komponenten grün. Der Client-Statusparameter ist ein zentraler Ort zum Verwalten eines allgemeinen Werts für die Seite. Ohne den Client-Statusparameter muss jede Komponente, die einen Wert verwendet, einzeln aktualisiert werden, wenn sich dieser Wert geändert hat.
Beispielsweise speichert eine Web-Experience die von Komponenten verwendete primäre Farbe im Statusparameter des Farb-Clients. Wenn die Komponenten für die Verwendung des Client-Statusparameters konfiguriert sind, werden durch Ändern des Werts des Client-Statusparameters die Komponenten auf den neuen Wert aktualisiert.
Schaltflächen können der Experience hinzugefügt werden, damit Anwender eine Farbe für die Seitenkomponenten auswählen können. Mit einem einzigen Klick kann ein Anwender gleichzeitig die Farbe aller Komponenten auf einer Seite ändern. Speichern Sie die Farbauswahl des Anwenders in einem Client-Statusparameter, und verwenden Sie dann den Client-Statusparameter, um die Komponenten der Seite zu konfigurieren. Wenn eine Anwenderinteraktion dazu führt, dass sich der Wert des Client-Statusparameters ändert, werden die Komponenten der Seite in Echtzeit aktualisiert.
Der Client-Statusbereich
Der Client-Statusbereich ist standardmäßig reduziert. Klicken Sie auf das Clientstatussymbol in der linken Navigationsleiste, um den Clientstatusbereich zu öffnen.
- Client-Statusparameter: Die Client-Statusparameter für die Seite
- Vorschau des Clientstatus: Die JSON für die Clientstatusparameter der Seite
Erstellen von Client-Statusparametern
Klicken Sie auf , um einer Seite einen Client-Statusparameter hinzuzufügen + Hinzufügen Schaltfläche im Abschnitt „Client-Statusparameter“.
- Name: Der Name des Parameters. Namen dürfen keine Leerzeichen enthalten
- Typ: Der Typ des Parameters
- Zeichenfolge
- Nummer
- Boolean
- JSON
- Anfangswert: Der Standardwert für den Parameter
- GelegentypeQuery Ist eine Zeichenfolge ohne Standardwert
- GelegentListTitle Ist eine Zeichenfolge mit einem Standardwert von Alle Besonderen Anlässe
Arbeiten mit Client-Statusparametern
Was können Sie damit tun, sobald Sie einen Client-Statusparameter haben? Um mit Client-Statusparametern zu arbeiten, binden Sie zuerst den Wert des Client-Statusparameters an Komponentenkonfigurationen. Wenn sich der Wert des Client-Statusparameters ändert, wird die Komponente aktualisiert, um den neuen Wert zu verwenden. Eine Möglichkeit, den Wert eines Clientstatusparameters zu ändern, sind Ereignis-Handler.
Auf der Seite „Clientstatusparameter erstellen“ wurden der Anwendung „besondere Anlässe“ zwei Clientstatusparameter hinzugefügt: GelegentypeQuery Und GelegentListTitle . Die GelegentypeQuery Parameter hat standardmäßig keinen Wert und GelegentListTitle Hat den Standardwert Alle Besonderen Anlässe . Diese Clientstatusparameter werden auf die Komponente „Anlässliste“ angewendet, um den Titel und den Filter der Liste festzulegen. Eine Schaltfläche wird verwendet, um die Werte dieser Client-Statusparameter zu aktualisieren, um die Liste dynamisch zu aktualisieren.
Statusparameter des Clients werden gebunden
Die Parameterwerte des Clientstatus können auf die gleiche Weise an Komponentenkonfigurationsfelder gebunden werden, wie Seitenkontext, Nutzlast und Datenressourcen. Bewegen Sie beim Konfigurieren von Komponenten den Mauszeiger über ein Feld, und wählen Sie dann aus Dynamische Datenbindung Schaltfläche ( 
) Zum Binden eines Clientstatusparameters an den Feldwert. Im Beispiel ist Dynamische Datenbindung Die Schaltfläche wird für das Filterfeld der Komponente „Anlässliste“ hervorgehoben.
Das Zeichen @ gibt die Datenbindung an, und das Statusobjekt enthält die Client-Statusparameter. Wählen Sie einen Client-Statusparameter aus der Auswahlliste aus. Das Beispiel zeigt die Auswahl von GelegentypeQuery Client-Statusparameter. Der Standardwert für GelegentypeQuery Der Client-Statusparameter ist leer, daher wird standardmäßig kein Filter angewendet.
Der Titel für die Komponente wird auf ähnliche Weise festgelegt: Wählen Sie aus Dynamische Datenbindung Schaltfläche für das Feld „Titel“, oder geben Sie @ ein, und wählen Sie dann aus status.GelegenheitListTitel Client-Statusparameter aus der Auswahlliste. Der Standardwert für GelegentListTitle Client-Statusparameter ist Alle Speziellen Belegungen . Das Beispiel zeigt sowohl Titel als auch Filter, die für die Verwendung von Client-Statusparametern konfiguriert sind.
Wenn beide Clientstatusparameter angewendet werden, wird kein Filter auf die Liste angewendet, und der Titel lautet Alle Besonderen Anlässe .
Die GelegentypeQuery Und GelegentListTitle Die Werte des Client-Statusparameters bleiben unverändert, bis ein Anwender mit einer Komponente interagiert, die den Wert des Client-Statusparameters ändert.
Ändern Sie die Parameterwerte des Client-Status
Anwender von Aktualisieren Sie den Client-Statusparameter Ereignis-Handler zum Ändern des Werts eines Client-Statusparameters in der Laufzeit. Die Aktualisieren Sie den Client-Statusparameter Ereignis-Handler hat zwei Eigenschaften: Der zu aktualisierende Client-Statusparameter und der neue Wert, der für den Client-Statusparameter verwendet werden soll.
Beispiel Geburtstage Schaltfläche wird über hinzugefügt Anlässe-Liste Komponente in Besondere Anlässe Anwendung. Das Ziel dieser Schaltfläche besteht darin, den zu ändern Titel Der Liste bis Alle Geburtstage Und zum Anpassen des Filters der Liste so, dass nur Geburtstage angezeigt werden. Um dieses Ziel zu erreichen, werden zwei Ereignis-Handler zugeordnet Schaltfläche angeklickt Ereignis für die Schaltfläche, eins zum Ändern von GelegentypeQuery Client-Statusparameter und ein anderer zum Ändern von GelegentListTitle Client-Statusparameter. Das Bild zeigt Aktualisieren Sie den Client-Statusparameter Ereignis-Handler zum Festlegen von konfiguriert GelegentypeQuery Client-Statusparameter bis Special_event=birthday , Wodurch die Liste so gefiltert wird, dass nur Geburtstage angezeigt werden.
Wenn Schaltfläche angeklickt Das Ereignis ist Ereignis-Handlern zugeordnet, um beide zu aktualisieren GelegentypeQuery Und GelegentListTitle Client-Statusparameter durch Klicken auf die Schaltfläche werden die Client-Statusparameter aktualisiert, wodurch automatisch aktualisiert wird Anlässe-Liste Komponente mit den neuen Werten.