Udostępnij za pośrednictwem

Kontrolka Pole kombi w Power Apps

  • Artykuł

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ść.

Uwaga

Aby wyszukać elementy z numerami, należy dokonać konwersji liczb na tekst z funkcją Tekst(). Na przykład wpisz Text(12345).

Ograniczenia

Kontrolka pola kombi ma następujące ograniczenia:

  • Jeśli kontrolka Pole kombi znajduje się w galerii, opcja wybrana w tej kontrolce nie jest zachowywana w przypadku przewinięcia galerii. Ten problem nie występuje, jeśli kontrolka Pole kombi znajduje się w galerii, która nie jest przewijana. Na razie nie ma obejścia tego problemu.

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

Uwaga

Właściwość Default jest przestarzała, zamiast tego należy użyć DefaultSelectedItems.

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.

Uwaga

IsSearchable można włączyć tylko dla pola źródło danych zawierającego co najmniej jedno pole tekstowe. Wyrażenie Items musi być delegowane, aby można było delegować zapytania podczas wyszukiwania. To oznacza, że jeśli wyrażenia If w ramach elementu Items nie są obsługiwane.

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

Uwaga

Aby wyszukać wiele pól, ustaw właściwość SearchFields w tym formacie: ["MyFirstColumn", "MySecondColumn"]. Obsługiwane są tylko pola tekstowe.

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.

Uwaga

Aby zaktualizować wiele pól wyświetlanych w danym szablonie, ustaw właściwość DisplayFields w tym formacie: ["MyFirstColumn", "MySecondColumn"].

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

Uwaga

Właściwości obramowania wysuwu są kontrolowane przez właściwości Border.

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

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