Drobės komponento apžvalga

Pastaba.

• Šiame skyriuje paaiškinami drobės komponentai, apimantys mažo kodo vartotojo sąsajos išplėtimo galimybes. Profesionalūs kūrėjai taip pat gali naudoti Power Apps komponentų sistemą kodo komponentams kurti.
• Taip pat galite naudoti drobės komponentus modeliu pagrįstose programose naudodami pasirinktinius puslapius ir komponentų biblioteką. Daugiau informacijos rasite Drobės komponentų įtraukimas į pasirinktinį puslapį modeliu pagrįstoje programoje.

Komponentai yra pakartotinai naudojami drobės programų kūrimo blokai. Programų kūrėjai gali kurti pasirinktinius valdiklius, kuriuos galima naudoti programoje arba įvairiose programose, naudodami komponentų biblioteką. Komponentai gali naudoti išplėstines funkcijas, pvz., pasirinktines ypatybes ir įgalinti sudėtines galimybes. Šiame straipsnyje supažindinama su komponentų sąvokomis ir kai kuriais pavyzdžiais.

Komponentai yra naudingi kuriant didesnes programas, turinčias panašius valdymo modelius. Atnaujinus komponento apibrėžimą programoje, visi programos egzemplioriai atitinka jūsų pakeitimus. Komponentai taip pat sumažina pastangų dubliavimąsi, nes nereikia kopijuoti ir įklijuoti valdiklių ir pagerina našumą. Kai naudojate komponentų biblioteką, komponentai padeda kurti bendradarbiavimą ir standartizuoti organizacijos išvaizdą.

Norėdami sužinoti, kaip naudoti komponentus drobės programose, žiūrėkite šį vaizdo įrašą:

Komponentai drobės programose

Galite sukurti komponentą programoje, kaip paaiškinta šiame straipsnyje, arba sukurti naują komponentą komponentų bibliotekoje. Naudokite komponentų biblioteką, kai reikia naudoti komponentus keliuose programų ekranuose. Taip pat galite kopijuoti esamus komponentus į esamą arba naują komponentų biblioteką.

Norėdami sukurti komponentą programoje, eikite į medžio rodinį, pasirinkite skirtuką Komponentai, tada pasirinkite Naujas komponentas:

Pasirinkus Naujas komponentas atidaroma tuščia drobė. Įtraukite valdiklius kaip komponento aprašo dalį drobėje. Jei redaguojate komponentą drobėje, atnaujinate to paties komponento egzempliorius kituose programų ekranuose. Programos, pakartotinai naudojančios jau sukurtą komponentą, gali gauti komponentų naujinimus, kai paskelbiate komponentų pakeitimus.

Ekraną pasirinkę kairėje srityje, esamų komponentų sąraše galite pasirinkti komponentą. Kai pasirenkate komponentą, į ekraną įterpiate to komponento egzempliorių taip pat, kaip įterpiate valdiklį.

Programoje esantys komponentai rodomi kategorijoje Pasirinktinis medžio rodinio komponentų sąraše. Iš komponentų bibliotekų importuoti komponentai rodomi kategorijoje Bibliotekos komponentai :

Pastaba.

Šiame straipsnyje aptarti komponentai skiriasi nuo "Power Apps" komponentų sistemos, kuri leidžia kūrėjams ir kūrėjams kurti modeliu pagrįstų ir drobės programų kodo komponentus. Daugiau informacijos ieškokite Power Apps komponentų sistemos apžvalga.

Pasirinktinės ypatybės

Komponentas gali gauti įvesties reikšmes ir pateikti duomenis, jei sukuriate vieną ar daugiau pasirinktinių ypatybių. Šie scenarijai yra pažangūs ir reikalauja, kad suprastumėte formules ir privalomas sutartis.

Pastaba.

Eksperimentinė patobulintų komponentų ypatybių funkcija suteikia dar daugiau ypatybių parinkčių, įskaitant funkcijas ir veikimo funkcijas. Daugiau informacijos ieškokite Drobės komponento ypatybės (eksperimentinės)

