Audekla komponenta rekvizīti (izmēģinājuma)

Kanvas komponenti ļauj veidotājiem izveidot dažāda veida rekvizītus, lai pārsūtītu vērtības vai loģiku starp komponentu un programmu, kas vieso komponentu. Īpašības ir būtiska interaktīvu un atkārtoti izmantojamu komponentu izveides sastāvdaļa.

Svarīgi

• Šis ir eksperimentāls līdzeklis.
• Eksperimentālie līdzekļi nav paredzēti komerciālai lietošanai, un to funkcionalitāte var būt ierobežota. Šie līdzekļi ir pieejami pirms oficiālā laidiena, lai klienti varētu priekšlaikus piekļūt līdzeklim un sniegt atsauksmes. Papildinformācija: Eksperimentālās un priekšskatījuma funkcijas.
• Šajā rakstā aprakstītā darbība ir pieejama tikai tad, ja sadaļā Iestatījumi > Gaidāmie līdzekļi > Eksperimentālie iestatījumi ir ieslēgts eksperimentālais līdzeklis Uzlaboto komponentu rekvizītu līdzeklis (pēc noklusējuma izslēgts).
• Jūsu atsauksmes mums ir ļoti vērtīgas - lūdzu, dariet mums zināmu, ko jūs domājat eksperimentālo funkciju kopienas forumā Power Apps.

Īpašību veidi

Ražotājiem ir pieejami četru veidu īpašumi:

1. Datu rekvizīti: datu rekvizīti attiecas uz datiem, piemēram, krāsu vai teksta vērtību. Rekvizītu Dati var iestatīt kā ievadi vai izvadi, kas norāda, vai komponents nodrošina datus programmai (izvade) vai programma nodrošina datus komponentam (ievade). Datu rekvizīti ir vienīgie rekvizīti, kas piedalās programmas datu plūsmā.
2. Funkcijas rekvizīti: funkcijas rekvizīti ir saistīti ar loģiku, piemēram, aprēķina veikšana, pamatojoties uz konkrētiem parametriem, vai teksta mainīšana. Rekvizītu Funkcija var iestatīt kā Ievade vai Izvade, kas norāda, vai komponents nodrošina funkciju, ko programma var izsaukt (Izvade), vai programma nodrošina funkciju, kuru komponents var izsaukt (Ievade). Funkciju rekvizīti nepiedalās programmas datu plūsmā un nevar izmantot komponentu vai programmas mainīgos.
3. Darbības rekvizīti: darbības rekvizīti ir rekvizītu tips, kas nodarbojas ar loģiku un darbojas kā izvades funkcija. Tādējādi komponentam ir definēta loģika, un šī loģika var izmantot ķēdes izteiksmes un manipulēt ar kolekcijām vai mainīgajiem ("uzvedība"). Piemēram, darbības Clear() rekvizīts var nodrošināt funkcionalitāti, ko programma var izsaukt, lai notīrītu dažas komponenta vērtības, vai darbības Save() rekvizīts, kas atjaunina datu avotu.
4. Notikuma rekvizīti: notikuma rekvizīti ir rekvizītu kategorija, kas ietver loģiku un funkcijas kā ievades funkciju. Tādējādi programma definē loģiku, kuru komponents var izsaukt, un šī loģika var izmantot ķēdes izteiksmes un manipulēt ar kolekcijām vai mainīgajiem ("uzvedība"). Parasti šo rekvizītu nosaukumi atspoguļo notikumu, piemēram, OnSelect vai OnChanged.

Datu rekvizīts

Datu rekvizīta lietojumu ir viegli iedomāties. Lietojumprogrammu standarta vadīklām parasti ir vairāki datu rekvizīti, lai iestatītu noklusējuma vērtības, teksta krāsu, lielumu utt. Apskatīsim vienkāršu piemēru, kur mēs vēlamies padarīt komponenta vadības īpašības pieejamas hostinga lietotnei. Šajā piemērā mūsu komponents ir nosaukts Component1. Mēs ievietosim slīdņa vadību mūsu komponenta iekšpusē. Mums būs ievades rekvizīts, lai norādītu krāsu no patērējošās lietotnes, un izvades rekvizīts, kurā komponents var pateikt programmai, kāda ir pašreizējā slīdņa vērtība. Tālāk sniegtajā piemērā tiek pieņemts, ka komponents satur slīdņa vadīklu ar Slider nosaukumu.

1. Komponenta rekvizītu rūtī atlasiet Jauns pielāgots rekvizīts.
2. Rūtī Jauns pielāgots rekvizīts ievadiet parādāmo vārdu Slider Color.
3. Atlasiet Datu rekvizīta tips un atlasiet Rekvizīta definīcijas vērtība Ievade.
4. Visbeidzot, nolaižamajā sarakstā Datu tips atlasiet Krāsa.
5. Noklikšķiniet uz Izveidot.

Pēc tam atlasiet vadīklu Slider1 Slīdnis . Atrodiet tā rekvizītu ValueFill un formulu joslā ievadiet Component1.SliderColor. Component1 Attiecas uz mūsu komponenta nosaukumu un SliderColor ir tā īpašuma nosaukums, kuru mēs pievienojām iepriekš.

Tagad mūsu komponentam ir SliderColor īpašums, kuru var iestatīt patērējošajā lietotnē, lai nodotu krāsu komponentam, lai iestatītu slīdņa rekvizītu ValueFill .

