Widget "Liste"

Das Widget "Liste" zeigt Datensätze in einer benutzerdefinierten Listenansicht an. Es verwendet ein Kachel-Design als Container für einige kurze Beschreibungen der zugehörigen Informationen mit der Option zum Einfügen einer Schaltfläche für die Anzeige zusätzlicher Details. Sie haben die Wahl zwischen mehreren Vorlagen, um das Kachel-Layout zu erstellen. Die Vorlagen enthalten Bild-, Schaltflächen- und Text-Widgets. Sie können auch eine leere Vorlage wählen, um eine eigene Vorlage zu erstellen. Die Datenquelle für die Liste wird durch einen Feature-Layer definiert. Jede Elementkachel in der Liste steht für einen Datensatz. Die Widgets auf einer Kachel können für die Anzeige der Attribute eines Datensatzes verwendet werden. Um das Design der Liste festzulegen, können Sie die Style-Einstellungen anpassen und das Layout der ersten Kachel ändern, gemäß dem dann alle Kacheln in der Liste aktualisiert werden.

Beispiele

Verwenden Sie dieses Widget, um zum Beispiel die folgenden Anforderungen an das App-Design zu unterstützen:

• Sie möchten eine App erstellen, die es Benutzern ermöglicht, einen Datensatz in der Liste auszuwählen und auf der Karte anzuzeigen.
• Sie möchten Datensätze aus einer Datenquelle in einer benutzerdefinierten Listenansicht anzeigen. Die anzuzeigenden Datensätze müssen bestimmte Kriterien erfüllen.
• Sie möchten Benutzern eine Liste für bestimmte Interaktionen bereitstellen, zum Beispiel für das Filtern der Liste, das Sortieren der Liste mit vordefinierten Optionen und das Auswählen von Datensätzen in der Liste.

Verwendungshinweise

Wenn Sie ein Listen-Widget hinzufügen, wählen Sie zuerst ein Vorlagendesign für die Elementkacheln in der Liste und klicken auf Start. Auf der Zeichenfläche wird das erste Element im Widget "Liste" aktiviert. Danach können Sie das Layout der Widgets in ihm ändern oder weitere Elemente hinzufügen, indem Sie Widgets aus dem Fenster Einfügen in die erste Kachel ziehen. Derzeit unterstützt das Widget "Liste" nur Text-, Schaltflächen- und Bild-Widgets.

Das Widget "Liste" benötigt eine Datenquelle. Das Widget "Liste" können Sie auf einer Seite mit einer Karte oder ohne eine Karte verwenden. Wenn Sie ein Widget vom Typ "Karte" einfügen, das denselben Layer verwendet, und dann auf ein Feature in der Liste klicken, wird das entsprechende Feature in der Karte hervorgehoben. Beim Gestalten der Inhalte von Elementkacheln in der Liste geben Sie an, was angezeigt werden soll, indem Sie die Widgets im ersten Element konfigurieren und den entsprechenden dynamischen Inhalt zum Füllen der Datensätze aus der verbundenen Datenquelle auswählen. (Widgets, die Sie der Liste hinzufügen, übernehmen standardmäßig die Daten der Liste.) Damit ein Listen-Widget mit anderen Widgets in Ihrer App interagieren kann, können Sie auch bestimmte Aktionen festlegen, wie zum Beispiel für das Zoomen auf das ausgewählte Feature auf einer Karte in einem Karten-Widget oder das Anzeigen der Attribute des ausgewählten Features in einem Feature-Info-Widget.

Wenn Sie das Widget "Liste" mit mehreren Zuständen (Standard, Daraufzeigen, und Ausgewählt) konfigurieren, wird die Schaltfläche Verknüpft mit angezeigt, wenn Sie die geschachtelten Widgets für benutzerdefinierte Layouts auswählen. Diese Schaltfläche gibt an, ob die Einstellungen des Widgets isoliert oder hinsichtlich der Zustände synchronisiert sind.

