Picker kontrola

Formant używany do wyszukiwania.

Uwaga

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

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.

Items Właściwości

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

Suggestions Właściwości

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

Output properties

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.