Jaa

Picker hallinta

  • Artikkeli

Hakukokemuksen toteuttava ohjausobjekti.

Muistiinpano

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

Picker-ohjausobjekti

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 Majoituspaikkaa

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

Suggestions Majoituspaikkaa

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.