• Bei synchronisierten Widgets sind Widget-Inhalt und Style-Einstellungen (Hintergrund, Rahmen und Schatten) identisch, und die Größe und Positionen können in den einzelnen Zuständen unterschiedlich sein.
• Bei isolierten Widgets können Sie Eigenschaften ohne Auswirkung auf andere Widgets in einem anderen Zustand konfigurieren.
• Um dasselbe Widget in einem anderen Zustand zu verwenden oder die Größe und Position des Widgets ebenfalls zu synchronisieren, wählen Sie das Widget aus und übernehmen es in den gewünschten Zustand.
• Wenn Sie ein synchronisiertes Widget löschen, wird dasselbe Widget in anderen Zuständen ebenfalls gelöscht, sofern Sie das Widget zuvor nicht isoliert haben.

Suchmethoden

Das Suchwerkzeug im Listen-Widget verwendet verschiedene Methoden zum Abrufen von Suchvorschlägen und Suchergebnissen.

Das Suchwerkzeug des Widgets nutzt die Volltextsuche, um Suchvorschläge abzurufen. Die Volltextsuche ist eine effiziente Suchmethode, bei der Volltext-Feldindizes verwendet werden, die Datensätze in kleine Einheiten, z. B. einzelne Wörter, unterteilen. Stellen Sie sich zum Beispiel vor, Sie haben einen Layer mit Postämtern in den Vereinigten Staaten, der ein Namensfeld mit den Namen aller Postämter enthält. Der Index unterteilt den Namen "Highland Station Baltimore Post Office" in fünf einzeln suchbare Wörter: Highland, Station, Baltimore, Post und Office. Wenn Sie einen Suchausdruck eingeben, der aus einer beliebigen Kombination dieser Wörter besteht (oder nur aus dem ersten Teil dieser Wörter), z. B. Baltimore Office, Highland Baltimore oder Stat Balt Office, erhalten Sie dieses Postamt in den Suchvorschlägen.

Volltextfeldindizes werden automatisch für gehostete Feature-Layer generiert, wenn Sie diese als Suchfelder für das Such-, Listen- oder Tabellen-Widget auswählen, sofern Sie der Besitzer des gehosteten Feature-Layers oder ein Organisationsadministrator sind.Sie können auch manuell Indizes zu Attributfeldern auf der Seite mit Layer-Elementdetails hinzufügen. Wenn Sie über Layer ohne Indizes verfügen und nicht berechtigt sind, die Layer zu bearbeiten, sucht das Listen-Widget nach Vorschlägen mithilfe von START WITH abc%, d. h. das Widget sucht nach Datensätzen, die mit dem Suchausdruck beginnen. Dies ist eine weniger effiziente Suchmethode.

Zum Abrufen von Suchergebnissen verwendet das Widget CONTAIN %abc%, d. h. der Suchausdruck kann an beliebiger Stelle im Datensatz stehen. Sie können z. B. nach alt suchen, um "Baltimore", "Salt Lake City" und "Alton" als Suchergebnisse zu erhalten.

Vorsicht:

Die Volltextsuche ist neu in der Experience Builder-Version von Oktober 2023 und ist eine grundlegende Änderung. Vor dieser Version wurde im Widget CONTAIN %abc% verwendet, um sowohl Vorschläge als auch Ergebnisse abzurufen. Bei der Volltextsuche werden jedoch keine Suchausdrücke mitten in Wörtern gefunden, anders als bei CONTAIN %abc%-Abfragen. Im obigen Beispiel wird bei der Suche nach altimor oder ighlan nicht das erwartete Postamt in den Suchvorschlägen angezeigt. Erfahren Sie mehr über das Suchen nach Features in Karten und Apps.

Einstellungen

Das Widget "Liste" verfügt über folgende Einstellungen:

• Vorlage auswählen: Wählen Sie unter den vordefinierten Listendesigns aus, oder beginnen Sie mit einer leeren Listenvorlage. (Wenn Sie eine Vorlage auswählen, können Sie ihr Aussehen später anpassen.)
• Daten: Geben Sie die Daten an, die in der Liste enthalten sein sollen.
  • Daten auswählen: Wählen Sie die Datenquelle für einen Feature-Layer mit Features aus, die im Widget angezeigt werden sollen. Sie können nur eine Datenansicht für einen Feature-Layer auswählen. In den Einstellungen der Datenansicht können Sie die Daten filtern, um einzuschränken, was im Widget angezeigt wird, die Daten so sortieren, dass die Listenelemente in einer bestimmten Reihenfolge angezeigt werden, oder Datensatzeinschränkungen festlegen.
  • Keine Datennachricht: Entscheiden Sie, welche Meldung angezeigt werden soll, wenn das Widget keine Daten enthält, beispielsweise wenn Benutzer einen Filter anwenden.
  • Letzte Aktualisierung – Text: Wenn für die Datenquelle Automatisch aktualisieren aktiviert ist, können Sie die Beschriftung der letzten Aktualisierung ausschließen, aus der hervorgeht, wann die Daten in der App aktualisiert wurden.
• Anordnung: Definieren Sie, wie die Elemente in der Liste angezeigt werden sollen.
  • Layout: Zeigen Sie Elemente in einer Zeilen-, Spalten- oder Rasterliste an.
  • Elementbreite oder Elementhöhe: Geben Sie die Größe der Listenelemente an.
    • Für eine Zeilenliste definieren Sie die Breite des Listenelements, indem Sie eine präzise Pixelzahl in dieser Einstellung angeben oder die Größenanpassungsleiste auf die Zeichenfläche ziehen. Die Höhe des Elements wird durch die Höhe des Widgets definiert.
    • Für eine Spaltenliste definieren Sie die Höhe des Listenelements, indem Sie eine präzise Pixelzahl in dieser Einstellung angeben oder die Größenanpassungsleiste auf die Zeichenfläche ziehen. Die Breite des Elements wird durch die Breite des Widgets definiert.
    • Für eine Rasterliste definieren Sie die Breite und Höhe des Listenelements, indem Sie für jede Einstellung die genaue Pixelanzahl eingeben oder die Größenänderungsleisten auf der Zeichenfläche ziehen. Sie können die Breite des Listenelements auch als Prozentsatz der Widget-Breite definieren.

    Hinweis:

    Wenn für die Liste ein benutzerdefiniertes Layout für Geräte mit mittelgroßem oder kleinem Bildschirm verwendet wird, können Sie die Größe der Listenelemente anpassen. Symbole in dieser Einstellung geben an, für welche Bildschirmgröße (groß, mittelgroß oder klein) die Konfiguration gilt.

  • Verhältnis von Höhe zu Breite sperren: Sperrt das Verhältnis von Höhe zu Breite von Listenelementen, wenn die Größe des Widgets angepasst wird.
  • Ausrichtung (verfügbar für Rasterlisten): Richten Sie Listenelemente rechts, zentriert oder links aus.
  • Horizontaler Abstand oder Vertikaler Abstand: Definieren Sie den Abstand zwischen Listenelementen in Pixel. Definieren Sie bei einer Rasterliste beides.
  • Seiten-Style: Definieren Sie, wie Listenelemente, die nicht auf die erste Seite passen, geladen werden sollen:
    • Bildlauf: Weitere Elemente laden, wenn der Benutzer einen Bildlauf in der Liste durchführt.
      • Bildlaufleiste: Bildlaufleiste anzeigen.
      • Navigator: Binden Sie Steuerelemente für die Navigation nach oben und nach unten bzw. nach links und nach rechts zum Durchführen eines Bildlaufes in der Liste ein. Definieren Sie für Schritt die Anzahl der Elemente oder Zeilen, um die bei jedem Klick im Steuerelement "Navigator" weitergeblättert werden soll.
    • Mehrseitig: Teilt mithilfe der Paginierung eine lange Liste in mehrere Seiten. Definieren Sie für Elemente pro Seite die Anzahl der Elemente, die auf einer Seite angezeigt werden sollen.
