Katalog-Steuerelement in Power Apps

Ein Steuerelement, das andere Steuerelemente enthält und einen Datensatz anzeigt.

Beschreibung

Ein Katalogsteuerelement kann mehrere Datensätze aus einer Datenquelle anzeigen, und jeder Datensatz kann mehrere Typen von Daten beinhalten. Ein Katalog-Steuerelement kann beispielsweise mehrere Kontakte darstellen, wobei jedes Element Kontaktdaten wie den Namen, eine Adresse und eine Telefonnummer umfasst.

Jedes Datenfeld wird in einem separaten Steuerelement innerhalb des Katalog Steuerelements angezeigt. Und Sie können diese Steuerelemente in der Vorlage konfigurieren. Die Vorlage wird als erstes Element im Katalog angezeigt:

• Am linken Rand eines Katalog Steuerelements in horizontaler/Querformat-Ausrichtung.
• Und oben auf einem Katalog Steuerelement in vertikaler/Hochformat-Ausrichtung.

Änderungen an der Vorlage beziehen sich auf das Katalog-Steuerelement insgesamt.

Es stehen vordefinierte Vorlagen für die Darstellung von Bildern und Text und ein Katalog für Artikel mit unterschiedlicher Höhe zur Verfügung.

Einschränkungen

Für das Katalog-Steuerelement gelten folgende Einschränkungen:

1. Wenn ein Benutzer einen Bildlauf durchführt mit dem Steuereleent Flexible Höhe, bevor alle Elemente geladen werden, wird das aktuell angezeigte Element möglicherweise nach unten verschoben und nicht mehr angezeigt, wenn das Laden der Daten abgeschlossen ist. Verwenden Sie ein Standardsteuerelement Katalog anstelle der Flexible Höhe Variante, um dieses Problem zu verhindern.
2. Die folgenden Steuerelemente werden innerhalb einer Galerie nicht unterstützt:
   • Formular anzeigen
   • Bearbeitungsformular
   • PDF-Anzeige
   • Power BI Kacheln
   • Rich-Text-Editor
   • Scrollbarer Bildschirm (Fluid Grid)
   • Webbarcodescanner
3. Sie können nur eine Galerie innerhalb einer anderen Galerie hinzufügen.
4. Die minimale TemplateSize ist eins. Dies kann dazu führen, dass die Steuerelemente im Katalog von ihren erwarteten X- oder Y-Werten abweichen, wenn Sie die Vorlagengröße nicht berücksichtigen.
5. Wenn Sie automatisch eine App auf der Grundlage von Daten erstellen, die App speichern und anschließend wieder öffnen, werden im durchsuchbaren Katalog möglicherweise nicht sofort Daten angezeigt. Geben Sie zum Beheben dieses Problems mindestens ein Zeichen im Suchfeld ein, und löschen Sie dann den eingegebenen Text. Im Katalog werden dann die Daten erwartungsgemäß angezeigt.
6. Wenn eine Galerie ein ComboBox-, DatePicker-, Slider- oder Toggle-Steuerelement mit einer OnChange Regel enthält, die dasselbe Datenquelle oder dieselbe Sammlung patcht wie die Galerie, kann dies zu unerwarteter oder verringerter Leistung führen. Dies liegt daran, dass eine OnChange Regel, die die Datenquelle der Galerie patcht, einen nie endenden Zyklus aus Patchen und Neuladen erzeugen kann. Um dieses Problem zu vermeiden, ist es ratsam, keine OnChange Regeln zu verwenden, wenn diese Steuerelemente in einer Galerie platziert werden.

Schlüsseleigenschaften

Default - Das Element oder der Datensatz aus der Datenquelle, das bzw. der beim Starten der App im Katalog ausgewählt werden soll.

Items - Die Quelle der Daten, die in einem Steuerelement angezeigt werden, z.B. ein Katalog, eine Liste oder ein Diagramm.

