Lõuendi komponendi atribuudid (katseline)

Lõuendikomponendid võimaldavad tegijatel luua erinevat tüüpi atribuute, et edastada väärtusi või loogikat komponendi ja komponenti majutava rakenduse vahel. Omadused on oluline osa interaktiivsete ja korduvkasutatavate komponentide loomisel.

Omaduste tüübid

Tegijatele on saadaval nelja tüüpi omadusi:

1. Andmeatribuudid: andmete atribuudid on seotud andmetega (nt värv või tekstiväärtus). Atribuudiks Andmed saab määrata väärtuse Sisend või Väljund , mis näitab, kas komponent edastab rakendusele andmeid (väljund) või rakendus edastab komponendile andmeid ( sisend). Andmeatribuudid on ainsad atribuudid, mis rakenduse andmevoos osalevad.
2. Funktsiooni atribuudid: funktsiooni atribuudid on seotud loogikaga, näiteks arvutuse tegemine kindlate parameetrite põhjal või teksti muutmine. Atribuudi Funktsioon saab määrata sisendiks või väljundiks, mis näitab, kas komponent pakub funktsiooni, mida rakendus saab helistada (väljund ), või rakendus pakub funktsiooni, mida komponent saab kutsuda (sisend ). Funktsiooni atribuudid ei osale rakenduse andmevoos ega saa kasutada komponente ega rakenduse muutujaid.
3. Toimingu atribuudid: toiminguatribuudid on atribuudi tüüp, mis tegeleb loogikaga ja käitub nagu väljundfunktsioon ·. Seega on komponendil loogika määratletud ja see loogika võib kasutada aheldatud avaldisi ja manipuleerida kogumeid või muutujaid ("käitumine"). Näiteks võib atribuut Action Clear() pakkuda funktsioone, mida rakendus saab kutsuda komponendi mõne väärtuse kustutamiseks, või atribuuti Toiming Save() , mis värskendab andmeallikat.
4. Sündmuse atribuudid: sündmuse atribuudid on atribuudikategooria, mis hõlmab loogikat ja funktsioone sisendfunktsioonina ·. Seega määratleb rakendus loogika, mida komponent saab helistada ja see loogika saab kasutada aheldatud avaldisi ja manipuleerida kogumeid või muutujaid ("käitumine"). Tavaliselt peegeldavad nende atribuutide nimed sellist sündmust nagu OnSelect või OnChanged.

Andmete atribuut

Andmeatribuudi kasutamist on lihtne ette kujutada. Rakenduste standardjuhtelementidel on tavaliselt mitu andmeatribuuti, et määrata vaikeväärtused, teksti värv, suurus jne. Vaatame lihtsat näidet, kus soovime muuta komponendis oleva juhtelemendi atribuudid hostimisrakendusele kättesaadavaks. Selles näites nimetatakse Component1 meie komponenti. Panime oma komponendi sisse liuguri juhtimise. Meil on atribuut Input , et määrata tarbiva rakenduse värv, ja atribuut Väljund , kus komponent saab rakendusele öelda, milline on liuguri praegune väärtus. Järgmises näites eeldatakse, et teie komponent sisaldab nimega Slideri Slider juhtelementi.

1. Valige komponendi atribuudipaanil Uus kohandatud atribuut.
2. Sisestage paanil Uus kohandatud atribuut kuvatav nimi Slider Color.
3. Valige Atribuudi andmetüüp ja valige Atribuudi definitsiooni väärtus Sisend.
4. Lõpuks valige rippmenüüst Andmetüüp Värv.
5. Klõpsake käsku Loo.

Seejärel valige Slider1 juhtelement Slider . Leidke selle atribuut ValueFill ja sisestage Component1.SliderColor valemiribale. Component1 viitab meie komponendi nimele ja SliderColor on varem lisatud vara nimi.

Nüüd on meie komponendil SliderColor omadus, mille saab määrata tarbivas rakenduses, et edastada komponendile värv, et määrata liuguri atribuut ValueFill .

Samuti soovime pakkuda liuguri väärtust tarbivale äpile. Selle saavutamiseks lisame atribuudi Väljund .

1. Valige komponendi atribuudipaanil Uus kohandatud atribuut.
2. Sisestage paanil Uus kohandatud atribuut kuvatav nimi Slider Value.
3. Valige Atribuudi tüüp Andmed ja valige Atribuudi definitsiooni väärtus Väljund.
4. Lõpuks valige rippmenüüst Andmetüüp väärtus Number .
5. Klõpsake käsku Loo.

