Picker kontrolė

Valdiklis, naudojamas ieškos funkcijai pateikti.

Pastaba.

Visą instrukciją ir šaltinio kodą galima rasti „GitHub“ kodo komponentų saugykloje.

Aprašą

Parinkikliai naudojami vienam ar daugiau elementų, pvz., žymėms ar failams iš didelio sąrašo, pasirinkti.

Parinkiklio kodo komponentas leidžia naudoti „Fluent UI“ meniu komponentus drobės programose ir pasirinktiniuose puslapiuose.

Žymių parinkiklio kodo komponentas teikia šias funkcijas:

1. Susieja su pasirinktų žymių įvesties rinkiniu.
2. Susieja su siūlomų žymių įvesties rinkiniu.
3. Leidžia vartotojams pasirinkti iš pasiūlymų arba įvesti laisvo teksto žymą.
4. Kai vartotojas įtraukia arba pašalina žymą, sužadina įvykį Pakeitus.
5. Leidžia programinį suaktyvinimą.

Duomenų rinkiniai

Žymių parinkiklyje yra toliau nurodyti įvesties duomenų rinkiniai, kurie bus išsamiai aprašyti šio straipsnio dalyje Pagrindinės ypatybės.

• Tags
  • TagsDisplayName
• Suggestions
  • SuggestionsDisplayName
  • SuggestionSubDisplayName

Duomenų rinkinį Suggestions reikia filtruoti naudojant išvesties ypatybę SearchTerm, pavyzdžiui:

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

Ypatybės

Raktų ypatybės

Ypatybė	Aprašą
Items	Žymių rinkinys (lentelė). Programa yra atsakinga už žymių įtraukimą arba pašalinimą atsižvelgiant į komponento įvykių Įtraukti arba Pašalinti sužadinimą (aprašyta toliau skyriuje „OnChange“ įvykis).
Suggestions_Items	Pasiūlymų rinkinys (lentelė).
TagMaxWidth	Didžiausias žymių plotis atvaizduojant. Perteklinis tekstas bus sutrumpintas pridedant daugtaškį, o virš patarimo palaikius pelės žymiklį bus rodomas visas tekstas.
AllowFreeText	Įvesdami reikšmę, automatiškai nepasirinkite pirmojo pasiūlymo, kad būtų galima pateikti laisvo teksto įrašą, o ne pasirinkite iš anksto nustatyto sąrašo.
SearchTermToShortMessage	Pranešimas, rodomas, kai ieškos terminas yra mažesnis nei MinimumSearchTermLength.
HintText	Pranešimas, rodomas parinkiklyje, kai nepateikiamas joks ieškos terminas .
NoSuggestionsFoundMessage	Pranešimas, rodomas, kai pasiūlymų rinkinyje nėra rezultatų.
MinimumSearchTermLength	Minimalus simbolių skaičius, kad būtų suaktyvintas pasiūlymų iškeliamasis meniu.
MaxTags	Maksimalus žymių skaičius, kurį galima pridėti. Po šio skaičiaus žymių parinkiklis bus tik skaitomas, kol bus pašalinta ši žyma.
Error	Teisinga, kai turi būti rodoma raudona klaidos kraštinė.

Items Apgyvendinimo įstaigos

Ypatybė	Aprašą
TagsDisplayName	Nustatykite stulpelio, kuriame yra žymos rodomas pavadinimas, pavadinimą.

Suggestions Apgyvendinimo įstaigos

Ypatybė	Aprašą
SuggestionsDisplayName	nustatykite stulpelio, kuriame yra pasiūlymo rodomas pavadinimas, pavadinimą.
SuggestionsSubDisplayName	(Pasirinktinai) nustatykite stulpelio, kuriame yra antrinė teksto eilutė, pavadinimą.

Stiliaus ypatybės

Ypatybė	Aprašą
Theme	Priima JSON eilutę, sugeneruotą naudojant „Fluent UI“ temų dizaino įrankį (windows.net). Palikus tuščią, bus naudojama numatytoji tema, apibrėžta „Power Apps“. Norėdami gauti pagalbos, kaip tai sukonfigūruoti, žr. temos
FontSize	žymės, rodomos parinkiklio viduje, šrifto dydis.
BorderRadius	žymės, rodomos parinkiklio viduje, kraštinės ribos.
ItemHeight	žymių (pikselių), rodomų "Picker" viduje, aukštis.
AccessibilityLabel	Ekrano skaitytuvo „aria“ žyma

Renginio ypatybės

Ypatybė	Aprašą
Input Event	Nustatykite įvykį, kuris turi būti siunčiamas į TagPicker

Išvesties ypatybės

Ypatybė	Aprašą
SearchTerm	Į žymių parinkiklį įvestas tekstas, kurį galima naudoti pasiūlymų duomenų rinkiniui filtruoti.
TagsDisplayName	tekstas, naudojamas naujai Žymei kurti, kai sužadinamas įvykis Keisti
AutoHeight	Kai žymių parinkiklis laužo į kelias eilutes, galima naudoti ypatybę Automatinis aukštis norint valdyti interaktyvaus konteinerio aukštį.

Elgsena

Palaiko SetFocus kaip InputEvent.

Įvykis „OnChange“

Komponentas TagPicker sužadina įvykį OnChange , kai žymės įtraukiamos arba pašalinamos. Naudojamos ypatybės:

Ypatybė	Aprašą
TagEvent	Sužadinto įvykio pavadinimas
TagKey	Elemento, kuris sužadino įvykį, raktas (jei įvykis yra susijęs su žyme)

Įvykyje turi būti išraiška, panaši į šią:

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

Apribojimai

Šį kodo komponentą galima naudoti tik drobės programose ir pasirinktiniuose puslapiuose.