Kontrolka galerii w usłudze Power Apps

Kontrolka zawierająca inne kontrolki i wyświetla zestaw danych.

Description

Kontrolka Galeria może wyświetlać 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świetlić wiele kontaktów z każdym elementem zawierającym informacje kontaktowe zawierające nazwę, adres i numer telefonu dla każdego kontaktu.

Każde pole danych jest wyświetlane w oddzielnej kontrolce w kontrolce Galeria . Te kontrolki można skonfigurować w szablonie. Szablon jest wyświetlany jako pierwszy element w galerii:

• Na lewej krawędzi kontrolki Galeria w orientacji poziomej/poziomej.
• W górnej części kontrolki Galeria w orientacji pionowej/pionowej.

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

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

Ograniczenia

Kontrolka galerii ma następujące ograniczenia:

1. Jeśli użytkownik przewija kontrolkę Galeria elastycznej wysokości przed załadowaniem wszystkich elementów, element, który jest obecnie w widoku, może zostać wypchnięty i wyłączony z widoku po zakończeniu ładowania danych. Aby uniknąć tego problemu, użyj standardowej kontrolki Galeria zamiast wariantu elastycznej wysokości .
2. Następujące kontrolki nie są obsługiwane w galerii:
   • Formularz wyświetlania
   • Formularz edycji
   • Przeglądarka plików PDF
   • Kafelek usługi Power BI
   • Edytor tekstu sformatowanych
   • Ekran przewijany (siatka płynna)
   • Internetowy skaner kodów kreskowych
3. Nie można dodać galerii wewnątrz innej galerii, jeśli ta ostatnia znajduje się już w innej galerii. Maksymalny poziom zagnieżdżania wynosi 2.
4. Minimalny rozmiar szablonu to jeden. Może to spowodować, że kontrolki w galerii będą dryfować z oczekiwanych wartości X lub Y , gdy rozmiar szablonu nie zostanie uwzględniny.
5. Jeśli automatycznie wygenerujesz aplikację z danych, zapisz aplikację, a następnie otworzysz ją ponownie, galeria przeglądania może nie wyświetlać natychmiast żadnych danych. Aby rozwiązać ten problem, wpisz co najmniej jeden znak w polu wyszukiwania, a następnie usuń wpisany tekst. Następnie galeria wyświetli dane 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. Dzieje się tak, ponieważ reguła OnChange , która poprawia źródło 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ł podczas umieszczania tych kontrolek w galerii.

Właściwości klucza

Ustawienie domyślne — element lub rekord ze źródła danych do wybrania w galerii po uruchomieniu aplikacji.

Items — źródło danych, które jest wyświetlane w kontrolce, takiej jak galeria, lista lub wykres.

Selected — wybrany element.

Dodatkowe właściwości

AccessibleLabel — etykieta galerii (a nie elementów, które zawiera) dla czytników zawartości ekranu. Należy opisać listę elementów.

AllItems — elementy załadowane w galerii. Może to być mniejsza niż rzeczywista liczba elementów źródła danych. Po przewinięciu galerii można załadować więcej elementów. Element AllItems zawiera również kontrolki, które są używane w każdym elemencie galerii.

AllItemsCount — liczba elementów załadowanych w galerii. Może to być mniejsza niż rzeczywista liczba elementów źródła danych. Po przewinięciu galerii można załadować więcej elementów.

BorderColor — kolor obramowania kontrolki.

BorderStyle — czy obramowanie kontrolki to Solid, Dashed, Dotted lub None.

BorderThickness — grubość obramowania kontrolki.

DelayItemLoading — opóźnienie ładowania elementów (wierszy) do momentu pierwszego załadowania ekranu.

DisplayMode — określa, czy kontrolka zezwala na wprowadzanie danych przez użytkownika (Edycja), wyświetla tylko dane (Widok) 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 zawartości ekranu. Należy opisać, czym jest każdy element.

