Udostępnij za pośrednictwem

Kontrolka Galeria w Power Apps

  • Artykuł

Kontrolka, który zawiera inne kontrolki i wyświetla zestaw danych.

Opis

Kontrolka Galeria może pokazywać wiele rekordów ze źródła danych, a każdy rekord może zawierać wiele typów danych. Na przykład użyj kontrolki Galeria, aby wyświetlać wiele kontaktów, przy czym każdy element wyświetla informacje kontaktowe obejmujące nazwę, adres i numer telefonu dla każdego kontaktu.

Każde pole danych jest wyświetlane w innym formancie w kontrolce Galeria. Kontrolki te można skonfigurować w ich szablonach. Szablon zostanie wyświetlony jako pierwszy element w galerii:

  • Przy lewej krawędzi kontrolki Galeria w orientacji poziomej/poziomej.
  • I u szczytu kontrolki Galeria w orientacji pionowej/pionowej.

Wszelkie zmiany wprowadzone w szablonie są odzwierciedlane w całej kontrolce Galeria.

Dostępne są predefiniowane szablony do wyświetlania obrazów i tekstu w galerii oraz galeria dla elementów o zmiennej wysokości.

Ograniczenia

Kontrolka galerii ma następujące ograniczenia:

  1. Jeśli użytkownik będzie przewijał kontrolkę galerii o wysokości elastycznej przed załadowaniem wszystkich elementów, element będący jego widokiem może zostać przeniesiony i wyświetlony poza widokiem po zakończeniu ładowania danych. Aby uniknąć tego problemu, należy użyć standardowego kontrolki Galeria zamiast jego wariantu o wysokości elastycznej.
  2. W galerii nie są obsługiwane następujące elementy sterujące:
  3. Możesz dodać tylko jedną galerię wewnątrz innej galerii.
  4. Minimalna wartość TemplateSize to jeden. Może to spowodować, że kontrolki w Galerii będą odbiegać od oczekiwanych wartości X lub Y, jeśli rozmiar szablonu nie zostanie uwzględniony.
  5. Jeśli generujesz aplikację automatycznie z poziomu danych, zapisujesz ją i ponownie ją otwierasz, w galerii przeglądania dane mogą nie być wyświetlane od razu. Aby rozwiązać ten problem, wpisz co najmniej jeden znak w polu wyszukiwania, a następnie usuń wpisany tekst. Dane zostaną wyświetlone w galerii zgodnie z oczekiwaniami.
  6. Jeśli galeria zawiera kontrolkę ComboBox, DatePicker, Slider lub Toggle z regułą OnChange , która poprawia to samo źródło danych lub kolekcję co galeria, może to prowadzić do nieoczekiwanej lub zmniejszonej wydajności. Wynika to z faktu, że reguła OnChange , która stosuje poprawki do źródła danych galerii, może utworzyć niekończący się cykl stosowania poprawek i ponownego ładowania. Aby uniknąć tego problemu, zaleca się, aby nie używać OnChange reguł, gdy te kontrolki są umieszczone w galerii.

Właściwości klucza

Default – element lub rekord ze źródła danych, który należy wybrać w galerii podczas uruchamiania aplikacji.

Items — źródło danych pokazywanych w kontrolce, takiej jak galeria, lista czy wykres.

Selected — wybrany element.

Dodatkowe właściwości

AccessibleLabel — etykieta galerii (nie znajduje się w elementach) dla czytników ekranu. Powinna opisywać zawartość listy elementów.

AllItems — elementy, które są ładowane w galerii. Może to być mniejsza niż rzeczywista liczba Elementów źródła danych. Podczas przewijania galerii może być ładowanych więcej elementów. Element AllItems zawiera także formanty używane w poszczególnych elementach galerii.

AllItemsCount – liczba elementów załadowanych do galerii. Może to być mniejsza niż rzeczywista liczba Elementów źródła danych. Podczas przewijania galerii może być ładowanych więcej elementów.

BorderColor – kolor obramowania kontrolki.

BorderStyle – rodzaj obramowania kontrolki: Ciągłe, Kreskowane, Kropkowane lub Brak.

BorderThickness – grubość obramowania kontrolki.

DelayItemLoading - Załaduj elementy (wiersze) do chwili pierwszego załadowania ekranu.

DisplayMode — czy kontrolka zezwala na wprowadzanie danych wejściowych przez użytkownika (Edytuj), czy tylko wyświetla dane (Wyświetl) lub jest wyłączona (Wyłączone).

Fill — kolor tła kontrolki.

Height – odległość między górną i dolną krawędzią kontrolki.

ItemAccessibleLabel - etykieta każdego elementu galerii dla czytników ekranu. Powinien opisywać, co to jest każdy element.

LoadingSpinner (Brak, Kontrolka lub Dane) — Brak możliwości — pokrętło nie będzie widoczne. Przy Kontrolkach | Dane, pokrętło będzie wyświetlane po przesunięciu na miejsce, w którym powstaje puste wiersze.