Įvesties ypatybė nurodo, kaip komponentas gauna duomenis, kurie bus naudojami komponente. Įvesties ypatybės rodomos dešiniosios srities skirtuke Ypatybės , jei pasirinktas komponento egzempliorius. Galite konfigūruoti įvesties ypatybes su išraiškomis arba formulėmis lygiai taip pat, kaip konfigūruojate kitų valdiklių standartines ypatybes. Kiti valdikliai turi įvesties ypatybes, pvz., teksto įvesties valdiklio numatytąją ypatybę .

Išvesties ypatybė naudojama duomenims arba komponento būsenai skleisti. Pavyzdžiui, galerijos valdiklio ypatybėPasirinkta yra išvesties ypatybė. Kurdami išvesties ypatybę galite nustatyti, kokius kitus valdiklius galima nurodyti komponento būsenoje.

Pateiktose instrukcijose toliau paaiškinamos šios sąvokos.

Pavyzdinio komponento kūrimas

Šiame pavyzdyje sukursite meniu komponentą, panašų į pateiktą grafinį elementą. Taip pat galite pakeisti tekstą vėliau, kad galėtumėte jį naudoti keliuose ekranuose, programose arba ir ten, ir ten:

Pastaba.

Rekomenduojame naudoti komponentų biblioteką kuriant komponentus pakartotiniam naudojimui. Atnaujinant programos komponentus komponentai atnaujinami tik programoje. Kai naudojate komponentų biblioteką, jums bus pasiūlyta atnaujinti komponentus, jei komponentai atnaujinami ir paskelbiami bibliotekoje.

Naujo komponento kūrimas

1. Sukurkite tuščią drobės programą.

2. Medžio rodinyje pasirinkite Komponentai, tada pasirinkite Naujas komponentas , kad sukurtumėte naują komponentą.

   

3. Kairiojoje srityje pasirinkite naują komponentą, pasirinkite daugtaškį (...), tada pasirinkite Pervardyti. Įveskite arba įklijuokite pavadinimą kaip MenuComponent.

4. Dešiniojoje srityje nustatykite komponento plotį kaip 150 , o aukštį – į 250, tada pasirinkite Nauja pasirinktinė ypatybė. Be to, aukštį ir plotį galite nustatyti į bet kurią kitą tinkamą reikšmę.

   

5. Laukuose Rodomas pavadinimas, Ypatybės pavadinimas ir Aprašas įveskite arba įklijuokite tekstą kaip Elementus.

   

   Į ypatybės pavadinimą neįtraukite tarpų, nes rašydami formulę komponentą nurodysite šiuo pavadinimu. Pavyzdžiui, ComponentName.PropertyName.

   Rodomas pavadinimas rodomas dešiniosios srities skirtuke Ypatybės , jei pasirenkate komponentą. Aprašomasis rodomas pavadinimas padeda jums ir kitiems kūrėjams suprasti šios ypatybės paskirtį. Aprašas rodomas patarime, jei užvedate pelės žymeklį virš šios ypatybės rodomo pavadinimo skirtuke Ypatybės .

6. Sąraše Duomenų tipas pasirinkite Lentelė, tada pasirinkite Kurti.

   

   Ypatybė Elementai nustatoma kaip numatytoji reikšmė, pagrįsta jūsų nurodytu duomenų tipu. Galite nustatyti reikšmę, atitinkančią jūsų poreikius. Jei nurodėte lentelės arba įrašo duomenų tipą , galbūt norėsite pakeisti ypatybės Elementai reikšmę, kad ji atitiktų duomenų schemą, kurią norite įvesti į komponentą. Šiuo atveju pakeisite į eilučių sąrašą.

   Ypatybės reikšmę galite nustatyti formulės juostoje, jei pasirinksite ypatybės pavadinimą dešiniosios srities skirtuke Ypatybės .

   

   Kaip parodyta kitame grafike, nuosavybės reikšmę taip pat galite redaguoti dešiniosios srities skirtuke Išsamiau .

7. Nustatykite komponento ypatybę Elementai į šią formulę:

   Table({Item:"SampleText"})
   

   

