Kontrolka pola kombi w usłudze Power Apps

Kontrolka, która umożliwia użytkownikom dokonywanie wyborów z wybranych opcji. Obsługuje wyszukiwanie i wiele wyborów.

Description

Kontrolka Pole kombi umożliwia wyszukiwanie wybranych elementów. Wyszukiwanie jest wykonywane po stronie serwera we właściwości SearchField, więc wydajność nie ma wpływu na duże źródła danych.

Tryb wyboru pojedynczego lub wielokrotnego jest konfigurowany za pośrednictwem właściwości SelectMultiple.

Podczas wyszukiwania elementów do wybrania dla każdego elementu można wyświetlić pojedynczą wartość danych, dwie wartości lub obraz i dwie wartości (Osoba), modyfikując ustawienia układu w okienku Dane.

Gdy wyświetlasz kontrolkę na małych ekranach, menu wysuwane listy elementów staje się kontrolką pełnoekranową w celu zapewnienia lepszej użyteczności.

Ograniczenia

Kontrolka pola kombi ma następujące ograniczenia:

• Jeśli używasz kontrolki Pole kombi w galerii, jej opcje nie są zachowywane, gdy użytkownik przewija galerię. Nie jest to problem, jeśli używasz kontrolki Pole kombi w galerii, która nie przewija się. Obejście nie jest obecnie dostępne.

Selektor osób

Aby użyć pola kombi jako selektora osób, wybierz szablon Osoba z ustawień układu w okienku Dane i skonfiguruj powiązane właściwości danych, które mają być wyświetlane dla osoby poniżej.

Właściwości klucza

Items — źródło danych, z których można dokonać wyboru.

DefaultSelectedItems — początkowe wybrane elementy przed interakcją użytkownika z kontrolką.

SelectedItems — lista wybranych elementów wynikających z interakcji użytkownika.

Selected — ostatni wybrany element wynikający z interakcji użytkownika.

SelectMultiple — określa, czy użytkownik może wybrać jeden element, czy wiele elementów.

IsSearchable — czy użytkownik może wyszukiwać elementy przed wybraniem.

SearchFields — pola danych źródła danych przeszukiwane podczas wprowadzania tekstu przez użytkownika.

Dodatkowe właściwości

AccessibleLabel — etykieta dla czytników zawartości ekranu.

BorderColor — kolor obramowania kontrolki.

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

BorderThickness — grubość obramowania kontrolki.

DisplayFields — lista pól wyświetlanych dla każdego elementu zwróconego przez wyszukiwanie. Najłatwiej skonfigurować za pośrednictwem okienka Dane na karcie Właściwości.

DisplayMode — określa, czy kontrolka zezwala na wprowadzanie danych przez użytkownika (Edycja), wyświetla tylko dane (Widok) lub jest wyłączona (wyłączone).

FocusedBorderColor — kolor obramowania kontrolki, gdy kontrolka jest skoncentrowana.

FocusedBorderThickness — grubość obramowania kontrolki, gdy kontrolka jest skoncentrowana.

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

InputTextPlaceholder — tekst instrukcji wyświetlany użytkownikom końcowym, gdy nie wybrano żadnych elementów.

OnChange — akcje do wykonania, gdy użytkownik zmieni wybór.

OnNavigate — akcje do wykonania, gdy użytkownik wybierze element.

OnSelect — akcje do wykonania, gdy użytkownik naciągnie lub wybierze kontrolkę.

TabIndex — kolejność nawigacji za pomocą klawiatury w odniesieniu do innych kontrolek.

Visible — określa, czy kontrolka jest wyświetlana, czy ukryta.

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

X — odległość między lewą krawędzią kontrolki a lewą krawędzią kontenera nadrzędnego (ekran, jeśli nie ma kontenera nadrzędnego).

Y — odległość między górną krawędzią kontrolki a górną krawędzią kontenera nadrzędnego (ekran, jeśli nie ma kontenera nadrzędnego).

Przykłady

Pole kombi w warstwie Podstawowa

Kroki opisane w tym przykładzie dotyczą dowolnego źródła danych, które udostępnia tabele, ale aby wykonać te kroki dokładnie, użyj środowiska z bazą danych Microsoft Dataverse z przykładowymi danymi.