Selected – Das ausgewählte Element.

Zusätzliche Eigenschaften

AccessibleLabel – Bezeichnung des Katalogs (nicht der darin enthaltenen Elemente) für Bildschirmleser. Sollte die Elementliste beschreiben.

AllItems – Elemente, die in die Katalog geladen werden. Dies kann weniger als die tatsächliche Anzahl der Elemente der Datenquelle sein. Weitere Elemente können geladen werden, wenn die Katalog gescrollt wird. AllItems enthält auch Steuerelemente, die in jedem Katalogelement verwendet werden.

AllItemsCount - Anzahl der Elemente, die in den Katalog geladen werden. Dies kann weniger als die tatsächliche Anzahl der Elemente der Datenquelle sein. Weitere Elemente können geladen werden, wenn die Katalog gescrollt wird.

BorderColor - Die Farbe des Rahmens eines Steuerelements.

BorderStyle - Legt fest, ob der Rahmen eines Steuerelements Durgehend, Gestrichelt, Gepunktet oder Keine ist.

BorderThickness - Die Linienstärke des Rahmens eines Steuerelements.

DelayItemLoading – Verzögern Sie das Laden von Elementen (Zeilen) bis zum ersten Laden des Bildschirms.

DisplayMode - Legt fest, ob das Steuerelement Benutzereingaben zulässt (BEarbeiten), ob nur Daten angezeigt werden (Anzeigen) oder ob das Steuerelement deaktiviert ist (Deaktiviert).

Fill - Die Hintergrundfarbe eines Steuerelements.

Height - Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.

ItemAccessibleLabel – Beschriftung jedes Katalogelements für Bildschirmleser. Sollte beschreiben, was jeder Artikel ist.

LoadingSpinner (Keiner, Kontrollen oder Daten) – Wenn Keine, wird der Wartekreisel nicht angezeigt. Wenn Steuerelemente | Daten, Wartekreisel wird angezeigt, wenn ein Renderdurchlauf auftritt, der zu sichtbaren leeren Zeilen führt.

LoadingSpinnerColor – Die Füllfarbe des Ladespinners. Standardmäßig ist dies auf BorderColor festgelegt.

NavigationStep – Gibt an, wie weit in einem Katalog gescrollt werden kann, wenn die ShowNavigation-Eigenschaft auf true festgelegt ist und der Benutzer am Ende des Katalogs jeweils einen Navigationspfeil verwendet.

Selectable – Ob Galerieelemente ausgewählt werden können. Bei Einstellung auf wahr identifizieren Bildschirmleser den Katalog als auswählbare Liste. Und Sie wählen ein Element aus, indem Sie es auswählen. Bei Einstellung auf falsch identifizieren Bildschirmleser den Katalog als reguläre Liste, und wenn Sie ein Element auswählen, wird es nicht ausgewählt.

ShowNavigation – Gibt an, ob in einem Katalog an beiden Enden ein Pfeil angezeigt wird, damit Benutzer durch die Elemente scrollen können, indem Sie auf einen Pfeil auswählen.

ShowScrollbar – Gibt an, ob eine Bildlaufleiste angezeigt wird, wenn Benutzer auf einen Katalog zeigen.

TemplateFill – Die Hintergrundfarbe eines Katalogs.

TemplatePadding – Der Abstand zwischen den Elementen eines Katalogs.

TemplateSize – Die Höhe der Vorlage für einen Katalog in vertikaler/Hochformat-Ausrichtung. Oder die Breite der Vorlage für einen Katalog in horizontaler/Querformat-Ausrichtung. Die Mindestgröße beträgt eins.

Transition – Der visuelle Effekt (Pop, Push oder None), wenn Benutzer im Katalog auf ein Element zeigen.

Visible - Gibt an, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.

Width - Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.

WrapCount – Die Anzahl der in einer Zeile oder Spalte angezeigten Elemente (je nachdem, ob ein horizontales oder vertikales Layout verwendet wird).

