Właściwości komponentu kanwy

Komponenty kanwy umożliwiają twórcom tworzenie różnych typów właściwości w celu przekazywania wartości lub logiki między składnikiem a aplikacją, która hostuje składnik. Właściwości są niezbędne do tworzenia interaktywnych komponentów wielokrotnego użytku.

Wymagania wstępne

Ta funkcja jest domyślnie włączona dla nowych aplikacji. W przypadku istniejących aplikacji musisz włączyć tę funkcję w ustawieniach aplikacji.

1. Otwórz aplikację kanwy do edycji w aplikacji Power Apps Studio. Na pasku poleceń wybierz Ustawienia>Aktualizacje.

2. Na karcie Nowe znajdź i włącz ustawienie Rozszerzone właściwości składnika.

Rodzaje właściwości

Istnieją cztery rodzaje właściwości dostępnych dla twórców.

1. Właściwości danych: Właściwości danych odnoszą się do danych, takich jak kolor lub wartość tekstowa. Właściwość Dane może być ustawiona na Dane wejściowe lub Dane wyjściowe, co wskazuje, czy komponent dostarcza dane do aplikacji (Danych wyjściowych) lub aplikacja dostarcza dane do komponentu (Dane wejściowe). Właściwości Dane są jedynymi właściwościami, które uczestniczą w przepływie danych aplikacji.
2. Właściwości funkcji: Właściwości funkcji są związane z logiką, taką jak wykonywanie obliczeń na podstawie określonych parametrów lub zmiana tekstu. Właściwość Funkcje może być ustawiona na Dane wejściowe lub Dane wyjściowe, która wskazuje, czy składnik udostępnia funkcję, którą aplikacja może wywołać (Dane wyjściowe), lub czy aplikacja udostępnia funkcję, którą składnik może wywołać (Dane wejściowe). Właściwości Funkcja nie uczestniczą w przepływie danych aplikacji i nie mogą używać zmiennych komponentów lub aplikacji.
3. Właściwości akcji: właściwości akcji to typ właściwości, który zajmuje się logiką i zachowuje się jak Dane wyjścioweFunkcja. W ten sposób komponent ma zdefiniowaną logikę, która może wykorzystywać wyrażenia łańcuchowe i manipulować kolekcjami lub zmiennymi ("zachowanie"). Na przykład właściwość Clear()Akcja może zapewnić funkcjonalność, którą aplikacja może wywołać w celu wyczyszczenia niektórych wartości w komponencie, lub właściwość Save()Akcja, która aktualizuje źródło danych.
4. Właściwości zdarzeń: właściwości zdarzeń to kategoria właściwości, która obejmuje logikę i działa jako Dane wejścioweFunkcja. W ten sposób aplikacja definiuje logikę, którą komponent może wywoływać, a logika ta może wykorzystywać wyrażenia łańcuchowe i manipulować kolekcjami lub zmiennymi ("zachowanie"). Zazwyczaj nazwy tych właściwości odzwierciedlają zdarzenia takie jak OnSelect lub OnChanged.

Właściwość danych

Wykorzystanie właściwości danych jest łatwe do wyobrażenia. Standardowe kontrolki w aplikacjach mają zwykle kilka właściwości danych, aby ustawić wartości domyślne, kolor tekstu, rozmiar itp. Przyjrzyjmy się prostemu przykładowi, w którym chcesz udostępnić właściwości kontrolki w komponencie dostępne dla aplikacji hostingowej. W tym przykładzie komponent nosi nazwę Component1. Umieść kontrolkę suwaka wewnątrz składnika. Dodaj właściwość Input, aby określić kolor z aplikacji używającej, oraz właściwość Output , aby komponent mógł informować aplikację o bieżącej wartości suwaka. W tym przykładzie założono, że komponent ma kontrolkę Suwak o nazwie Slider.

1. W panelu właściwości komponentu wybierz Nowa właściwość niestandardowa.
2. W panelu Nowa właściwość niestandardowa wprowadź nazwę wyświetlaną Slider Color.
3. Wybierz Typ właściwości z Dane i wybierz Definicja właściwości wartość Dane wejściowe.
4. Na koniec z listy rozwijanej Typ danych wybierz pozycję Kolor.
5. Kliknij Utwórz.

Następnie wybierz kontrolkę Slider1Suwak. Znajdź jego właściwość ValueFill i na pasku formuły wpisz Component1.SliderColor. Component1 jest nazwą komponentu, a SliderColor jest nazwą dodanej właściwości.

Teraz komponent ma właściwość SliderColor, którą można ustawić w aplikacji używającej, aby przekazać kolor do komponentu i ustawić właściwość suwaka ValueFill.