• Zustände: Geben Sie eine visuelle Darstellung für die Angabe der drei Zustände von Listenelementen an: Standard (Standardzustand für das Element ohne Benutzerinteraktion), Daraufzeigen (Zustand, der durch Benutzer initiiert wird, wenn sie auf ein Listenelement zeigen) und Ausgewählt (Benutzer haben dieses Listenelement ausgewählt).

  Tipp:

  Um die entsprechenden Zustände für geschachtelte Widgets zu ändern, können Sie die Änderungen isolieren, damit sie nicht auf alle Zustände angewendet werden. Wählen Sie das Widget "Liste" aus, und klicken Sie auf die Schaltfläche für den Zustand, den Sie ändern möchten. Wählen Sie für die Einstellung Layout die Option Benutzerdefiniert aus. Klicken Sie auf ein geschachteltes Widget, klicken Sie dann auf die Schaltfläche Verknüpft mit , wählen Sie Isolieren aus, und konfigurieren Sie die Einstellungen des geschachtelten Widgets. (Wenn Sie erst nach dem Konfigurieren der Einstellungen auf Isolieren klicken, wurden die Änderungen bereits auf die anderen Zustände angewendet.)

  • Hintergrund: Legen Sie den Hintergrund für Listenelemente im Standardzustand fest (keine aktuelle Benutzerinteraktion). Wählen Sie eine Füllfarbe oder ein Bild aus. Wenn Sie ein Bild auswählen, dann können Sie es mit  Anpassen, Ausfüllen, Zentrieren, Kachel oder Strecken innerhalb der Umrandung des Listenelements positionieren. Wenn Sie Anpassen auswählen, wird die Hintergrundfüllfarbe um das Bild herum angezeigt.
  • Rahmen: Legen Sie den Rahmen für Listenelemente im Standardzustand fest, indem Sie die Rahmenfarbe, die Rahmenart (zum Beispiel gestrichelt oder gepunktet) und die Rahmenbreite in Pixel auswählen.
  • Rahmenradius: Ändern Sie den Radius (in Pixel oder Prozent), um die Form der Ecken von Listenelementen im Standardzustand festzulegen. Sperren Sie die Einstellungen, um den Radius aller vier Ecken zu synchronisieren.
  • Daraufzeigen: Geben Sie an, ob sich das Aussehen eines Listenelements ändert, wenn der Benutzer darauf zeigt. Wenn der Zustand beim Daraufzeigen aktiviert wurde, werden im Konfigurationsfenster seine Einstellungen mit Optionen zum Ändern von Hintergrund, Rahmen und Rahmenradius des Listenelements, auf das gezeigt wird, angezeigt.
    • Neben dem ersten Listenelement auf der Zeichenfläche wird die Registerkarte Daraufzeigen angezeigt. Es wird aktualisiert, um zu zeigen, wie das Element aussieht, wenn der Benutzer darauf zeigt. Für den Zustand beim Daraufzeigen können Sie auch Widgets hinzufügen oder vorhandene Widgets löschen, in ihrer Größe ändern und neu anordnen.
  • Ausgewählt: Geben Sie an, ob die Elementkachel in der Liste ausgewählt werden kann und wie sich ihr Aussehen ändert, wenn der Benutzer es anklickt, um es auszuwählen. Wenn der ausgewählte Zustand aktiviert wurde, werden im Konfigurationsfenster seine Einstellungen mit Optionen zum Zulassen der Mehrfachauswahl und zum Ändern von Hintergrund, Rahmen und Rahmenradius des ausgewählten Listenelements angezeigt. Mit dem Auswahlmodus können Sie die Auswahl auf nur ein Element begrenzen (beim Klicken auf ein weiteres Element wird die aktuelle Auswahl wieder aufgehoben) oder zulassen, dass der Benutzer mehrere Elemente gleichzeitig auswählen kann (beim Klicken auf ein weiteres Element wird es zur aktuellen Auswahl hinzugefügt).
    • Neben dem ersten Listenelement auf der Zeichenfläche wird die Registerkarte Ausgewählt angezeigt. Es wird aktualisiert, um zu zeigen, wie das Element aussieht, wenn der Benutzer es auswählt. Für den Zustand "Ausgewählt" können Sie auch Widgets hinzufügen oder vorhandene Widgets löschen, in ihrer Größe ändern und neu anordnen.