8. Komponente įterpkite tuščią vertikalų galerijos valdiklį ir ypatybių srityje pasirinkite Maketas kaip Pavadinimas.

9. Įsitikinkite, kad ypatybių sąraše rodoma ypatybė Elementai (kaip ir pagal numatytuosius nustatymus). Tada nustatykite šios ypatybės reikšmę į šią išraišką:

   MenuComponent.Items
   

   Tokiu būdu valdiklio Galerijos ypatybė Elementai nuskaito ir priklauso nuo komponento ypatybės Elementai įvesties.

10. (Pasirinktinai) Nustatykite valdiklio Galerija ypatybę BorderThickness į 1 , o ypatybę TemplateSize į 50. Taip pat galite atnaujinti kraštinės storio ir šablono dydžio reikšmes į bet kurią kitą tinkamą reikšmę.

Komponento įtraukimas į ekraną

Tada įtraukite komponentą į ekraną ir nurodykite komponento rodymo eilučių lentelę.

1. Kairėje srityje pasirinkite ekranų sąrašą, o tada pasirinkite numatytąjį ekraną.

   

2. Skirtuke Įterpimas atidarykite meniu Komponentai , tada pasirinkite MeniuKomponentas.

   

   Naujasis komponentas pagal numatytuosius nustatymus pavadintas MenuComponent_1 .

3. Nustatykite MenuComponent_1 ypatybę Elementai į šią formulę:

   Table({Item:"Home"}, {Item:"Admin"}, {Item:"About"}, {Item:"Help"})
   

   Šis egzempliorius panašus į grafinį elementą, tačiau galite tinkinti tekstą ir kitas kiekvieno egzemplioriaus ypatybes.

   

Išvesties ypatybės kūrimas ir naudojimas

Iki šiol sukūrėte komponentą ir įtraukėte jį į programą. Tada sukurkite išvesties ypatybę, atspindinčią elementą, kurį vartotojas pasirenka meniu.

1. Atidarykite komponentų sąrašą, tada pasirinkite MenuComponent.

2. Dešiniojoje srityje pasirinkite skirtuką Ypatybės , tada pasirinkite Nauja pasirinktinė ypatybė.

3. Laukuose Rodomas pavadinimas, Ypatybės pavadinimas ir Aprašas įveskite arba įklijuokite Pasirinkta.

4. Dalyje Ypatybės tipas pasirinkite Išvestis, tada pasirinkite Kurti.

   

5. Skirtuke Išsamiau nustatykite ypatybės Pasirinkta reikšmę į šią išraišką, jei reikia, koreguodami galerijos pavadinimo skaitmenį:

   Gallery1.Selected.Item
   

   

6. Numatytajame programėlės ekrane įtraukite etiketę ir nustatykite jos teksto ypatybę į šią išraišką, jei reikia, koreguodami skaitmenį komponento pavadinime:

   MenuComponent_1.Selected
   

   MenuComponent_1 yra numatytasis egzemplioriaus pavadinimas, o ne komponento apibrėžimo pavadinimas. Galite pervardyti bet kurį egzempliorių.

7. Laikydami nuspaudę klavišą „Alt“ pasirinkite kiekvieną meniu elementą.

   Etiketės valdiklis atspindi meniu elementą, kurį pasirinkote vėliausiai.

Apimtis

Įvesties ir išvesties ypatybės aiškiai apibrėžia komponento ir jį priimančios programos sąsają. Pagal numatytuosius nustatymus komponentas įtrauktas į kapsulę taip, kad būtų lengviau pakartotinai naudoti komponentą visose programose, norint perduoti informaciją komponente ir iš jo perduoti informaciją, reikia naudoti ypatybes. Aprėpties apribojimai užtikrina, kad komponento duomenų sutartis būtų paprasta ir darni, be to, tai padeda įgalinti komponentų aprašų naujinimus, ypač programose su komponentų bibliotekomis.

