Napomena
Za pristup ovoj stranici potrebna je autorizacija. Možete se pokušati prijaviti ili promijeniti direktorije.
Za pristup ovoj stranici potrebna je autorizacija. Možete pokušati promijeniti direktorije.
Napomena
- Ovaj odjeljak objašnjava canvas komponente koje obuhvaćaju mogućnosti proširivosti korisničkog sučelja u low-codeu. Profesionalni programeri također mogu koristiti Power Apps component framework za izradu komponenti koda.
- Također možete koristiti canvas komponente u aplikacijama vođenim modelima koristeći prilagođene stranice i biblioteku komponenti. Za više informacija, pogledajte Dodaj canvas komponente na prilagođenu stranicu u aplikaciji vođenoj modelima.
Komponente su višekratni gradivni blokovi za canvas aplikacije. Kreatori aplikacija mogu kreirati prilagođene kontrole za korištenje unutar aplikacije ili između aplikacija koristeći biblioteku komponenti. Komponente mogu koristiti napredne značajke kao što su prilagođena svojstva i omogućiti složene mogućnosti. U ovom članku predstavljeni su pojmovi komponenti i neki primjeri.
Komponente su korisne pri izradi većih aplikacija koje imaju slične kontrolne obrasce. Ako ažurirate definiciju komponente unutar aplikacije, sve instance u njoj odražavaju vaše promjene. Komponente također smanjuju dupliciranje napora uklanjanjem potrebe za kopiranjem i lijepljenjem kontrola te poboljšavajući performanse. Kada koristite biblioteku komponenti, komponente pomažu u stvaranju suradničkog razvoja i standardizaciji izgleda i dojma u organizaciji.
Za učenje korištenja komponenti u Canvas aplikacijama, pogledajte ovaj video:
Komponente u aplikacijama radnog područja
Komponentu možete stvoriti unutar aplikacije kao što je objašnjeno u ovom članku ili stvaranjem nove komponente unutar biblioteke komponenti. Koristite biblioteku komponenti kada trebate koristiti komponente na više ekrana aplikacija. Također možete kopirati postojeće komponente u postojeću ili novu biblioteku komponenti.
Da biste stvorili komponentu unutar aplikacije, idite na Prikaz stabla, odaberite karticu Komponente , a zatim odaberite Nova komponenta:
Odabirom Nova komponenta otvara se prazno radno područje. Dodajte kontrole kao dio definicije komponente na platnu. Ako uređujete komponentu na canvasu, ažurirate instance iste komponente na drugim ekranima aplikacija. Aplikacije koje ponovo upotrebljavaju već stvorenu komponentu također mogu primati ažuriranja komponenti nakon što objavite promjene komponenti.
Nakon što odaberete zaslon, možete odabrati komponentu s popisa postojećih komponenti u lijevom oknu. Kad odaberete komponentu, umetnite instancu te komponente na zaslon, baš kao što umetnete kontrolu.
Komponente dostupne unutar aplikacije pojavljuju se u kategoriji Prilagođeno u popisu komponenti unutar prikaza stabla. Komponente uvezene iz biblioteka komponenti pojavljuju se u kategoriji Library components :
Napomena
Komponente obrađene u ovom članku razlikuju se od Power Apps okvira komponenti koji omogućuje programerima i kreatorima izradu kodnih komponenti za aplikacije vođene modelima i canvas aplikacije. Za više informacija pogledajte Power Apps pregled okvira komponenti.
Prilagodi svojstva
Komponenta može primati ulazne vrijednosti i emitirati podatke ako stvorite jedno ili više prilagođenih svojstava. Ti su scenariji napredni i zahtijevaju razumijevanje formula i obvezujućih ugovora .
Napomena
Eksperimentalna značajka za poboljšana svojstva komponenti pruža još više opcija za svojstva, uključujući funkcije i funkcije ponašanja. Dodatne informacije potražite u članku Svojstva komponente radnog područja (eksperimentalno)
Svojstvo unosa je način na koji komponenta prima podatke koji će se koristiti u komponenti. Svojstva unosa pojavljuju se na kartici Svojstva u desnom oknu ako je odabrana instanca komponente. Možete konfigurirati svojstva unosa izrazima ili formulama, baš kao što konfigurirate standardna svojstva u drugim kontrolama. Ostale kontrole imaju svojstva unosa, kao što je svojstvo Zadano kontrole za unos teksta .
Izlazno svojstvo koristi se za emitiranje podataka ili stanja komponente. Na primjer, svojstvo Selected na kontroli Galerija je izlazno svojstvo. Kad stvorite svojstvo izlazne vrijednosti, možete odrediti koje se druge kontrole mogu odnositi na stanje komponente.
Sljedeći korak nadalje objašnjava ove koncepte.
Stvorite primjer komponente
U ovom primjeru stvorit ćete komponentu izbornika koja odražava ovu grafiku. A kasnije možete promijeniti tekst da biste ga koristili na više zaslona, aplikacija ili oboje:
Napomena
Preporučujemo da koristite biblioteku komponenti prilikom stvaranja komponenti za ponovnu upotrebu. Ažuriranje komponenti unutar aplikacije čini raspoloživa samo ažuriranja komponenti unutar aplikacije. Kada koristite biblioteku komponenti, od vas će se zatražiti da ažurirate komponente ako se komponente unutar biblioteke ažuriraju i objave.
Stvaranje nove komponente
Stvorite praznu aplikaciju radnog područja.
U prikazu stabla odaberite Komponente , a zatim odaberite Nova komponenta da biste stvorili novu komponentu.
Odaberite novu komponentu u lijevom oknu, odaberite tri točke (...), a zatim odaberite Preimenuj. Upišite ili zalijepite naziv kao MenuComponent.
U desnom oknu postavite širinu komponente na 150 i njezinu visinu na 250, a zatim odaberite Novo prilagođeno svojstvo. Možete postaviti i visinu i širinu bilo koje druge vrijednosti, prema potrebi.
U okvire Zaslonski naziv, Naziv svojstva i Opisupišite ili zalijepite tekst kao Stavke.
Nemojte uključivati razmake u nazivu svojstva jer ćete komponentu tako nazivati kad pišete formulu. Na primjer,ComponentName.PropertyName .
Zaslonski naziv pojavljuje se na kartici Svojstva u desnom oknu ako odaberete komponentu. Opisni naziv prikaza pomaže vama i drugim tvorcima da shvate svrhu ovog svojstva. Opis se pojavljuje u opisu alata ako zadržite pokazivač miša iznad zaslonskog naziva ovog svojstva na kartici Svojstva .
Na popisu Vrsta podataka odaberite Tablica, a zatim odaberite Stvori.
Svojstvo Stavke postavljeno je na zadanu vrijednost na temelju vrste podataka koju ste naveli. Možete ga postaviti na vrijednost koja odgovara vašim potrebama. Ako ste naveli vrstu podataka Tablica ili Zapis, možda ćete htjeti promijeniti vrijednost svojstva Stavke tako da odgovara shemi podataka koju želite unijeti u komponentu. U ovom slučaju promijenit će je na popisu nizova.
Vrijednost svojstva možete postaviti na traci formule ako odaberete naziv svojstva na kartici Svojstva u desnom oknu.
Kao što je prikazano na sljedećoj slici, vrijednost svojstva možete urediti i na kartici Napredno u desnom oknu.
Postavite svojstvo komponente Stavke na ovu formulu:
Table({Item:"SampleText"})
U komponentu umetnite praznu okomitu kontrolu Galerija i odaberite Izgled u oknu svojstava kao Naslov.
Provjerite prikazuje li se na popisu svojstava svojstvo Stavke (kao što je to slučaj prema zadanim postavkama). Zatim postavite vrijednost tog svojstva na ovaj izraz:
MenuComponent.ItemsNa taj način svojstvo Stavke kontrole Galerija čita i ovisi o svojstvu unosa stavki komponente.
(Opcionalno) Postavite svojstvo BorderThickness kontrole galerije na 1, a svojstvo TemplateSize na 50. Također možete ažurirati vrijednosti za debljinu obruba i veličinu predloška na bilo koju drugu vrijednost, prema potrebi.
Dodajte komponentu zaslonu
Zatim dodajte komponentu na ekran i odredite tablicu stringova za prikaz komponente.
U lijevom oknu odaberite popis zaslona, a zatim zadani zaslon.
Na kartici Umetanje otvorite izbornik Komponente , a zatim odaberite Komponenta izbornika.
Nova komponenta prema zadanim postavkama nosi naziv MenuComponent_1 .
Postavite svojstvo Stavke MenuComponent_1 na ovu formulu:
Table({Item:"Home"}, {Item:"Admin"}, {Item:"About"}, {Item:"Help"})Ova instanca odražava ovu grafiku, no možete prilagoditi tekst i ostala svojstva svake instance.
Stvaranje i korištenje svojstva izlazne vrijednosti
Do sada ste kreirali komponentu i dodali je u aplikaciju. Zatim kreirajte izlazno svojstvo koje odražava stavku koju korisnik odabere u izborniku.
Otvorite popis komponenti, a zatim odaberite MenuComponent.
U desnom oknu odaberite karticu Svojstva , a zatim odaberite Novo prilagođeno svojstvo.
U okvire Zaslonski naziv, Naziv svojstva i Opisupišite ili zalijepite Odabrano.
U odjeljku Vrsta svojstva odaberite Izlaz, a zatim odaberite Stvori.
Na kartici Napredno postavite vrijednost svojstva Odabrano na ovaj izraz, prilagođavajući broj u nazivu galerije ako je potrebno:
Gallery1.Selected.Item
Na zadanom zaslonu aplikacije dodajte oznaku i postavite njezino svojstvo Tekst na ovaj izraz, prilagođavajući broj u nazivu komponente ako je potrebno:
MenuComponent_1.SelectedMenuComponent_1 je zadani naziv instance, a ne naziv definicije komponente. Možete preimenovati bilo koju instancu.
Dok držite tipku Alt, odaberite svaku stavku u izborniku.
Kontrola Oznaka odražava stavku izbornika koju ste nedavno odabrali.
Opseg
Svojstva ulaza i izlaza jasno definiraju sučelje između komponente i njezine aplikacije domaćina. Prema zadanim je postavkama komponenta inkapsulirana tako da je lakše ponovno koristiti komponentu u aplikacijama, što zahtijeva upotrebu svojstava za prosljeđivanje informacija u komponentu i iz komponente. Ograničenja opsega održavaju podatkovni ugovor komponente jednostavnim i kohezivnim te omogućuju ažuriranja definicija komponenti, posebno u aplikacijama s bibliotekama komponenti.
No, postoje situacije kada komponenta želi dijeliti izvor podataka ili varijablu sa svojim domaćinom. Ovo dijeljenje je posebno korisno kada je komponenta namijenjena samo za korištenje u jednoj određenoj aplikaciji. U tim slučajevima možete izravno pristupiti informacijama na razini aplikacije tako da uključite prekidač Opseg aplikacije Access u oknu svojstava komponente:
Kada uključite opseg pristupne aplikacije, sljedeće stavke su dostupne unutar komponente:
- Globalne varijable
- Zbirke
- Kontrole i komponente na zaslonima, kao što je kontrola TextInput
- Tablični izvori podataka, kao što su tablice Dataverse
Kad isključite ovu postavku, komponenta ne može pristupiti nijednoj od prethodnih stavki. Funkcije Set and Collect su i dalje dostupne, ali nastale varijable i kolekcije su ograničene na instancu komponente i ne dijele se s aplikacijom.
Netablični izvori podataka, poput Azure Blob Storage ili prilagođenog konektora, dostupni su bez obzira je li ova postavka uključena ili isključena. Zamislite ove izvore podataka više kao upućivanje na resurs okruženja, a ne na resurs aplikacije. Kada se komponenta unese u aplikaciju iz biblioteke komponenti, unose se i ti izvori podataka iz okruženja.
Komponente u biblioteci komponenti nikada ne mogu pristupiti opsegu aplikacije jer ne postoji jedinstveni opseg aplikacije na koji bi se mogao pozvati. Dakle, ova postavka nije dostupna u ovom kontekstu i učinkovito je isključena. Nakon uvoza u aplikaciju, i ako proizvođač komponenti dopušta prilagodbu, prekidač se može omogućiti, a komponenta se može prilagoditi da koristi opseg aplikacije.
Napomena
- Instance komponenti možete umetnuti na zaslon unutar biblioteke komponenti i pretpregledati taj zaslon u svrhu testiranja.
- Biblioteka komponenti se ne prikazuje kad koristiš Power Apps Mobile.
Uvoz i izvoz komponenti (opozvano)
Napomena
Ova je značajka opozvana. Biblioteke komponenti preporučeni su način ponovne upotrebe komponenti u aplikacijama. Kada koristite biblioteku komponenti, aplikacija održava ovisnosti o komponentama koje koristi. Proizvođač aplikacije biva obaviješten kada ažuriranja ovisnih komponenti postanu dostupna. Stoga bi trebale biti stvorene sve nove komponente koje se mogu ponovo iskoristiti u bibliotekama komponenti.
Mogućnost uvoza i izvoza komponenti je po defaultu onemogućena jer je ta značajka ukinuta. Iako je preporučena metoda rada s komponentama korištenje biblioteka komponenti, ovu značajku i dalje možete omogućiti pojedinačno kao iznimku dok se ne ukloni. Za to, uredi svoju aplikaciju u Power Apps Studiju, a zatim idi na Settings>Nadolazećih značajki>Remired> Postavi Izvoz i uvoz komponenti na Uključeno.
Nakon što omogućite ovu značajku, možete koristiti sljedeće mogućnosti za uvoz i izvoz komponenti.
Uvezite komponente iz druge aplikacije
Za uvoz jedne ili više komponenti iz jedne aplikacije u drugu aplikaciju, odaberite Uvoz komponenti iz izbornika Umetni, a zatim koristite padajući izbornik Prilagođeni . Ili upotrijebite Komponente u prikazu stabla u lijevom oknu.
Dijaloški okvir navodi sve aplikacije koje obuhvaćaju komponente za koje imate dozvolu za uređivanje. Odaberite aplikaciju, a zatim odaberite Uvoz da biste uvezli najnoviju objavljenu verziju svih komponenti u toj aplikaciji. Nakon što uvezete barem jednu komponentu, možete urediti svoju kopiju i izbrisati one koje vam nisu potrebne.
Aplikaciju s postojećim komponentama možete spremiti u datoteku lokalno, a zatim ponovo iskoristiti datoteku tako da je uvezete. Možete koristiti datoteku za uvoz komponenti na drugu aplikaciju.
Ako aplikacija sadrži modificiranu verziju iste komponente, od vas će se tražiti da odlučite želite li zamijeniti modificiranu verziju ili otkazati uvoz.
Nakon što stvorite komponente u aplikaciji, druge aplikacije mogu potrošiti komponente iz ove aplikacije tako da ih uvezu.
Napomena
Ako je komponenta koju ste uvezli iz druge aplikacije izmijenjena u originalnoj aplikaciji, morate ponovno ručno uvesti komponentu u aplikaciju koja je upotrebljava da biste primili najnovije promjene komponente. Umjesto toga koristite biblioteke komponenti za učinkovitiji rad s ažuriranjima komponenti.
Izvezite komponente iz svoje aplikacije
Možete izvesti komponente u datoteku i preuzeti ih za uvoz u drugu aplikaciju.
Odaberite opciju Izvoz komponenti u odjeljku Komponente u prikazu stabla u lijevom oknu:
Također možete koristiti izbornik Umetanje , a zatim umjesto toga odabrati padajući izbornik Prilagođeno .
Odabirom opcije Izvoz komponenti preuzimaju se komponente u datoteku:
Preuzeta komponentna datoteka koristi datotečni nastavak .msapp .
Uvoz komponenti iz datoteke izvezenih komponenti
Da biste uvezli komponente iz izvezene datoteke komponenti, odaberite Uvoz komponenti iz izbornika Umetanje , a zatim upotrijebite padajući izbornik Prilagođeno ili upotrijebite Komponente u prikazu stabla u lijevom oknu. U dijaloškom okviru komponenti odaberite Prenesi datoteku umjesto odabira bilo koje druge komponente ili aplikacije:
U dijaloškom okviru Otvori dođite do lokacije datoteke komponente i odaberite Otvori da biste uvezli komponente unutar aplikacije.
Uvezite komponente iz izvezene aplikacije
Aplikaciju možete spremiti lokalno odabirom File>Save as:
Nakon što spremite aplikaciju, možete ponovno koristiti njezine komponente uvozom iz datoteke. Za više informacija, pogledajte prethodni odjeljak o uvozu komponenti iz datoteke izvezenih komponenti.
Poznata ograničenja
- Kada imate dvije ili više instanci iste komponente u aplikaciji, ne možete konfigurirati prilagođeno ulazno svojstvo na vrijednost prilagođenog izlaza između istih ili različitih instanci. Ova radnja rezultira kružnom porukom upozorenja na referencu. Kako biste zaobišli ovo ograničenje, napravite kopiju komponente unutar svoje aplikacije.
- Dodavanje i pokretanje Power Automate tokova u bibliotekama komponenti nije podržano.
- Izvore podataka ili kontrole koje uključuju podatke iz tih izvora podataka (kao što su obrasci, fluidne rešetke ili podatkovne tablice) ne možete spremati s komponentama.
- Ne možete umetnuti komponentu u galeriju ili obrazac (uključujući SharePoint obrazac).
- Komponente ne podržavaju funkciju UpdateContext , ali možete stvoriti i ažurirati varijable u komponenti pomoću funkcije Set . Opseg ovih varijabli je ograničen na komponentu, no možete im pristupiti izvan komponente putem prilagođenih svojstava izlaznih vrijednosti.
Sljedeći koraci
Naučite koristiti biblioteku komponenti za stvaranje spremišta komponenti za višekratnu upotrebu.
Pogledajte
- Biblioteka komponenti
- Upravljanje životnim ciklusom aplikacija biblioteke komponenti (ALM)
- Mapiranje polja za unos komponente
- Dodavanje multimedije komponenti
- Formule ponašanja za komponente
- Power Apps component framework
- Dodavanje komponenti radnog područja na prilagođenu stranicu u aplikaciji utemeljenoj na modelu