Odniesienie do użytkownika Caci Microlift

• Artykuł
02/01/2023
• Czas czytania: 2 min

Formant używany do wyszukiwania.

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
• TagDisplayName
• Suggestions
• SuggestionDisplayName
• 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 wybieraj automatycznie pierwszej sugestii, aby można było wprowadzić dowolny wpis tekstowy, zamiast wybierać z predefiniowanej 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

TagDisplayNameUstawić na nazwę kolumny, która zawiera wyświetlaną nazwę tagu.

Właściwości Suggestions

SuggestionDisplayNameustawić na nazwę kolumny zawierającej wyświetlaną nazwę sugestii. SuggestionSubDisplayName(opcjonalnie) — ustaw nazwę kolumny zawierającą pomocniczy wiersz tekstu.

Właściwości stylu

ThemeAkceptuje 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. FontSizerozmiar czcionki znaczników wyświetlanych w selektorze. BorderRadiuspromień obramowania znaczników wyświetlanych w selektorze. ItemHeightwysokość tagów (pikseli) wyświetlanych w selektorze. AccessibilityLabelCzytnik ekranu aria-label

Właściwości zdarzenia

Input EventUstaw zdarzenie do wysłania do TagPicker

Output properties

SearchTermTekst wprowadzony do selektora tagów, którego można użyć do filtrowania zestawu danych sugestii. Tekst używany do tworzenia nowego znacznika po utworzeniu zdarzenia On ChangeAutoHeightGdy 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:

TagEventNazwa podniesionego wydarzeniaTagKeyKlucz 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. TagDisplayName)) = 0,Collect( colTags, { name:TagPicker. TagDisplayName}));If( TagPicker. TagEvent="Remove",RemoveIf( colTags, name=Text(TagPicker. TagDisplayName)));
Ograniczenia
Tego składnika kodu można używać tylko w aplikacjach kanwy i na stronach niestandardowych.