Tačiau kartais komponentas gali norėti bendrinti duomenų šaltinį arba kintamąjį su pagrindiniu kompiuteriu. Šis bendrinimas ypač naudingas, kai komponentas skirtas naudoti tik vienoje konkrečioje programoje. Tokiais atvejais galite tiesiogiai pasiekti taikomosios programos lygio informaciją įjungę jungiklį " Access" taikomosios programos aprėptis komponento nuosavybės srityje:

Įjungus "Access" taikomosios programos aprėptį, iš komponento pasiekiami šie elementai:

• Visuotiniai kintamieji
• Rinkiniai
• Valdikliai ir komponentai ekranuose, pvz., "TextInput" valdiklyje
• Lenteliniai duomenų šaltiniai, pvz. Dataverse lentelės

Išjungus šį parametrą, komponentas negali pasiekti nė vieno iš ankstesnių elementų.  Nustatymo ir rinkimo funkcijos vis dar pasiekiamos, tačiau gauti kintamieji ir rinkiniai yra įtraukti į komponento egzempliorių ir nėra bendrinami su programa.

Ne lentelės duomenų šaltiniai, pvz., "Azure Blob Storage" arba pasirinktinė jungtis, galimi nepriklausomai nuo to, ar šis parametras įjungtas, ar išjungtas. Galvokite apie šiuos duomenų šaltinius kaip labiau nurodančius aplinkos išteklius, o ne programų išteklius. Kai komponentas iš komponento bibliotekos konvertuojamas į programą, šie duomenų šaltiniai iš aplinkos taip pat konvertuojami.

Komponentų bibliotekos komponentai niekada negali pasiekti programos aprėpties, nes nėra vienos programos aprėpties, kurią būtų galima nurodyti. Todėl šio parametro šiame kontekste nėra ir jis efektyviai išjungiamas. Importavus į programą ir jei komponentų kūrėjas leidžia tinkinti, jungiklį galima įjungti ir komponentą modifikuoti, kad būtų naudojama programos aprėptis.

Pastaba.

• Galite įterpti komponentų egzempliorių į ekraną, esantį komponentų bibliotekoje, ir peržiūrėti tą ekraną išbandymo tikslais.
• Komponentų biblioteka nerodoma, kai naudojama Power Apps Mobile.

Komponentų importavimas arba eksportavimas (nurašyta)

Pastaba.

Ši funkcija nebereikalinga. Komponentų bibliotekos yra rekomenduojamas būdas pakartotinai naudoti komponentus programose. Kai naudojama komponentų biblioteka, programa išlaiko savo naudojamų komponentų priklausinius. Programų kūrėjas įspėjamas, kai pasiekiami priklausomų komponentų naujinimai. Todėl visi nauji pakartotinai naudojami komponentai turėtų būti sukurti komponentų bibliotekose.

Galimybė importuoti ir eksportuoti komponentus yra išjungta pagal numatytuosius nustatymus, nes ši funkcija nutraukta. Nors rekomenduojamas būdas dirbti su komponentais yra naudoti komponentų bibliotekas, vis tiek galite įjungti šią funkciją kiekvienai programai kaip išimtį, kol funkcija bus pašalinta. Norėdami tai padaryti, Power Apps Studio redaguokite programą tada eikite į Nustatymai>Būsimos funkcijos>Nebenaudojama> Nustatykite Eksportuoti ir importuoti komponentus į Įjungta.

Įjungę šią funkciją galite naudoti toliau nurodytas galimybes komponentams importuoti ir eksportuoti.

Komponentų importavimas iš kitos programos

Norėdami importuoti vieną ar daugiau komponentų iš vienos programos į kitą programą, meniu Įterpimas pasirinkite Importuoti komponentus, tada naudokite išplečiamąjį meniu Pasirinktinis. Arba naudokite Komponentai medžio rodinyje kairiojoje srityje.

Dialogo lange pateikiamos visos programos, kuriose yra komponentų, kuriuos turite teisę redaguoti. Pasirinkite programą, tada pasirinkite Importuoti , kad importuotumėte naujausią paskelbtą visų tos programos komponentų versiją. Importavę bent vieną komponentą, galite redaguoti kopiją ir panaikinti nereikalingą.

