Binden Sie ein Ereignis an eine Komponente

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer
  • Binden Sie Datenelemente in UI BuilderDamit Sie Ihren Komponenten Ereignisaktionen hinzufügen können.

    Vorbereitungen

    Erforderliche Rolle: ui_Builder_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Jede Komponente weist bestimmte Ereignisse auf, an die sie gebunden wird. Beispielsweise hat eine Schaltflächenkomponente nur ein Ereignis, auf das auf die Schaltfläche geklickt wird, während andere Komponenten mehrere Ereignisse haben können, die ihnen zugeordnet sind.

    Einige Komponenten haben keine Ereignisaktion, die auf sie angewendet wird. Ein Beispiel ist die Überschriftenkomponente. Viele Komponenten erfordern, dass Sie Ihrer Komponente ein Ereignis zuordnen, damit sie eine Aktion ausführen kann, z. B. das Laden von Daten.

    Um Komponenten, Seiten und Datenressourcen auf Ihrer Seite Aktionen hinzuzufügen, können Sie einen Ereignis-Handler hinzufügen. Eine Schaltflächenkomponente, die Sie einer Seite hinzufügen, ist statisch. Indem Sie eine Ereignisaktion an die Schaltfläche binden, können Sie sie mit einer Webseite verknüpfen.

    Prozedur

    1. Navigieren zu Alle > Now-Experience-Framework > UI Builder.
    2. Öffnen Sie eine Experience, in der Sie arbeiten können, oder erstellen Sie eine Experience, indem Sie auswählen Erstellen > Experience.
    3. Erstellen oder öffnen Sie eine Seite.
      Um weitere Informationen zum Erstellen einer Seite in zu erhalten UI Builder, Siehe Erstellen Sie eine Seite in UI Builder .
    4. Fügen Sie eine Komponente hinzu, die Ereignisse enthält, an die sie an Ihre Seite binden kann, z. B. eine Schaltfläche.
      Weitere Informationen zum Hinzufügen von Komponenten zu einer Seite finden Sie unter Komponenten hinzufügen und konfigurieren.
    5. Um Ihrer Komponente einen Ereignis-Handler hinzuzufügen, wählen Sie aus Ereignisse Registerkarte.
      Weitere Informationen zum Hinzufügen von Ereignis-Handlern zu Ihrer Komponente finden Sie unter Verwalten Sie Aktionen auf UI Builder-Seiten.
      1. Klicken Sie auf, um den Prozess zum Einrichten eines Ereignis-Handlers für Ihre Komponente zu starten Ereignis hinzufügen Zuordnung .
        Pfeil, der zum Hinzufügen der Ereigniszuordnungsoption zeigt.
      2. Wählen Sie die Ereigniszuordnung aus, die Sie konfigurieren möchten, aus der Liste aus.
        Liste der verfügbaren Ereigniszuordnungen.
      3. Wählen Sie Fortsetzen.
      4. Wählen Sie im Abschnitt „Vorschau des Ereignis-Handlers“ einen Ereignis-Handler aus, der an Ihre Komponente gebunden werden soll.
        Warnungsbenachrichtigungen löschen, wenn in einer Liste auf eine Zeile geklickt wird.
      5. Wählen Sie Fortsetzen.
      6. Konfigurieren Sie die Nutzlast für das Ereignis.
        Sie konfigurieren jeden Ereignis-Handler je nach Aktion des Ereignisses unterschiedlich. Wenn Sie beispielsweise einen Ereignis-Handler für eine Schaltflächenkomponente hinzufügen, können Sie auswählen, was diese Schaltflächenaktion ausführt.
      7. Wählen Sie Hinzufügen.
    6. Wahlweise: Wenn ein modales Element für Ihr Ereignis angezeigt werden soll, fügen Sie das modale Element der Seite hinzu, bevor Sie Ihr Ereignis an die Komponente binden.
      Ein modales Element ist ein Bestätigungs-Popup, das angezeigt wird, wenn Sie auf die Komponente klicken. Wenn Sie beispielsweise eine Schaltflächenkomponente hinzufügen, die einen Datensatz löscht, fügen Sie ein Modal hinzu, um den Anwender zu bitten, zu bestätigen, dass der Anwender den Datensatz löschen möchte. Weitere Informationen finden Sie unter Fügen Sie der Komponente Modal hinzu.
      1. Wählen Sie aus + Symbol in der Inhaltsstruktur neben Modale Elemente .
        Pfeil, der auf die Option „Neues Modal hinzufügen“ zeigt.
      2. Wählen Sie einen modalen Typ wie Bestätigen .
        Modale Optionen mit hervorgehobenem Bestätigungsmodal.
      3. Konfigurieren Sie das Modal.
        Sie können den Text im Modal, die Namen der Schaltflächen im Modal und die Größe des modalen Bildschirms ändern. Sie können auch Aktionen für das Modal festlegen. Wenn Sie die Konfiguration des Modals abgeschlossen haben, schließen Sie es. Beachten Sie, dass sich das von Ihnen erstellte modale Element über dem Textkörper Ihrer Seitenstruktur in der Inhaltsstruktur befindet.
    7. Binden Sie ein Ereignis an eine Schaltflächenkomponente.
      Sie binden ein Ereignis an die Schaltfläche, um eine Aktion auszulösen. Wählen Sie die Schaltflächenkomponente aus, um sie erneut hervorzuheben, entweder in der Inhaltsstruktur oder auf der Seite.
      1. Wählen Sie Aus + Inhalt hinzufügen In der Inhaltsstruktur.
      2. Wählen Sie aus Schaltfläche Komponente in der Toolbox.
      3. Wählen Sie Aus Keine Wenn Sie zur Auswahl einer Voreinstellung aufgefordert werden.
      4. Klicken Sie im Konfigurationsbereich auf Ereignisse .
      5. Wählen Sie Aus Handler hinzufügen .
        Pfeil, der auf den Link „Ereignis-Handler hinzufügen“ für die Schaltflächenkomponente verweist.

        Der Schaltflächenkomponente ist nur das Ereignis mit angeklickter Schaltfläche zugeordnet. Andere Komponenten können mehr als ein Ereignis haben.

      6. Wählen Sie einen Handler aus, den Sie der Schaltfläche zuweisen möchten.

        Um beispielsweise einen Ereignis-Handler für die Schaltflächenkomponente hinzuzufügen, können Sie ihn mit einem anderen Ziel verknüpfen und Warnungsbenachrichtigungen hinzufügen. In diesem Beispiel können Sie auswählen Öffnen oder schließen Sie den modalen Dialog Damit die Schaltfläche geöffnet wird, öffnen Sie das zuvor erstellte modale Element. Wählen Sie in diesem Schaltflächenszenario den Ereignis-Handler für Dialogfeld „Bestätigen und löschen“ aus, den Sie zuvor erstellt haben.

        Konfigurationsbildschirm des Ereignis-Handlers, der die Einstellungen des Dialogfelds „Öffnen“ oder „Schließen“ anzeigt.
      7. Wählen Sie Fortsetzen.
      8. Wählen Sie ein modales Element aus der Dropdown-Liste aus.
      9. Wählen Sie Aus Hinzufügen Zum Hinzufügen des modalen Ereignis-Handlers zu Ihrer Schaltflächenkomponente.
    8. Klicken Sie auf Speichern.
    9. Testen Sie das Modal, indem Sie auswählen Vorschau .
    10. Klicken Sie auf die Schaltfläche auf der Seite, um das von Ihnen erstellte modale Element auszulösen.