Ovládací prvek Picker

Ovládací prvek poskytující prostředí pro vyhledávání.

Poznámka:

Úplná dokumentace a zdrojový kód jsou k dispozici v úložišti komponent kódu GitHubu.

Description

Ovládací prvky Picker se používají k výběru jedné nebo více položek, jako jsou značky nebo soubory, z rozsáhlého seznamu.

Komponenty kódu Picker umožňují použití komponent nabídky Fluent UI picker z aplikací plátna a vlastních stránek.

Komponenta kódu Tag Picker poskytuje následující funkce:

1. Váže se na vstupní kolekci pro vybrané značky.
2. Váže se na vstupní kolekci pro navrhované značky.
3. Umožňuje uživatelům vybrat si z návrhů nebo zadat značku volného textu.
4. Vyvolá událost On Change, když uživatel přidá nebo odebere značku.
5. Umožňuje programové Nastavení zaměření.

Datové sady

Tag Picker má následující vstupní datové sady, které jsou podrobně popsány v části Klíčové vlastnosti dále v tomto článku.

• Tags
  • TagsDisplayName
• Suggestions
  • SuggestionsDisplayName
  • SuggestionSubDisplayName

Datový soubor Suggestions by měl být filtrován například pomocí výstupní vlastnosti SearchTerm.

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

Vlastnosti

Hlavní vlastnosti

Vlastnost	Description
Items	Kolekce (tabulka) značek. Aplikace je zodpovědná za přidávání nebo odebírání značek v reakci na spouštění událostí Přidat nebo Odebrat komponenty (popsáno v následující části událostí OnChange).
Suggestions_Items	Kolekce (tabulka) návrhů.
TagMaxWidth	Maximální šířka značek při vykreslování. Text přetečení bude zkrácen se třemi tečkami a úplný text zobrazí nápověda při najetí myší.
AllowFreeText	Při zadávání hodnoty nevybírat automaticky první návrh, aby bylo možné zadat volný text namísto výběru z předem definovaného seznamu.
SearchTermToShortMessage	Zpráva, která se zobrazí, když je hledaný termín menší než MinimumSearchTermLength.
HintText	Zpráva, která se zobrazí uvnitř prvku Picker, když není zadán žádný vyhledávací výraz.
NoSuggestionsFoundMessage	Zpráva, která se zobrazí, když kolekce Návrhy neobsahuje žádné výsledky.
MinimumSearchTermLength	Minimální počet znaků pro spuštění plovoucí nabídky návrhů.
MaxTags	Maximální počet položek, které lze přidat. Po tomto čísle bude nástroj pro výběr štítku znovu pouze do té doby, než bude štítek odstraněn.
Error	True, pokud by se měl zobrazit červený chybový okraj.

Vlastnosti Items

Vlastnost	Description
TagsDisplayName	Nastavte na název sloupce, který obsahuje zobrazovaný název značky.

Vlastnosti Suggestions

Vlastnost	Description
SuggestionsDisplayName	Nastavte na název sloupce, který obsahuje zobrazovaný název návrhu.
SuggestionsSubDisplayName	(Volitelné) nastavte na název sloupce, který obsahuje sekundární řádek textu.

Vlastnosti stylu

Vlastnost	Description
Theme	Přijímá řetězec JSON, který je generován pomocí návrháře motivů Fluent UI (windows.net). Ponecháte-li toto prázdné, použije se výchozí motiv definovaný Power Apps. Nápovědu ke konfiguraci naleznete v části motivy.
FontSize	velikost písma značek zobrazených v nástroji Picker.
BorderRadius	poloměr ohraničení značek zobrazených v nástroji Picker.
ItemHeight	výška značek (v pixelech) zobrazených v nástroji Picker.
AccessibilityLabel	Popisek Aria pro čtečky obrazovky

Vlastnosti události

Vlastnost	Description
Input Event	Nastavte událost k odeslání do TagPicker

Výstupní vlastnosti

Vlastnost	Description
SearchTerm	Text zadaný do nástroje pro výběr značek, který lze použít k filtrování datové sady návrhů.
TagsDisplayName	text, který se použije k vytvoření nového Štítku, když je spuštěna událost On Change
AutoHeight	Když se nástroj pro výběr značek zalomí do více řádků, vlastnost Auto Height lze použít k ovládání výšky responzivního kontejneru.

Chování

Podporuje SetFocus jako InputEvent.

Událost OnChange

Komponenta TagPicker vyvolá událost OnChange při přidání nebo odebrání značek. Použité vlastnosti jsou:

Vlastnost	Description
TagEvent	Název události je vyvolán
TagKey	Klíč položky, která vyvolala událost (pokud se událost týká značky)

Událost by měla obsahovat výraz podobný tomuto:

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

Omezení

Tuto komponentu kódu lze použít pouze v aplikacích plátna a vlastních stránkách.