Kui atribuut Data on Väljastus ·, annab komponent väärtuse tarbivale rakendusele. Selle valemi määramiseks peame määrama komponendi SliderValue uue atribuudi liuguri atribuudile Väärtus .

1. Klõpsake komponendi atribuudipaanil atribuudil Slider Value .
2. Asendage valemiribal järgmise 100 valemi vaikeväärtus: Slider1.Value

Nüüd peegeldab meie komponendi omadus komponendi SliderValue sees oleva liuguri väärtust, mida saab seejärel lugeda tarbivast rakendusest.

Atribuut Funktsioon

Funktsiooni atribuut sisaldab avaldist, mis tagastab väärtuse. Tavaliselt võtab funktsioon mõned argumendid, mida ta kasutab tagastatava väärtuse arvutamiseks või määramiseks.

Väljundfunktsioon on lihtne viis kohandatud funktsiooni Power Apps loomiseks. Komponent määratleb väljundfunktsiooni avaldisega, mis võtab mõned argumendid ja tagastab väärtuse. Seda funktsiooni saab seejärel kasutada rakenduses, kasutades komponendi nime (näiteks Component1 helistades Component1.MyFunction(arg1, arg2)).

Sisestusfunktsioon on viis, kuidas tarbiv rakendus pakub komponendile loogikat, mis sarnaneb funktsiooni osuti või tagasihelistamisfunktsiooniga. Näiteks võib teie komponent tegeleda inimeste nimedega ja sellel võib olla argumentidega firstname sisestusfunktsioon ning lastname see austab stringi tagasi. Rakendus võib määratleda tagastatava funktsiooniavaldise või määratleda avaldise $"{firstname} {lastname}" $"{lastname}, {firstname}". Komponent saab lihtsalt helistada rakenduse tegija pakutavale funktsioonile ja kasutada tagastatud stringi.

Toimingu atribuut

Toiminguatribuudid sarnanevad tüübi Väljund funktsiooniatribuutidega, kuid need võimaldavad kõrvalmõju valemeid ja avaldise aheldamist. Komponendil võib olla toiminguatribuut nimega AddRecord , mis võimaldab rakendusel lisada kirje komponendi sees olevasse kogumisse, või toiming, mis kustutab komponendi sees olevad muutujad või Reset kogumid.

Varem atribuudi Data jaoks kasutatud liuguri näidetes saame tutvustada toiminguatribuuti, mida kutsutakse ResetValue liuguri vaikeväärtusele tagasi seadmiseks. Selleks võime kasutada valemit Reset( Slider1 ) . Nüüd saavad meie komponendi eksemplarid rakenduses helistada Component1.ResetValue() , et seada liugur tagasi vaikeväärtusele.

Sündmuse atribuut

Standardsetes juhtelementides on palju levinud sündmuse tüüpi atribuute, tõhusalt sisendkäitumise funktsiooni atribuute. Nupu juhtnupu onSelect on kõige ilmsem näide. Komponent võib määratleda suvalise arvu sündmuse atribuute ja nimetada neid sündmusi funktsiooniks. Näiteks nupu juhtelemendiga komponendil võib olla sündmuse atribuudi OnButtonClicked nimi. Nupu juhtelemendis OnSelect saab komponent helistada oma Component1.OnButtonClicked() atribuudile. Tarbiv rakendus saab seejärel määratleda selle atribuudi jaoks oma loogika, et toimida siis, kui komponendi sees olevat nuppu vajutatakse.

Atribuutide või argumentide vaikeväärtused

Vaikeväärtused võivad anda argumendile või atribuudile vaikeväärtuse juhul, kui ühtegi pole määratud. See ei ole teatud tüüpi omaduste puhul mõistlik. Mõnel juhul saab neid siiski kasutada kirje eeldatava skeemi esitamiseks. Vaikekirje sisestamisega luuakse kirje tüüp eeldatava skeemina.

Näiteks atribuut Action nimega AddRecord aktsepteerib kirje lisamist kohalikku kogumisse. Eeldatava kirje skeemi esitamiseks peab koostaja lisama selle AddRecord atribuudi argumendile vaikeväärtuse.