• Werkzeuge: Sie können die folgenden Werkzeuge zur Laufzeit in das Widget- Fenster aufnehmen:
  • Suchen: Ermöglicht es Benutzern, nach Datensätzen in der Liste zu suchen.
    • Suchfelder auswählen: Wählen Sie mindestens ein Feld aus, das durchsucht werden soll.
    • Exakte Übereinstimmung: Beschränkt die Suchergebnisse auf die Datensätze, die genau mit dem Suchausdruck übereinstimmen.
    • Hinweis: Geben Sie einen Hinweis an, der als Platzhaltertext im Suchfeld angezeigt wird, um Benutzern die Suche nach relevanten Werten zu erleichtern.
  • Sortieren: Stellen Sie ein Menü bereit, mit dessen Hilfe der Benutzer die Liste nach bestimmten Feldern und in einer bestimmten Reihenfolge sortieren kann. Geben Sie einen benutzerdefinierten Namen für jede Menüoption ein.
  • Filter: Fügen Sie Filter für die Interaktion der Benutzer mit der Liste hinzu. Wenn Sie Filter festlegen, enthält das Widget eine Schaltfläche zum Zurücksetzen, mit der die Filter auf ihre ursprünglichen Zustände zurückgesetzt werden.
  • Aktualisieren: Ermöglicht es Benutzern, die Liste zu aktualisieren, um die neuesten Daten anzuzeigen. Diese Einstellung ist nützlich, wenn Sie die Liste mit einer Datenquelle verbinden, die regelmäßig aktualisiert wird.
  • Auswahl anzeigen: Ermöglicht es Benutzern, die Liste zu aktualisieren, damit nur die ausgewählten Elemente angezeigt werden.
  • Auswahl aufheben: Ermöglicht es Benutzern, die Auswahl aller ausgewählten Elemente aufzuheben.
  • Anzahl der Datensätze anzeigen: Sie können auch die Anzahl der gesamten und der ausgewählten Datensätze angeben.

  Hinweis:

  Die Werkzeuge Auswahl anzeigen und Auswahl aufheben sind nur verfügbar, wenn der Zustand Ausgewählt aktiviert ist.

Optionen für Interaktionen

Dieses Widget unterstützt Aktionen, die Sie auf der Registerkarte Aktion in den Widget-Einstellungen konfigurieren können.

Sie können Meldungsaktionen konfigurieren, um automatische Interaktionen zwischen Widgets zu erstellen. Um beispielsweise ein Karten-Widget automatisch auf ein Feature zoomen zu lassen, wenn der Benutzer es mit dem Listen-Widget auswählt, können Sie den Trigger Änderungen der Datensatzauswahl hinzufügen, ein Karten-Widget als Ziel auswählen und die Aktion Zoomen auf hinzufügen.

Aktivieren Sie Datenaktionen, um der Bedienoberfläche des Listen-Widgets Schaltflächen zur Durchführung von Datenverarbeitungs-Tasks hinzuzufügen, z. B. zum Exportieren, Zoomen und Setzen von Filtern. Benutzer können Datenaktionen für alle Daten in der Liste oder für ausgewählte Features durchführen.

Hinweis:

Wenn Benutzer Daten mit der Datenaktion Exportieren exportieren, werden nur Felder in den Export einbezogen, die aktiv vom Widget "Liste" verwendet werden. Dazu gehören auch Felder, die für dynamischen Text, dynamische Bilder usw. verwendet werden.