Mēs arī vēlamies sniegt slīdņa vērtību patērējošajai lietotnei. Lai to paveiktu, mēs pievienosim rekvizītu Izvade .

1. Komponenta rekvizītu rūtī atlasiet Jauns pielāgots rekvizīts.
2. Rūtī Jauns pielāgots rekvizīts ievadiet parādāmo vārdu Slider Value.
3. Atlasiet Datu rekvizīta tips un atlasiet Rekvizīta definīcijas vērtība Izvade.
4. Visbeidzot, nolaižamajā izvēlnē Datu tips atlasiet Numurs.
5. Noklikšķiniet uz Izveidot.

Ja rekvizīts Dati ir Izvade, komponents nodrošina vērtību patērējošajai programmai. Lai iestatītu formulu, mums ir jāiestata jaunais SliderValue komponenta rekvizīts uz slīdņa rekvizītu Vērtība .

1. Komponenta rekvizītu rūtī noklikšķiniet uz rekvizīta Slider Value .
2. Formulu joslā aizstājiet noklusējuma vērtību 100 ar šādu formulu: Slider1.Value

Tagad mūsu komponenta SliderValue īpašums atspoguļos slīdņa vērtību komponenta iekšpusē, ko pēc tam var nolasīt no patērējošās lietotnes.

Funkcijas rekvizīts

Funkcijas rekvizīts satur izteiksmi, kas atgriež vērtību. Parasti funkcija izmanto dažus argumentus, kurus tā izmanto, lai aprēķinātu vai noteiktu atgriežamo vērtību.

Piezīme

Funkcijas rekvizīti pašlaik nevar piekļūt mainīgajiem vai komponentu vērtībām un rekvizītiem un nevar aktivizēt datu plūsmu. Visas nepieciešamās vērtības ir jānodod kā argumenti.

Izvades funkcija ir vienkāršs veids, kā izveidot pielāgotu funkciju Power Apps. Komponents definē izvades funkciju ar izteiksmi, kas izmanto dažus argumentus un atgriež vērtību. Pēc tam šo funkciju var izmantot lietotnē, izmantojot komponenta nosaukumu (teiksim Component1), zvanot Component1.MyFunction(arg1, arg2).

Ievades funkcija ir veids, kā patērējoša programma nodrošina komponentam loģiku, līdzīgi kā funkciju rādītājs vai atzvanīšanas funkcija. Piemēram, jūsu komponents var būt saistīts ar cilvēku vārdiem, un tam ir ievades funkcija ar argumentiem firstname , un lastname tas ievēro virkni atpakaļ. Programma var definēt atgriežamo $"{firstname} {lastname}" funkcijas izteiksmi vai izvēlēties definēt izteiksmi par $"{lastname}, {firstname}". Komponents var vienkārši izsaukt funkciju, ko ir nodrošinājis lietotņu veidotājs, un izmantot atgriezto virkni.

Darbības rekvizīts

Darbības rekvizīti ir līdzīgi izvades tipa funkcijas rekvizītiem, taču tie ļauj izmantot blakusefektu formulas un izteiksmju ķēdi. Komponentam var būt darbības rekvizīts ar nosaukumu AddRecord , kas ļauj programmai pievienot ierakstu kolekcijai, kas atrodas komponentā, vai Reset darbība, kas notīra mainīgos vai kolekcijas komponentā.

Iepriekš datu rekvizītam izmantoto slīdņu piemēru piemērā mēs varam ieviest darbības rekvizītu, kas izsaukts ResetValue , lai iestatītu slīdnim atpakaļ tā noklusējuma vērtību. Šim nolūkam mēs varam izmantot formulu Reset( Slider1 ) . Tagad mūsu komponenta gadījumi lietotnē var izsaukt Component1.ResetValue() , lai iestatītu slīdni atpakaļ uz noklusējuma vērtību.

Notikuma rekvizīts

Standarta vadīklās ir daudz izplatītu notikuma tipa rekvizītu, efektīvi ievades uzvedības funkcijas rekvizītu. OnSelect uz pogas vadīklas ir visredzamākais piemērs. Komponents var definēt jebkādu notikuma rekvizītu skaitu un saukt šos notikumus par funkciju. Piemēram, komponentam, kuram ir pogas vadīkla, var būt nosaukts notikuma rekvizīts OnButtonClicked. Pogas vadīklas OnSelect sadaļā komponents var izsaukt tā rekvizītu Component1.OnButtonClicked() . Pēc tam patērējoša programma var definēt savu loģiku šim rekvizītam, lai rīkotos, kad tiek nospiesta poga komponentā.

Rekvizītu vai argumentu noklusējuma vērtības

Noklusējuma vērtības var nodrošināt argumenta vai rekvizīta noklusējuma vērtību gadījumā, ja nav iestatīts neviens no tiem. Dažiem īpašību veidiem tas nav jēgas. Tomēr dažos gadījumos tos var izmantot, lai nodrošinātu paredzamo ierakstu shēmu. Nodrošinot noklusējuma ierakstu, ieraksta tips tiek izveidots kā paredzamā shēma.

Piemēram, darbības rekvizīts ar nosaukumu AddRecord akceptē ierakstu pievienošanai vietējai kolekcijai. Lai nodrošinātu paredzamā ieraksta shēmu, veidotājam ir jāpievieno šī AddRecord rekvizīta argumenta noklusējuma vērtība.