Kontrolka Pole kombi w Power Apps

Kontrolka, która pozwala użytkownikom na dokonanie wyboru spośród podanych opcji. Obsługuje wyszukiwanie i wielokrotny wybór.

Opis

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

Za pomocą właściwości SelectMultiple można skonfigurować tryb pojedynczego lub wielokrotnego wyboru.

Podczas wyszukiwania elementów do wybrania dla każdego elementu możesz wybrać, czy będzie wyświetlana pojedyncza wartość danych, dwie wartości lub obraz i dwie wartości (osoba), modyfikując ustawienie Układ w okienku Dane.

Podczas wyświetlania na małych ekranach menu wysuwowe pozycji stanie się kontrolą pełnoekranową, co pozwala poprawić czytelność.

Selektor osób

Aby użyć Pole kombi do wyboru osób, wybierz szablon Osoba z ustawień Układ w okienku Dane, a następnie skonfiguruj powiązane właściwości danych w taki sposób, aby były wyświetlane dla poniższej osoby.

Kluczowe właściwości

Items — źródło danych, z którego jest możliwy wybór.

DefaultSelectedItems — początkowo wybrane elementy zanim użytkownik rozpocznie interakcję z kontrolką.

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

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

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

SearchFields — pola danych w źródle danych, które są przeszukiwane, gdy użytkownik wprowadza tekst.

Dodatkowe właściwości

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

BorderColor – kolor obramowania kontrolki.

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

BorderThickness – grubość obramowania kontrolki.

DisplayFields — lista pól wyświetlana dla każdego elementu zwróconego przez wyszukiwanie. Najłatwiej konfigurować za pomocą okienka Dane na karcie opcji Właściwości.

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).

FocusedBorderColor – kolor obramowania kontrolki z fokusem.

FocusedBorderThickness – grubość obramowania kontrolki z fokusem.

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

InputTextPlaceholder — tekst informacyjny wyświetlany dla użytkowników końcowych, jeśli nie wybrano elementów.

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

OnNavigate — Czynności do wykonania, gdy użytkownik wybierze element.

OnSelect — akcje do wykonania po naciśnięciu lub wyborze formantu przez użytkownika.

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

Visible – czy kontrolka jest widoczna, 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ą jej kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).

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

Przykłady

Podstawowe pole kombi

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

1. Wybierz pole Wstaw > Dane wejściowe > Pole kombi i nazwij je "Combobox1".

2. W okienku Właściwości po prawej stronie ekranu otwórz Wybierz źródło danych (obok Items), a następnie dodaj lub wybierz źródło danych, na przykład tabelę Konta.

3. W tym samym okienku wybierz opcję Edytuj (obok pól).

4. W okienku Dane otwórz listę tekstu podstawowego, a następnie zaznacz kolumnę Nazwa podstawowa, która będzie pokazana w kontrolce Pole kombi.

5. Trzymając wciśnięty klawisz 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. Na to wyrażenie należy ustawić właściwość DefaultSelectedItems, zastępując źródło danych nazwą serwera DataSource:

   First(DataSource)
   

(Opcjonalnie) Wyświetlaj wybraną nazwę konta na etykiecie

1. Wybierz opcję Wstaw > tekst etykiety, a następnie wybierz opcję Etykieta.

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

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

   Uwaga

   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.

Proste zachowanie rozwijane

Ustawiając IsSearchable na false i SelectMultiple na false, możesz osiągnąć te same funkcje, co menu rozwijane.

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

2. W okienku Właściwości po prawej stronie ekranu otwórz Wybierz źródło danych (obok Items), a następnie dodaj lub wybierz źródło danych, na przykład tabelę Konta.

3. W tym samym okienku wybierz opcję Edytuj (obok pól).

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

5. Ustawienie właściwości IsSearchable na wartość false.

6. Ustawienie właściwości SelectMultiple na wartość false.

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

   W formancie są wyświetlane dane z kolumny określonej w określonym źródło danych.

   Uwaga

   Tekst „Znajdź elementy” zniknął i będziesz mógł wybrać tylko jeden element.

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

Między poniższymi kolorami musi istnieć odpowiedni kontrast:

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

Jest to uzupełnienie standardowych wymagań dotyczących kontrastu kolorów.

Obsługa czytników ekranu

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

  Uwaga

  Na ekranach dotykowych czytniki zawartości ekranu mogą przechodzić sekwencyjnie przez zawartości pola kombi. Pole kombi działa jako przycisk, który po wybraniu pokazuje lub ukrywa swoją zawartość.

Obsługa klawiatury

• Właściwość TabIndex musi mieć wartość zero lub większą, dzięki czemu użytkownicy korzystający z klawiatury mogą przejść do kontrolki.

• Wskaźniki fokusu muszą być wyraźnie widoczne. Aby to zapewnić, skorzystaj z właściwości FocusedBorderColor i FocusedBorderThickness.

  Uwaga

  Klawisz tab powoduje przejście do pola kombi lub opuszczenie go. Klawisze strzałek powodują przechodzenie przez zawartość pola kombi. Klawisz Escape zamyka otwartą listę rozwijaną.