Zdieľať cez

Picker ovládanie

  • Článok

Ovládací prvok používaný na poskytovanie prostredia na vyhľadávanie.

Poznámka

Úplnú dokumentáciu a zdrojový kód nájdete v odkladacom priestore komponentov kódu GitHub.

Ovládanie zberača.

Description

Nástroje na výber sa používajú na výber jednej alebo viacerých položiek, ako sú značky alebo súbory, z veľkého zoznamu.

Komponenty kódu Nástroja na výber umožňujú použitie komponentov ponuky ovládacieho prvku Nástroj na výber používateľského rozhrania Fluent z aplikácií plátna a vlastných stránok.

Komponent kódu Nástroj na výber značky poskytuje nasledujúce funkcie:

  1. Naviaže sa na kolekciu vstupov pre vybrané značky.
  2. Naviaže sa na kolekciu vstupov pre odporúčané značky.
  3. Umožňuje používateľom vybrať si z návrhov alebo zadať značku s voľným textom.
  4. Vyvolá udalosť Pri zmene, keď používateľ pridá alebo odstráni značku.
  5. Umožňuje programové Nastavenie zamerania.

Množiny údajov

Nástroj na výber značiek má nasledujúce množiny vstupných údajov, ktoré sú podrobne popísané v časti Kľúčové vlastnosti ďalej v tomto článku.

  • Tags
    • TagsDisplayName
  • Suggestions
    • SuggestionsDisplayName
    • SuggestionSubDisplayName

Množina údajov Suggestions by sa mala filtrovať pomocou vlastnosti výstupu SearchTerm, napríklad:

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

Vlastnosti

Vlastnosti kľúča

Vlastnosť Description
Items Kolekcia (tabuľka) značiek. Aplikácia je zodpovedná za pridávanie alebo odstraňovanie značiek v reakcii na to, že komponent vyvoláva udalosti Pridať or Odstrániť (popísané v nasledujúcej sekcii udalosti OnChange).
Suggestions_Items Kolekcia (tabuľka) návrhov.
TagMaxWidth Maximálna šírka značiek pri vykresľovaní. Text pretečenia sa skráti pomocou troch bodiek a celý text sa zobrazí po umiestnení kurzora myši.
AllowFreeText Pri písaní hodnoty nevyberajte automaticky prvý návrh, aby bolo možné zadať voľný text namiesto výberu z vopred definovaného zoznamu.
SearchTermToShortMessage Správa, ktorá sa zobrazí, keď je hľadaný výraz menší ako MinimumSearchTermLength.
HintText Správa, ktorá sa zobrazí v Nástroji na výber, keď nie je zadaný žiadny vyhľadávaný výraz.
NoSuggestionsFoundMessage Správa, ktorá sa zobrazí, keď kolekcia Návrhy neobsahuje žiadne výsledky.
MinimumSearchTermLength Minimálny počet znakov na spustenie rozbaľovacej ponuky návrhov.
MaxTags Maximálny počet značiek, ktoré je možné pridať. Po tomto čísle bude Nástroj na výber značiek iba na čítanie dovtedy, kým značku neodstránite.
Error Pravda, keď by sa mal zobraziť červený okraj chyby.

Items vlastnosti

Vlastnosť Description
TagsDisplayName Nastavte na názov stĺpca, ktorý obsahuje zobrazovaný názov značky.

Suggestions vlastnosti

Vlastnosť Description
SuggestionsDisplayName Nastavte na názov stĺpca, ktorý obsahuje zobrazovaný názov návrhu.
SuggestionsSubDisplayName (Voliteľné) nastavte na názov stĺpca, ktorý obsahuje sekundárny riadok textu.

Vlastnosti štýlu

Vlastnosť Description
Theme Akceptuje reťazec JSON, ktorý je vygenerovaný pomocou aplikácie Fluent UI Theme Designer (windows.net). Ak toto necháte prázdne, použije sa predvolený motív definovaný v Power Apps. Pokyny na konfiguráciu nájdete v časti nastavenie motívov.
FontSize Veľkosť písma značiek zobrazených v Nástroji na výber.
BorderRadius Polomer orámovania značiek zobrazených v Nástroji na výber.
ItemHeight Výška značiek (pixelov) zobrazených vo výbere.
AccessibilityLabel Označenie aria-label pre čítačky obrazovky

Vlastnosti udalosti

Vlastnosť Description
Input Event Nastavené na udalosti, ktorá sa odošle do TagPicker

Výstupné vlastnosti

Vlastnosť Description
SearchTerm Text zadaný do Nástroja na výber značiek, ktorý možno použiť na filtrovanie množiny údajov návrhov.
TagsDisplayName Text, ktorý sa použije na vytvorenie novej značky pri spustení udalosti Pri zmene
AutoHeight Keď sa nástroj na výber značiek zalomí do viacerých riadkov, vlastnosť Automatická výška sa dá použiť na ovládanie výšky responzívneho kontajnera.

Správanie

Podporuje SetFocus ako InputEvent.

Udalosť OnChange

Komponent TagPicker vyvolá udalosť OnChange, keď sa pridajú alebo odstránia značky. Použité vlastnosti:

Vlastnosť Description
TagEvent Názov vyvolanej udalosti
TagKey Kľúč položky, ktorá vyvolala udalosť (ak udalosť súvisí so značkou)

Udalosť by mala obsahovať nejaký takýto výraz:

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

Obmedzenia

Tento komponent kódu je možné použiť iba v aplikáciách plátna a vlastných stránkach.