Picker kontrola

Bilaketa esperientzia bat eskaintzeko erabiltzen den kontrola.

Oharra

Dokumentazio osoa eta iturburu-kodea GitHub kodearen osagaien biltegian aurkitu dira.

Deskribapenak

Hautatzaileak zerrenda handi batetik elementu bat edo gehiago hautatzeko erabiltzen dira, adibidez, etiketak edo fitxategiak.

Hautatzaile-kodeen osagaiek Fluent UI hautatzailearen menuko osagaiak mihise-aplikazio eta orri pertsonalizatuetatik erabil daitezke.

Tag Picker kodea osagaiak ezaugarri hauek eskaintzen ditu:

1. Aukeratutako etiketen sarrera-bilduma batera lotzen da.
2. Iradokitako etiketen sarrera-bilduma batera lotzen da.
3. Erabiltzaileek iradokizunetatik hautatzeko edo testu libreko etiketa bat sartzeko aukera ematen die.
4. Erabiltzaile batek etiketa bat gehitzen edo kentzen duenean Aldatzean gertaera bat sortzen du.
5. Programatikoa baimentzen du Ezarri fokua.

Datu multzoak

Etiketa-hautatzaileak sarrerako datu-multzo hauek ditu, artikulu honetan zehatz-mehatz deskribatzen direnak Gako propietateak artikulu honetan.

• Tags
  • TagsDisplayName
• Suggestions
  • SuggestionsDisplayName
  • SuggestionSubDisplayName

Suggestions datu multzoa SearchTerm irteerako propietatea erabiliz iragazi behar da, adibidez:

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

Propietateak

Gakoen propietateak

Propietatea	Deskribapenak
Items	Etiketen bilduma (taula). Aplikazioa etiketak gehitzeaz edo kentzeaz arduratzen da osagaiaren Gehitu edo Kendu gertaerak sortzen direnean (ondoko OnChange gertaera atalean deskribatuta).
Suggestions_Items	Iradokizunen bilduma (taula).
TagMaxWidth	Etiketen gehienezko zabalera errendatzean. Gainerako testua elipsiekin moztuko da eta pasatzeko tresna-informazio batek testu osoa erakusten du.
AllowFreeText	Balio bat idazterakoan, ez hautatu automatikoki lehenengo iradokizuna, testu libreko sarrera bat eman ahal izateko, aurrez definitutako zerrenda batetik hautatu beharrean.
SearchTermToShortMessage	Bilaketa-terminoa MinimumSearchTermLength baino txikiagoa denean bistaratu beharreko mezua.
HintText	Mezua bistaratzeko barruan Picker bilaketa hitzik ematen ez denean.
NoSuggestionsFoundMessage	Iradokizunak bildumak emaitzarik ez duenean bistaratuko den mezua.
MinimumSearchTermLength	Iradokizunen hegaldia abiarazteko gutxieneko karaktere kopurua.
MaxTags	Gehi daitezkeen etiketa-kopuru gehienekoa. Zenbaki horren ondoren, etiketa-hautatzailea berriro bakarrik egongo da etiketa bat kendu arte.
Error	Egia da errorearen ertz gorria bistaratu behar denean.

Items propietateak

Propietatea	Deskribapenak
TagsDisplayName	Ezarri etiketa bistaratzeko izena duen zutabearen izena.

Suggestions propietateak

Propietatea	Deskribapenak
SuggestionsDisplayName	ezarri iradokizuna bistaratzeko izena duen zutabearen izena.
SuggestionsSubDisplayName	(Aukera) ezarri bigarren mailako testu-lerroa duen zutabearen izena.

Estiloaren propietateak

Propietatea	Deskribapenak
Theme	Fluent UI Theme Designer (windows.net) erabiliz sortzen den JSON kate bat onartzen du. Utzita hutsik erabiliko da lehenetsitako gaia definituta Power Apps. Ikusi gaiak gidatzeko nola konfiguratu.
FontSize	Hautatzailearen barruan agertzen diren etiketen letra-tamaina.
BorderRadius	hautatzailearen barruan agertzen diren etiketen ertzaren erradioa.
ItemHeight	Hautatzailearen barruan agertzen diren etiketen altuera (pixeletan).
AccessibilityLabel	Pantailaren irakurlea erabilerraztasun-etiketa

Gertaeraren propietateak

Propietatea	Deskribapenak
Input Event	Ezarri gertaerara bildatzeko hurrengora TagPicker

Irteerako propietateak

Propietatea	Deskribapenak
SearchTerm	Iradokizunen datu-multzoa iragazteko erabil daitekeen Etiketa-hautatzailean sartutako testua.
TagsDisplayName	Etiketa berria sortzeko erabiltzen den testua Aldaketan gertaera abiarazten denean
AutoHeight	Etiketa-hautatzaileak hainbat lerrotan biltzen dituenean, Altuera automatikoa propietatea erabil daiteke ontzi erantzuteko altuera baten altuera kontrolatzeko.

Portaera

SetFocusInputEvent gisa onartzen du.

OnChange gertaera

TagPickerOsagaiak OnChange gertaera bat sortzen du etiketak gehitzen edo kentzen direnean. Erabilitako propietate dira:

Propietatea	Deskribapenak
TagEvent	Gertaeraren izena igotakoa
TagKey	Gertaera sortu duen elementuaren gakoa (gertaera etiketa batekin erlazionatuta badago)

Gertaerak antzeko esamolde bat izan behar du:

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

Murriztapenak

Kode-osagai hau mihise-aplikazioetan eta orri pertsonalizatuetan soilik erabil daiteke.