Udostępnij przez

Picker kontrola

Formant używany do wyszukiwania.

Uwaga

Pełna dokumentacja i kod źródłowy znajdują się w repozytorium GitHub komponentów kodu.

Kontrolka wyboru.

opis

Selektory służą do wybierania jednego lub większej liczby elementów, takich jak znaczniki lub pliki, z dużej listy.

Komponenty kodu Picker umożliwiają używanie komponentów menu Picker Fluent UI wewnątrz aplikacji kanwy i stron niestandardowych.

Składnik Tag Picker kodu udostępnia następujące funkcje:

  1. Łączy się z kolekcją danych wejściowych dla wybranych tagów.
  2. Wiąże się z kolekcją wejściową dla sugerowanych tagów.
  3. Umożliwia użytkownikom wybór z sugestii lub wprowadzenie bezpłatnego znacznika tekstowego.
  4. Zgłasza zdarzenie Przy zmianie, gdy użytkownik doda lub usunie tag.
  5. Umożliwia Ustawienie fokusu programowego.

Zestawy danych

S wyboru tagów zawiera następujące zestawy danych wejściowych, które zostały szczegółowo opisane we właściwościach key w dalszej części tego artykułu.

  • Tags
    • TagsDisplayName
  • Suggestions
    • SuggestionsDisplayName
    • SuggestionSubDisplayName

Zbiór danych Suggestions powinien być filtrowany przy użyciu właściwości wyjściowej SearchTerm, na przykład:

Search(colSuggestions,TagPicker.SearchTerm,"name")

Właściwości

Właściwości klucza

Właściwości opis
Items Kolekcja (tabela) tagów. Aplikacja jest odpowiedzialna za dodanie lub usunięcie tagów w odpowiedzi na zbierane przez składnik zdarzenia Dodawanie i usuwanie (opisane w sekcji zdarzeń OnChange).
Suggestions_Items Zbiór (tabela) sugestii.
TagMaxWidth Maksymalna szerokość tagów podczas renderowania. Tekst przepełnienia zostanie obcięte przy użyciu wielokropka, a etykietka narzędzia zostanie pokazana jako pełny tekst.
AllowFreeText Podczas wpisywania wartości nie należy automatycznie wybierać pierwszej sugestii, aby można było utworzyć bezpłatny wpis tekstowy, zamiast wybierać pozycję ze wstępnie zdefiniowanej listy.
SearchTermToShortMessage Komunikat, który ma być wyświetlany, gdy termin wyszukiwania jest mniejsza niż MinimumSearchTermLength.
HintText Komunikat wyświetlany w selektorze, gdy nie zostanie podany żaden termin wyszukiwania.
NoSuggestionsFoundMessage Komunikat, który ma być wyświetlany, gdy kolekcja Sugestie nie zawiera wyników.
MinimumSearchTermLength Minimalna liczba znaków uruchamiająca wysuwane menu z sugestiami.
MaxTags Maksymalna liczba tagów, które można dodać. Po upływie tej liczby znacznik wyboru będzie ponownie usuwany tylko do momentu usunięcia znacznika.
Error Prawda, gdy powinna być wyświetlana czerwona ramka błędu.

Właściwości Items

Właściwości opis
TagsDisplayName Ustawić na nazwę kolumny, która zawiera wyświetlaną nazwę tagu.

Właściwości Suggestions

Właściwości opis
SuggestionsDisplayName ustawić na nazwę kolumny zawierającej wyświetlaną nazwę sugestii.
SuggestionsSubDisplayName (opcjonalnie) — ustaw nazwę kolumny zawierającą pomocniczy wiersz tekstu.

Właściwości stylu

Właściwości opis
Theme Akceptuje ciąg JSON generowany przy użyciu Projektanta motywów interfejsu użytkownika (windows.net). Pozostawienie tego pustego będzie używać domyślnego motywu zdefiniowanego przez ustawienie Power Apps. Zobacz motywy, aby uzyskać wskazówki dotyczące konfiguracji.
FontSize rozmiar czcionki znaczników wyświetlanych w selektorze.
BorderRadius promień obramowania znaczników wyświetlanych w selektorze.
ItemHeight wysokość tagów (pikseli) wyświetlaną w s selektorze.
AccessibilityLabel Czytnik ekranu aria-label

Właściwości zdarzenia

Właściwości opis
Input Event Ustaw zdarzenie do wysłania do TagPicker

Właściwości danych wyjściowych

Właściwości opis
SearchTerm Tekst wprowadzony do selektora tagów, którego można użyć do filtrowania zestawu danych sugestii.
TagsDisplayName Tekst używany do tworzenia nowego znacznika po utworzeniu zdarzenia On Change
AutoHeight Gdy selektor tagów zawija się w wiele wierszy, właściwość Automatyczna wysokość może służyć do kontrolowania wysokości responsywnej wysokości kontenera.

Zachowanie

Obsługuje SetFocus jako element InputEvent.

Zdarzenie OnChange

Składnik TagPicker zgłasza zdarzenie OnChange po dodaniu lub usunięciu tagów. Używane właściwości:

Właściwości opis
TagEvent Nazwa podniesionego wydarzenia
TagKey Klucz elementu, który podniósł zdarzenie (jeśli zdarzenie jest powiązane z tagiem)

Zdarzenie powinno zawierać wyrażenie podobne do:

If( TagPicker.TagEvent = "Add" && CountRows(Filter(colTags,name=TagPicker.TagsDisplayName)) = 0,
    Collect( colTags, { name:TagPicker.TagsDisplayName })
);

If( TagPicker.TagEvent="Remove",
 RemoveIf( colTags,name=Text(TagPicker.TagsDisplayName) )
);

Ograniczenia

Tego składnika kodu można używać tylko w aplikacjach kanwy i na stronach niestandardowych.

  • Last updated on