Kontrolnik Picker

Ta kontrolnik se uporablja za nudenje izkušnje iskanja.

opomba,

Celotno gradivo in izvirna koda sta na voljo v skladišču komponent kode storitve GitHub.

Description

Izbirniki se uporabljajo za izbiro enega ali več elementov, kot so oznake ali datoteke, z dolgega seznama.

Komponente kode izbirnika omogočajo uporabo menijskih komponent Fluent UI Picker v aplikacijah s platnom in na straneh po meri.

Komponenta kode izbirnika oznak nudi naslednje funkcije:

1. Vezava z vhodno zbirko za izbrane oznake.
2. Vezava z vhodno zbirko za priporočene oznake.
3. Uporabnikom omogoča izbiro med predlogi ali vnos oznake za prosto besedilo.
4. Sproži dogodek On Change, ko uporabnik doda ali odstrani oznako.
5. Omogoča programsko funkcijo Nastavitev fokusa.

Nabori podatkov

Izbirnik oznak ima naslednje vhodne nabore podatkov, ki so podrobno opisani v Ključnih lastnostih v nadaljevanju tega članka.

• Tags
  • TagsDisplayName
• Suggestions
  • SuggestionsDisplayName
  • SuggestionSubDisplayName

Nabor podatkov Suggestions je treba filtrirati z uporabo izhodne lastnosti SearchTerm, kot je:

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

Lastnosti

Lastnosti ključa

Lastnost	Description
Items	Zbirka (tabela) oznak. Aplikacija je odgovorna za dodajanje ali odstranjevanje oznak kot odgovor na sprožitev dogodkov Dodaj ali Odstrani s strani komponente (opisano v naslednjem razdelku o dogodkih OnChange).
Suggestions_Items	Zbirka (tabela) predlogov.
TagMaxWidth	Največja širina oznak pri upodabljanju. Prekoračeno besedilo bo skrajšano s tremi pikami, lebdeči opis orodja pa prikaže celotno besedilo.
AllowFreeText	Ko vnašate vrednost, ne izberite samodejno prvega predloga, tako da je mogoče ponuditi prosti vnos besedila namesto izbire s predhodno določenega seznama.
SearchTermToShortMessage	Sporočilo, ki se prikaže, ko je iskalni izraz manjši od MinimumSearchTermLength.
HintText	Sporočilo, ki se prikaže v izbirniku, ko ni podan noben iskalni izraz.
NoSuggestionsFoundMessage	Sporočilo, ki se prikaže, ko zbirka predlogov ne vsebuje rezultatov.
MinimumSearchTermLength	Najmanjše število znakov za sprožitev pojavnega menija s predlogi.
MaxTags	Največje število oznak, ki jih je mogoče dodati. Po tej številki bo izbirnik oznak na voljo samo za branje, dokler oznaka ne bo odstranjena.
Error	Resnično, kadar mora biti prikazana rdeča obroba za napako.

Lastnosti Items

Lastnost	Description
TagsDisplayName	Nastavite na ime stolpca, ki vsebuje prikazano ime oznake.

Lastnosti Suggestions

Lastnost	Description
SuggestionsDisplayName	nastavite na ime stolpca, ki vsebuje prikazano ime predloga.
SuggestionsSubDisplayName	(Izbirno) nastavite na ime stolpca, ki vsebuje sekundarno vrstico besedila.

Lastnosti sloga

Lastnost	Description
Theme	Sprejme niz JSON, ki je ustvarjen z oblikovalnikom tem Fluent UI Theme Designer (windows.net). Če pustite to polje prazno, bo uporabljena privzeta tema, določena za Power Apps. Glejte nastavitev tem za pomoč pri konfiguraciji.
FontSize	velikost pisave oznak, prikazanih znotraj izbirnika.
BorderRadius	polmer obrobe oznak, prikazanih znotraj izbirnika.
ItemHeight	Višina oznak (pikslov), prikazanih znotraj izbirnika.
AccessibilityLabel	Oznaka aria za bralnik zaslona

Lastnosti dogodkov

Lastnost	Description
Input Event	Nastavite na dogodek, ki ga želite poslati v TagPicker

Lastnosti rezultatov

Lastnost	Description
SearchTerm	Besedilo, vneseno v izbirnik oznak, ki ga je mogoče uporabiti za filtriranje nabora podatkov za predloge.
TagsDisplayName	besedilo, ki se uporablja za ustvarjanje nove oznake Tag, ko se sproži dogodek On Change
AutoHeight	Ko izbirnik oznak zajame več vrstic, je mogoče uporabiti lastnost Auto Height za nadzor višine ustreznega vsebnika.

Način delovanja

Podpira SetFocus kot InputEvent.

Dogodek OnChange

Komponenta TagPicker sproži dogodek OnChange, ko so oznake dodane ali odstranjene. Uporabljene so naslednje lastnosti:

Lastnost	Description
TagEvent	Ime sproženega dogodka
TagKey	Ključ elementa, ki je sprožil dogodek (če je dogodek povezan z oznako)

Dogodek mora vsebovati izraz, podoben:

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

Omejitve

Ta komponenta kode se lahko uporablja samo v aplikacijah s platnom in na straneh po meri.