Galite įrašyti programą su esamais komponentais į failą vietoje ir pakartotinai naudoti failą importuodami. Galite naudoti failą norėdami importuoti komponentus į kitą programą.

Jei programoje yra modifikuota to paties komponento versija, būsite paraginti nuspręsti, ar pakeisti modifikuotą versiją, ar atšaukti importavimą.

Kai programoje sukuriate komponentus, kitos programos gali naudoti komponentus iš šios programos juos importuodamos.

Pastaba.

Jei iš kitos programos importuotas komponentas modifikuojamas originalioje programoje, norėdami gauti naujausius komponentų pakeitimus, komponentą rankiniu būdu turite dar kartą importuoti į naudojamą programą. Vietoj to naudokite komponentų bibliotekas, kad efektyviau dirbtumėte su komponentų naujinimais .

Komponentų eksportavimas iš programos

Galite eksportuoti komponentus į failą ir atsisiųsti juos norėdami importuoti į kitą programą.

Pasirinkite parinktį Eksportuoti komponentus iš skyriaus Komponentai , esančio medžio rodinyje kairiojoje srityje:

Taip pat galite naudoti meniu Įterpti , tada pasirinkti išskleidžiamąjį meniu Pasirinktinis .

Pasirinkus Eksportuoti komponentus , komponentai atsisiunčiami į failą:

Atsisiųstas komponento failas naudoja .msapp failo vardo plėtinį.

Komponentų importavimas iš eksportuotų komponentų failo

Norėdami importuoti komponentus iš eksportuoto komponentų failo, pasirinkite Importuoti komponentus iš bet kurio meniu Įterpimas , tada naudokite išskleidžiamąjį meniu Pasirinktinis arba naudokite Komponentai medžio rodinyje kairiojoje srityje. Komponentų dialogo lange pasirinkite Nusiųsti failą , o ne pasirinkite kitus komponentus ar programas:

Dialogo lange Atidarymas raskite komponentinio failo vietą ir pasirinkite Atidaryti , kad importuotumėte komponentus programėlės viduje.

Komponentų importavimas iš eksportuotos programos

Programėlę galite įrašyti vietoje pasirinkdami Failo>įrašymas kaip:

Įrašę programą galite pakartotinai naudoti jos komponentus importuodami juos iš failo. Daugiau informacijos rasite ankstesniame skyriuje apie komponentų importavimą iš eksportuoto komponentų failo.

Žinomi apribojimai

• Kai programoje yra du ar daugiau to paties komponento egzempliorių, negalite sukonfigūruoti pasirinktinės įvesties ypatybės į pasirinktinę išvesties ypatybės reikšmę tuose pačiuose arba skirtinguose egzemplioriuose. Atlikus šį veiksmą pateikiamas įspėjamasis pranešimas apie žiedinę nuorodą. Norėdami apeiti šį apribojimą, sukurkite komponento kopiją savo programoje.
• "Power Automate" srautų įtraukimas ir vykdymas komponentų bibliotekose nepalaikomas.
• Negalite įrašyti duomenų šaltinių arba valdiklių, kuriuose yra duomenų iš tų duomenų šaltinių (pvz., formų, „Fluid Grid“ ar duomenų lentelių) su komponentais.
• Negalite įterpti komponento į galeriją arba formą (įskaitant SharePoint formą).
• Komponentai nepalaiko funkcijos UpdateContext , bet galite kurti ir naujinti komponento kintamuosius naudodami funkciją Set . Šių kintamųjų aprėptis apribojama komponentu, tačiau galite pasiekti juos iš komponento išorės, naudodami pasirinktinės išvesties ypatybes.

Paskesni veiksmai

Sužinokite, kaip naudoti komponentų biblioteką daugkartinio naudojimo komponentų saugyklai kurti.

Taip pat žiūrėkite

• Komponentų biblioteka
• Komponentų bibliotekos programų ciklo valdymas (ALM)
• Komponento įvesties laukų susiejimas
• Multimedijos įtraukimas į komponentą
• Komponentų elgesio formulės
• Power Apps komponentų sistema
• Drobės komponentų įtraukimas į tinkintą puslapį modeliu pagrįstoje programoje