Picker hallinta

Hakukokemuksen toteuttava ohjausobjekti.

Muistiinpano

Täydellinen dokumentaatio ja lähdekoodi löytyvät koodikomponenttien GitHub-säilöstä.

Description

Valitsimien avulla valitaan kohteita, kuten tunnisteita tai tiedostoja, suuresta luettelosta.

Picker-koodikomponentti antaa mahdollisuuden käyttää Fluent UI:n Picker-valikkokomponenttia pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla.

Tag Picker-koodikomponentti sisältää seuraavat ominaisuudet:

1. Sitoo valittujen tunnisteiden syötekokoelmaan.
2. Sitoo ehdotettujen tunnisteiden syötekokoelmaan.
3. Salli käyttäjien tehdä valinnan ehdotuksista tai syöttää vapaatekstitunnisteen.
4. Muodostaa Muutoksen yhteydessä -tapahtuman, kun käyttäjä lisää tai poistaa tunnisteen.
5. Sallii ohjelmallisen valinnan kohdistamisen.

Tietojoukot

Tunnisteen valitsijalla on seuraavat syötetietojoukot, jotka on kuvattu yksityiskohtaisesti tässä artikkelissa jäljempänä selostetuissa Tärkeimmät ominaisuudet -kohdassa.

• Tags
  • TagsDisplayName
• Suggestions
  • SuggestionsDisplayName
  • SuggestionSubDisplayName

Suggestions-tietojoukkoa suodatetaan SearchTerm-tulosteominaisuuden avulla, esim.:

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

Ominaisuudet

Tärkeimmät ominaisuudet

Ominaisuus	Description
Items	Tunnistekokoelma (taulukko). Sovellus vastaa tunnisteiden lisäämisestä tai poistamisesta vastauksena komponentin Lisää- tai Poista-tapahtumiin (kuvattu seuraavassa OnChange-tapahtuman osassa).
Suggestions_Items	Ehdotuskokoelma (taulukko).
TagMaxWidth	Tunnisteiden enimmäisleveys hahmonnettaessa. Ylivuotava teksti katkaistaan kolmella pisteellä ja osoittimella näytettävä työkaluvihje näyttää koko tekstin.
AllowFreeText	Kun kirjoitat arvoa, älä valitse automaattisesti ensimmäistä ehdotusta, jotta vapaatekstisyöte voidaan antaa eikä valita valmiiksi määritetystä luettelosta.
SearchTermToShortMessage	Viesti, joka näytetään, kun hakuehto on lyhyempi kuin MinimumSearchTermLength.
HintText	Viesti, joka näytetään valitsimessa, kun hakuehtoa ei ole annettu.
NoSuggestionsFoundMessage	Viesti, joka näytetään, kun ehdotusten kokoelma ei sisällä tuloksia.
MinimumSearchTermLength	Merkkien vähimmäismäärä, joka käynnistää ehdotusten pikaikkunan.
MaxTags	Lisättävien tunnisteiden enimmäismäärä. Tämän numeron jälkeen tunnistevalitsin on Vain luku -muotoinen, kunnes tunniste poistetaan.
Error	True, kun virheen punaisen reunaviivan tulisi näkyä.

Items-ominaisuudet

Ominaisuus	Description
TagsDisplayName	Määritetään vastaamaan tunnisteen näyttönimen sisältävän sarakkeen nimeä.

Suggestions-ominaisuudet

Ominaisuus	Description
SuggestionsDisplayName	Määritetään vastaamaan ehdotuksen näyttönimen sisältävän sarakkeen nimeä.
SuggestionsSubDisplayName	(Valinnainen) Määritä toissijaisen tekstirivin sisältävän sarakkeen nimeksi.

Tyylin ominaisuudet

Ominaisuus	Description
Theme	Hyväksyy Fluent UI Theme Designer (windows.net) -sovelluksella luodun JSON-merkkijonon. Tämän kentän jättäminen tyhjäksi käyttää Power Appsin määrittämää oletusteemaa. Katso määritysohjeet kohdasta Teemat.
FontSize	Valitsimessa näytettyjen tunnisteiden fonttikoko.
BorderRadius	Valitsimessa näytettyjen tunnisteiden reunan säde.
ItemHeight	tunnisteiden korkeus (kuvapisteinä) valitsijassa.
AccessibilityLabel	Näytönlukuohjelman aria-otsikko

Tapahtuman ominaisuudet

Ominaisuus	Description
Input Event	Määritä TagPicker-ohjausobjektiin lähetettäväksi tapahtumaksi

Tulosominaisuudet

Ominaisuus	Description
SearchTerm	Tunnistevalitsimeen kirjoitettu teksti, jota voidaan käyttää ehdotusten tietojoukon suodattamiseen.
TagsDisplayName	Teksti, jota käytetään luomaan uusi Tunniste, kun Muutoksen yhteydessä -tapahtuma käynnistyy
AutoHeight	Kun tunnistevalitsin sisältää useita rivejä, responsiivisen säilön korkeutta voidaan hallita Automaattinen korkeus -ominaisuudella.

Toiminta

Tukee SetFocus-tapahtumaa InputEvent-tapahtumana.

OnChange-tapahtuma

TagPicker-komponentti muodostaa OnChange-tapahtuman, kun tunnisteita lisätään tai poistetaan. Käytetyt ominaisuudet:

Ominaisuus	Description
TagEvent	Käynnistetyn tapahtuman nimi
TagKey	Tapahtuman käynnistäneen kohteen avain (jos tapahtuma liittyy tunnisteeseen)

Tapahtumassa on oltava seuraavankaltainen lauseke:

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

Rajoitukset

Tätä koodikomponenttia voidaan käyttää vain pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla.