Kontrolka karty w usłudze Power Apps

Udostępnia środowisko wyświetlania i edytowania dla pojedynczego pola kontrolki Formularz wyświetlania lub Formularz edycji .

Description

Kontrolki Formularz wyświetlania i Formularz edycji działają jako kontenery do wyświetlania i wyświetlania całych rekordów. Każdy kontener może przechowywać zestaw kontrolek Karta , które wyświetlają poszczególne pola lub umożliwiają aktualizowanie tych pól. Każda karta ma właściwość DataField , która określa, na którym polu rekordu działa.

Wstępnie zdefiniowane karty są definiowane dla różnych typów danych i środowisk użytkownika. Na przykład może istnieć karta służąca do edytowania pola liczbowego za pomocą kontrolki Wprowadzanie tekstu , która doskonale nadaje się do użycia z klawiaturą. Inna karta może obsługiwać edytowanie numeru przy użyciu kontrolki Suwak . Po wybraniu kontrolki formularza możesz w okienku po prawej stronie łatwo wybrać kartę na podstawie pola.

Same karty zawierają kontrolki. Kontrolki karty tworzą środowisko wyświetlania i edytowania pojedynczego pola. Na przykład karta liczbowa może składać się z kontrolki Etykieta w celu podania nazwy wyświetlanej pola i kontrolki Wprowadzanie tekstu w celu udostępnienia edytora wartości pola. Karta może również mieć kontrolkę Etykieta , która pokazuje wszelkie błędy walidacji, które występują, oraz kontrolkę Etykieta dla wspólnej gwiazdki, aby wskazać, że pole jest wymagane.

Kontrolki wstępnie zdefiniowanej karty można dostosować, zmieniając jego rozmiar, przenosząc ją, ukrywając, dodając do niej kontrolki i wprowadzając inne zmiany. Możesz również zacząć od całkowicie pustej karty , "karty niestandardowej", do której dodajesz kontrolki od podstaw.

Wstępnie zdefiniowane karty są domyślnie zablokowane . Na zablokowanej karcie można modyfikować tylko niektóre właściwości karty lub kontrolek na karcie i nie można usunąć zablokowanej karty. Możesz wyświetlić blokadę karty i odblokować ją na karcie Widok widoku Zaawansowane . Jeśli właściwość jest zablokowana i nie można jej zmodyfikować, zostanie wyświetlona ikona blokady obok jej nazwy. Odblokowanie karty jest zaawansowanym działaniem i powinno być wykonywane z ostrożnością, ponieważ automatyczne generowanie formuł nie będzie już występować dla karty i nie można ponownie zablokować karty.

W kontenerze formularza dostępny jest rekord ThisItem i zawiera wszystkie pola rekordu. Na przykład właściwość Default karty jest często ustawiona na ThisItem. Nazwa pola.

Możesz użyć odwołania nadrzędnego , aby skonfigurować kontrolkę w celu odwołowania się do właściwości karty. Na przykład kontrolka powinna użyć parametru Parent.Default , aby odczytać początkowy stan pola ze źródła danych. Używając elementu Nadrzędnego zamiast bezpośredniego uzyskiwania dostępu do żądanych informacji, karta jest lepiej hermetyzowana i można ją zmienić na inne pole bez przerywania formuł wewnętrznych.

Zobacz Omówienie kart danych , aby zapoznać się z przykładami dostosowywania, odblokowywania i tworzenia kart.

Właściwości klucza

DataField — nazwa pola w rekordzie, który wyświetla i edytuje ta karta.

• Określ nazwę jako pojedynczy ciąg statyczny, który jest ujęta w podwójny cudzysłów (na przykład "Name"), a nie formułę.
• Usuń powiązanie karty, ustawiając jej właściwość DataFieldpustą. Właściwości Valid i Update są ignorowane dla niezwiązanych kart.

Default — początkowa wartość kontrolki przed jej zmianą przez użytkownika.

• Dla każdej kontrolki na karcie ustaw tę właściwość na Parent.Default , aby odwołać się do wartości domyślnej pola zgodnie ze źródłem danych. Na przykład ustaw właściwość Default suwaka na Parent.Default , aby upewnić się, że użytkownik zaczyna się od ogólnej wartości dla tego suwaka.