LoadingSpinnerColor — kolor wypełnienia pokrętła ładowania. Domyślnie ustawiono na BorderColor.

NavigationStep — jak daleko galeria przewija się, jeśli jej właściwość ShowNavigation jest ustawiona na wartość prawda i użytkownik wybierze strzałkę nawigacji na końcu tej galerii.

Selectable — określa, czy można wybierać elementy galerii. Jeśli opcja ma wartość prawda, czytelnicy ekranu będą identyfikować galerię jako listę, którą można wybrać. Aby wybrać element, zaznaczając go. W przypadku ustawienia wartości fałsz czytniki ekranu będą identyfikować galerię jako zwykłą listę, przez co zaznaczanie elementu nie jest zaznacza go.

ShowNavigation — czy strzałka pojawia się na każdym końcu galerii tak, że użytkownik może przewijać elementy w galerii, wybierając strzałkę.

ShowScrollbar — czy pasek przewijania jest wyświetlany po umieszczeniu wskaźnika myszy na galerii.

TemplateFill — kolor tła galerii.

TemplatePadding — odległość między elementami w galerii.

TemplateSize — wysokość szablonu galerii w orientacji pionowej/pionowej. Lub szerokość szablonu galerii w orientacji poziomej/poziomej. Rozmiar minimalny to jeden.

Transition — efekt wizualny (Wyskakujące, Wypychane lub Brak), gdy użytkownik ustawi wskaźnik myszy na elemencie w galerii.

Visible — czy kontrolka jest widoczna, czy ukryta.

Width — odległość między lewą i prawą krawędzią kontrolki.

WrapCount — liczba elementów wyświetlanych w wierszu lub kolumnie na podstawie układu poziomego lub pionowego.

X – Odległość między lewą krawędzią kontrolki a lewą krawędzią jej kontenera nadrzędnego lub ekranu.

Y – Odległość między górną krawędzią kontrolki a górną krawędzią kontenera nadrzędnego lub ekranu.

Filter( DataSource, Formula )

Reset( Control ) - ponownie Zresetuj galerię do stanu początkowego. Stan początkowy obejmuje przeprzewijanie do pierwszego elementu i wybranie pierwszego elementu lub domyślnych, jeśli jest on obecny.

Uwaga

Reset kontrolki nie powoduje rekursywnego zresetowania wszystkich elementów podrzędnych galerii.

Przykłady

Wyświetlanie i filtrowanie danych

Pobieranie danych od użytkownika

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

Jeśli kliknięcie w dowolnym miejscu elementu galerii ma oznaczać jego zaznaczenie, musi istnieć odpowiedni kontrast między poniższymi kolorami:

  • BorderColor i kolor na zewnątrz galerii (jeśli występuje obramowanie).
  • Fill i kolor na zewnątrz galerii (jeśli nie występuje obramowanie).

Obsługa czytników ekranu

  • Należy podać wartość właściwości AccessibleLabel.

    Uwaga

    Czytniki ekranu wyświetlą ogłoszenie po zmianie elementów w galerii. Wymieniana jest także właściwość AccessibleLabel. Nadaje ona kontekst anonsu i jest szczególnie ważna, gdy na tym samym ekranie istnieje wiele galerii.

  • Gdy element galerii zawiera wiele formantów, w programie ItemAccessibleLabel jest wyświetlana zawartość elementów galerii.

  • Jeśli chcesz, aby użytkownicy wybierali element galerii, ustaw wartość parametru Z możliwością wyboru jako prawda. W przeciwnym razie ustaw tę wartość na fałsz.

  • Gdy element galerii zawiera wiele formantów, w programie ItemAccessibleLabel jest wyświetlane podsumowanie zawartości elementów galerii.

  • W zależności od tego , czy użytkownicy Mogą wybrać element galerii, powinien zostać odpowiednio ustawiony odpowiedni sposób.

Obsługa klawiatury

  • Rozważ ustawienie właściwości ShowScrollbar na prawda. Na większości urządzeń z ekranem dotykowym pasek przewijania nie będzie widoczny do momentu rozpoczęcia przewijania.

  • Jeśli kliknięcie w dowolnym miejscu elementu galerii ma oznaczać jego zaznaczenie, musi również istnieć sposób, w jaki użytkownicy klawiatury będą wybierać element galerii. Na przykład dodanie Przycisk z właściwością OnSelect ustawioną na Select(Parent).

    Uwaga

    Kontrolki poza galerią nie są uwzględniane w porządku nawigacji przy użyciu klawiatury w galerii. Właściwość TabIndex kontrolek w galerii ma określony zakres. Zobacz Właściwości ułatwień dostępu, aby dowiedzieć się więcej.

Zobacz także

Użyj DelayItemLoading i wskaźnika Ładowania, aby poprawić wydajność w galerii

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).