Możesz również podać wartość suwaka do aplikacji używającej. W tym celu dodaj właściwości Output.

1. W panelu właściwości komponentu wybierz Nowa właściwość niestandardowa.
2. W panelu Nowa właściwość niestandardowa wprowadź nazwę wyświetlaną Slider Value.
3. Wybierz Typ właściwości z Dane i wybierz Definicja właściwości wartość Dane wyjściowe.
4. Na koniec z listy rozwijanej Typ danych wybierz pozycję Liczba.
5. Kliknij Utwórz.

Gdy właściwość Dane jest Dane wyjściowe, składnik dostarcza wartość do aplikacji konsumującej. Aby ustawić formułę, ustaw w komponencie nową właściwość SliderValue na właściwość Value suwaka.

1. W panelu właściwości komponentu kliknij właściwość Slider Value.
2. Na pasku formuły zastąp domyślną wartość 100 następującą formułą: Slider1.Value.

Teraz właściwość komponentu SliderValue odzwierciedla wartość suwaka wewnątrz składnika, którą aplikacja odbierająca może odczytać.

Właściwość funkcji

Właściwość funkcji zawiera wyrażenie, które zwraca wartość. Zazwyczaj funkcja przyjmuje argumenty, których używa do obliczania wartości do zwrócenia.

Funkcja Dane wyjściowe to prosty sposób na utworzenie niestandardowej funkcji dla Power Apps. Komponent definiuje funkcję Dane wyjściowe z wyrażeniem, które przyjmuje kilka argumentów i zwraca wartość. Funkcja ta może być następnie użyta w aplikacji przy użyciu nazwy składnik (powiedzmy Component1) poprzez wywołanie Component1.MyFunction(arg1, arg2).

Funkcja Input umożliwia aplikacji używającej zapewnienie logiki komponentowi, podobnie jak wskaźnik funkcji lub funkcja wywołania zwrotnego. Jeśli na przykład komponent współdziała z imionami i nazwiskami osób, może mieć funkcję wejściową z argumentami firstname i lastname. Będzie też oczekiwać zwrócenia ciągu znaków. Aplikacja może zdefiniować wyrażenie funkcji do zwracania wartości $"{firstname} {lastname}" lub $"{lastname}, {firstname}". Składnik wywołuje funkcję udostępnianą przez twórcę aplikacji i używa zwróconego ciągu.

Właściwość działania

Właściwości akcji są podobne do właściwości funkcji typu Dane wyjściowe, ale pozwalają na formuły efektów ubocznych i łańcuchy wyrażeń. Komponent może mieć właściwość akcji o nazwie AddRecord, która umożliwia aplikacji dodanie rekordu do kolekcji wewnątrz komponentu lub akcję Reset, która czyści zmienne lub kolekcje wewnątrz komponentu.

We wcześniejszym przykładzie suwaka dla właściwości danych można dodać właściwość akcji nazwaną ResetValue w celu ustawienia suwaka z powrotem na wartość domyślną. W tym celu użyj formuły Reset( Slider1 ). Wystąpienia komponentu w aplikacji mogą wywoływać Component1.ResetValue() w celu ustawienia suwaka z powrotem na wartość domyślną.

Właściwość zdarzenia

Wiele standardowych kontrolek ma wspólne właściwości typu Event, które są właściwościami funkcji zachowania danych wejściowych. Typowym przykładem jest OnSelect w kontrolce przycisku. Składnik może definiować właściwości zdarzenia i wywoływać te zdarzenia jak funkcję. Na przykład komponent z kontrolką przycisku może mieć właściwość zdarzenia o nazwie OnButtonClicked. W kontrolce przycisku OnSelect komponent może wywołać swoją właściwość Component1.OnButtonClicked(). Aplikacja używająca może zdefiniować własną logikę, aby ta właściwość działała po naciśnięciu przycisku wewnątrz komponentu.

Domyślne wartości właściwości lub argumentów

Wartości domyślne nadają argumentowi lub właściwości wartość, jeśli żadna nie jest ustawiona. Nie ma to sensu w przypadku niektórych typów właściwości. W niektórych przypadkach można użyć wartości domyślnych, aby pokazać oczekiwany schemat dla rekordu. Podając rekord domyślny, ustawiasz typ rekordu jako oczekiwany schemat.

Na przykład właściwość Action o nazwie AddRecord pobiera rekord, który ma zostać dodany do kolekcji lokalnej. Aby wyświetlić schemat oczekiwanego rekordu, dodaj wartość domyślną argumentu właściwości AddRecord.