X - Der Abstand zwischen dem linken Rand der Komponente und dem linken Rand des übergeordneten Behältnis oder Bildschirms.

Y- Der Abstand zwischen dem oberen Rand der Komponente und dem oberen Rand des übergeordneten Behältnis oder Bildschirms.

Verwandte Funktionen

Filter ( Datenquelle, Formel )

Zurücksetzen ( Steuerelement ) – Setzt Ihren Katalog auf den Ausgangszustand zurück. Der Anfangszustand umfasst das Scrollen zum ersten Element und das Auswählen des ersten Elements oder der Standardeinstellung, falls vorhanden.

Hinweis

Das Steuerelement Reset setzt nicht alle untergeordneten Elemente des Katalogs rekursiv zurück

Beispiele

Anzeigen und Filtern von Daten

• Anzeigen von Text
• Bilder anzeigen
• Filtern von Daten mithilfe einer Listenoption
• Filtern von Daten mithilfe eines Schiebereglers

Abrufen von Daten eines Benutzers

• Abrufen von Text
• Abrufen von Bildern
• Abrufen von Fotos
• Abrufen von Tönen
• Abrufen von Zeichnungen

Richtlinien für Barrierefreiheit

Farbkontrast

Wenn ein Katalogelement aktiviert wird, indem man auf eine beliebige Stelle klickt, muss zwischen den folgenden Elementen ein angemessener Farbkontrast vorhanden sein:

• Zwischen BorderColor und der Farbe außerhalb des Katalogs, (wenn es einen Rahmen gibt).
• Zwischen Fill und der Farbe außerhalb des Katalogs, (wenn es keinen Rahmen gibt).

Screenreadersupport

• AccessibleLabel muss vorhanden sein.

  Hinweis

  Die Sprachausgabe meldet es, wenn Elemente im Katalog verändert werden. AccessibleLabel wird ebenfalls erwähnt. Dadurch wird die Meldung in einen Kontext gesetzt und hat eine noch wichtigere Funktion, wenn mehrere Kataloge gleichzeitig angezeigt werden.

• Wenn ein Katalogelement mehrere Steuerelemente enthält, verwenden Sie ItemAccessibleLabel, um den Inhalt von Katalogelementen anzuzeigen.

• Stellen Sie den Wert von Selectable zu wahr, wenn Sie möchten, dass Benutzer ein Katalogelement auswählen. Andernfalls setzen Sie diesen Wert auf falsch.

• Wenn ein Katalogelement mehrere Steuerelemente enthält, verwenden Sie ItemAccessibleLabel, um den Inhalt von Katalogelementen zusammenzufassen.

• Selectable sollte entsprechend eingestellt werden, je nachdem, ob Benutzer ein Katalogelement auswählen sollen.

Tastaturunterstützung

• Sie sollten ShowScrollbar auf TRUE festlegen. Auf den meisten Geräten mit Touchscreen wird die Scrollleiste erst dann angezeigt, wenn der Benutzer mit dem Scrollen beginnt.

• Wenn ein Katalogelement aktiviert wird, indem man auf eine beliebige Stelle klickt, muss es auch eine Möglichkeit für Tastaturbenutzer geben, dieses Katalogelement auszuwählen. Sie können z.B. eine Schaltfläche hinzufügen, für die die OnSelect-Eigenschaft auf Select (übergeordnet) festgelegt ist.

  Hinweis

  Steuerelemente, die sich außerhalb des Katalogs befinden, werden nicht in der Reihenfolge der Tastaturnavigation innerhalb des Katalogs abgefragt. TabIndex-Eigenschaft von Steuerelementen innerhalb eines Katalogs ist eingeschränkt. Weitere Informationen finden Sie unter Eigenschaften von Bedienungshilfen.

Siehe auch

DelayItemLoading und Lade-Drehfeld zum Verbessern der Leistung im Katalog verwenden

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).