LoadingSpinner (Brak, Kontrolki lub Dane) — jeśli brak, pokrętło nie będzie wyświetlane. Kiedy kontrolki | Dane, pokrętło będzie wyświetlane, gdy nastąpi przekazywanie renderowania, które powoduje wyświetlenie widocznych pustych wierszy.

LoadingSpinnerColor — kolor wypełnienia pokrętła ładowania. Wartość domyślna to BorderColor.

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

Selectable — określa, czy można wybrać elementy galerii. Po ustawieniu wartości true czytniki zawartości ekranu identyfikują galerię jako listę do wyboru. Następnie wybierz element, wybierając go. Po ustawieniu wartości false czytniki zawartości ekranu identyfikują galerię jako zwykłą listę, a wybranie elementu nie powoduje jej wybrania.

ShowNavigation — określa, czy strzałka jest wyświetlana na każdym końcu galerii, aby użytkownik mógł przewijać elementy w galerii, wybierając strzałkę.

ShowScrollbar — określa, czy pasek przewijania jest wyświetlany po umieszczeniu wskaźnika myszy użytkownika 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. Minimalny rozmiar to jeden.

Transition — efekt wizualny (Pop, Push lub None), gdy użytkownik umieści wskaźnik myszy na elemencie w galerii.

Visible — określa, czy kontrolka jest wyświetlana, 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ą 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.

Funkcje pokrewne

Filter( Źródło danych, Formuła )

Reset( Kontrolka ) — resetuje galerię z powrotem do stanu początkowego. Stan początkowy obejmuje przewijanie do pierwszego elementu i wybranie pierwszego lub domyślnego elementu, jeśli istnieje.

Przykłady

Pokazywanie i filtrowanie danych

• Pokaż tekst
• Pokaż obrazy
• Filtrowanie danych przez wybranie opcji listy
• Filtrowanie danych przez dostosowanie suwaka

Pobieranie danych od użytkownika

• Pobieranie tekstu
• Pobieranie obrazów
• Pobieranie zdjęć
• Pobieranie dźwięków
• Pobieranie rysunków

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

Jeśli kliknięcie w dowolnym miejscu elementu galerii ma go wybrać, musi istnieć odpowiedni kontrast kolorów między:

• BorderColor i kolor poza galerią (jeśli istnieje obramowanie).
• Wypełnij i kolor poza galerią (jeśli nie ma obramowania).

Obsługa czytników ekranu

• Musi być dostępny plik AccessibleLabel.

  Uwaga / Notatka

  Czytniki zawartości ekranu będą ogłaszane po zmianie elementów w galerii. Wymieniono również etykietę AccessibleLabel . Daje to kontekst anonsowi i jest jeszcze ważniejsze, gdy na tym samym ekranie znajduje się wiele galerii.

• Gdy element galerii zawiera wiele kontrolek, użyj elementu ItemAccessibleLabel , aby wyświetlić zawartość elementów galerii.

• Ustaw wartość Selectable na true , jeśli chcesz, aby użytkownicy wybrali element galerii. W przeciwnym razie ustaw wartość false.

• Gdy element galerii zawiera wiele kontrolek, użyj elementu ItemAccessibleLabel , aby podać podsumowanie zawartości elementu galerii.

• Należy odpowiednio ustawić możliwość wyboru w zależności od tego, czy użytkownicy mają wybrać element galerii.

Obsługa klawiatury

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

• Jeśli kliknięcie dowolnego miejsca w elemencie galerii ma go wybrać, użytkownicy klawiatury muszą również wybrać element galerii. Na przykład dodanie przycisku , który ma właściwość OnSelect ustawioną na Select(Parent).

  Uwaga / Notatka

  Kontrolki spoza galerii nie są brane pod uwagę w kolejności nawigacji za pomocą klawiatury w galerii. Kontrolki TabIndex w galerii są ograniczone. Zobacz właściwości ułatwień dostępu , aby dowiedzieć się więcej.

Zobacz także

Używanie narzędzia DelayItemLoading i ładowania spinneru w celu zwiększenia wydajności w galerii