1. Wybierzpozycję Wstaw pole kombiwejściowej> i nadaj> jej nazwę "Combobox1".

2. W okienku Właściwości po prawej stronie ekranu otwórz listę Wybierz źródło danych (obok pozycji Elementy), a następnie dodaj lub wybierz źródło danych, takie jak tabela Accounts.

3. W tym samym okienku wybierz pozycję Edytuj (obok pozycji Pola).

4. W okienku Dane otwórz listę Tekst podstawowy , a następnie wybierz kolumnę Nazwa podstawowa , która będzie wyświetlana w kontrolce Pole kombi .

5. Trzymając wciśnięty Alt , wybierz strzałkę w dół, aby otworzyć kontrolkę Pole kombi .

   Kontrolka wyświetla dane z nazwy podstawowej określonej w określonym źródle danych.

(Opcjonalnie) Pokaż domyślnie pierwszy rekord

1. Ustaw właściwość DefaultSelectedItems na to wyrażenie, zastępując element DataSource nazwą źródła danych:

   First(DataSource)
   

(Opcjonalnie) Wyświetlanie wybranej wartości Nazwa konta w etykiecie

1. Wybierz pozycję Wstaw>etykietę tekstową, a następnie wybierz pozycję Etykieta.

2. Ustaw właściwość Text na to wyrażenie, zastępując tekst następującą formułą:

   If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
   

   Uwaga / Notatka

   Instrukcja If sprawdzi, jak mogą istnieć wybrane elementy i wyświetli je w etykiecie rozdzielanej przecinkami lub w komunikacie "BRAK WYBRANEGO ELEMENTU", gdy jest pusty.

Symulowanie prostego zachowania listy rozwijanej

Ustawienie wartości IsSearchable na false i SelectMultiple na false umożliwia osiągnięcie tej samej funkcjonalności listy rozwijanej.

1. Wybierz pozycję Wstaw>dane wejściowe, a następnie wybierz pole kombi.

2. W okienku Właściwości po prawej stronie ekranu otwórz listę Wybierz źródło danych (obok pozycji Elementy), a następnie dodaj lub wybierz źródło danych.

3. W tym samym okienku wybierz pozycję Edytuj (obok pozycji Pola).

4. W okienku Dane otwórz listę Tekst podstawowy , a następnie wybierz kolumnę, którą chcesz wyświetlić w kontrolce Pole kombi .

5. Ustaw właściwość IsSearchable na false.

6. Ustaw właściwość SelectMultiple na false.

7. Trzymając wciśnięty Alt , wybierz strzałkę w dół, aby otworzyć kontrolkę Pole kombi .

   Kontrolka wyświetla dane z kolumny określonej w określonym źródle danych.

   Uwaga / Notatka

   Tekst "Znajdź elementy" zniknął i będzie można wybrać tylko jeden element.

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

Musi istnieć odpowiedni kontrast kolorów między:

• ChevronFill i ChevronBackground
• ChevronHoverFill i ChevronHoverBackground
• SelectionColor i SelectionFill
• SelectionFill i Fill
• SelectionTagColor i SelectionTagFill

Jest to dodatek do standardowych wymagań dotyczących kontrastu kolorów.

Obsługa czytników ekranu

• Musi być dostępny plik AccessibleLabel.

  Uwaga / Notatka

  Na ekranach dotykowych użytkownicy czytnika zawartości ekranu mogą przechodzić sekwencyjnie w polu kombi. Pole kombi działa jako przycisk, który pokazuje lub ukrywa jego zawartość po wybraniu.

Obsługa klawiatury

• Właściwość TabIndex musi być równa zero lub większa, aby użytkownicy klawiatury mogli przejść do niej.

• Wskaźniki fokusu muszą być wyraźnie widoczne. Aby to osiągnąć, użyj polecenia FocusedBorderColor i FocusedBorderThickness .

  Uwaga / Notatka

  tabulacji przechodzi do pola kombi lub z dala od niej. strzałek nawigują po zawartości pola kombi. Klucz ucieczki zamyka listę rozwijaną po otwarciu.