DisplayMode — wartości mogą być edytowane, widokowe lub wyłączone. Określa, czy kontrolka wewnątrz karty zezwala na wprowadzanie danych przez użytkownika (Edycja), wyświetla tylko dane (Widok) lub jest wyłączona (Wyłączone).

• Umożliwia używanie pojedynczej karty w formularzach edycji i wyświetlania przez skonfigurowanie tej właściwości, która jest domyślnie powiązana z zachowaniem formularza.
• W trybie Widok kontrolki podrzędne, takie jak Wprowadzanie tekstu, Lista rozwijana, Selektor dat wyświetla tylko wartość tekstową i nie będzie renderować żadnych elementów interaktywnych ani dekoracji.

DisplayName — przyjazna nazwa pola w źródle danych.

• Funkcja DataSourceInfo udostępnia te metadane ze źródła danych.
• Kontrolki na karcie powinny używać elementu Parent.DisplayName , aby odwoływać się do nazwy pola.

Error — przyjazny dla użytkownika komunikat o błędzie wyświetlany dla tego pola w przypadku niepowodzenia walidacji.

• Ta właściwość jest ustawiana podczas wywoływanej funkcji SubmitForm .
• Komunikat opisuje problemy z walidacją na podstawie metadanych źródła danych i sprawdzania właściwości Wymagane karty.

Wymagane — czy karta edytując pole źródła danych, musi zawierać wartość.

• Funkcja DataSourceInfo udostępnia wymagane metadane ze źródła danych.
• Kontrolki na karcie powinny używać elementu Parent.Required , aby określić, czy pole karty jest wymagane.

Update — wartość do zapisania z powrotem do źródła danych dla pola.

• Użyj formuły tej właściwości, aby ściągnąć wartości z kontrolek edycji karty w celu zapisania z powrotem do źródła danych. Na przykład ustaw właściwość Update karty na Slider.Value , aby zaktualizować źródło danych wartością z suwaka na tej karcie.

Width — odległość między lewą i prawą krawędzią kontrolki.

WidthFit — określa, czy kontrolka automatycznie zwiększa się w poziomie, aby wypełnić puste miejsce w kontrolce kontenera, takiej jak kontrolka Formularz edycji . Jeśli wiele kart ma tę właściwość ustawioną na wartość true, spacja jest podzielona między nimi. Aby uzyskać więcej informacji, zobacz Omówienie układu formularza danych.

Dodatkowe właściwości

BorderColor — kolor obramowania kontrolki.

BorderStyle — czy obramowanie kontrolki to Solid, Dashed, Dotted lub None.

BorderThickness — grubość obramowania kontrolki.

Fill — kolor tła kontrolki.

Height — odległość między górną i dolną krawędzią kontrolki.

Prawidłowe — czy kontrolka Karta lub Formularz edycji zawiera prawidłowe wpisy, które są gotowe do przesłania do źródła danych.

Visible — określa, czy kontrolka jest wyświetlana, czy ukryta.

X — odległość między lewą krawędzią kontrolki a lewą krawędzią kontenera nadrzędnego (ekran, jeśli nie ma kontenera nadrzędnego). W przypadku kontrolki Karta w kontenerze zawierającym wiele kolumn ta właściwość określa kolumnę, w której jest wyświetlana karta.

Y — odległość między górną krawędzią kontrolki a górną krawędzią kontenera nadrzędnego (ekran, jeśli nie ma kontenera nadrzędnego). W przypadku kontrolki Karta w kontenerze zawierającym wiele wierszy ta właściwość określa wiersz, w którym jest wyświetlana karta.

Przykłady

Zobacz Omówienie kart danych i Opis układu formularza danych , aby zapoznać się z przykładami.

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

Musi istnieć odpowiedni kontrast kolorów między:

• Wypełnij i wszystkie kontrolki podrzędne. Jeśli na przykład karta zawiera etykietę, a etykieta ma przezroczyste wypełnienie, wypełnienie karty skutecznie stanie się kolorem tła etykiety. W związku z tym powinien istnieć odpowiedni kontrast między wypełnieniem karty a kolorem etykiety.

Obsługa czytników ekranu

• Nazwa wyświetlana musi być obecna.