Контрола Карта в Power Apps
Предоставя опит за показване и редактиране за едно поле на контролата Display form или Edit form.
Описание
Контролите Display form и Edit form действат като контейнери за показване и преглед на цели записи. Всеки контейнер може да съдържа набор от контролата Card, които показват отделни полета или предоставят начин за актуализиране на тези полета. Всяка карта има свойство DataField, което определя кое поле от записа работи.
Предварително дефинираните карти са определени за различни типове данни и потребителски опит. Например може да има карта за редактиране на числово поле с контрола Text input, което е чудесно за използване с клавиатурата. Друга карта може да поддържа редактиране на номер чрез използване на контролата Slider вместо това. С избрания контрол на формата можете в десния прозорец лесно да изберете карта на базата на поле.
Самите карти съдържат контроли. Контролите на една карта съставят опит за показване и редактиране на едно поле. Например цифровата карта може да се състои от контрола Label за предоставяне на името на екрана на полето и контрола Text input за предоставяне на редактор за стойността на полето. Картата може също да има контрола Label, който показва всички грешки при валидиране, които възникват и контрола Label за общата звездичка, за да посочи, че се изисква поле.
Можете да персонализирате контролите на предварително зададена карта, като я оразмерите, преместите, скриете, добавите контроли към нея и направите други промени. Можете също така да започнете с изцяло празна карта, „персонализирана карта“, към която добавяте контроли от нулата.
Предварително определени карти са заключени по подразбиране. В заключена карта можете да променяте само определени свойства на картата или контролите в нея и не можете да изтриете заключена карта. Можете да покажете заключването на картата и да го отключите на раздела изглед на изгледа Разширени. Ако свойството е заключено и не може да бъде променено, то се появява с икона на заключване до името му. Отключването на карта е напреднала дейност и трябва да се извършва внимателно, защото автоматичното генериране на формули вече няма да се случи за картата и не можете да отключите карта.
В контейнера на формуляра, записът ThisItem е наличен и съдържа всички полета на записа. Например, свойството Default на картата трябва да бъде настроено на ThisItem.FieldName.
Можете да използвате справката Parent за конфигуриране на контрола за справяне със свойствата на картата. Например, трябва да се използва контрола Parent.Default, за да прочетете първоначалното състояние на полето от източник на данни. Като се използвате Parent вместо директен достъп до информацията, която искате, картата е по-добре капсулирана и можете да я промените в различно поле, без да нарушавате вътрешни формули.
Вижте Разберете карти с данни за примери как да персонализирате, отключите и създадете карти.
Ключови свойства
DataField – Името на полето в запис, което тази карта показва и редактира.
- Посочете името като единичен статичен низ, който е затворен в двойни кавички (например, "Име"), а не формула.
- Развържете карта, като зададете свойството DataField на празно. Свойствата Valid и Update се игнорират за несвързани карти.
Default - Първоначалната стойност на контрола, преди да бъде променена от потребителя.
- За всяко управление в картата задайте това свойство на Parent.Default, за да се отнася до стойността по подразбиране на полето според източник на данни. Например, задайте свойството Default на плъзгач на Parent.Default, за да се гарантира, че потребителят започва с обща стойност за този плъзгач.
DisplayMode - Стойностите могат да бъдат редактирани, изгледани или деактивирани. Конфигурира дали контрола в картата позволява въвеждане от потребителя (редактиране), показва само данни (изглед) или е деактивирана (забранено).
- Позволява да се използва една карта както във формите за редактиране, така и за преглед, като се конфигурира това свойство, което е обвързано с поведението на формуляра по подразбиране.
- В режим изглед, дъщерните контроли като Text input, Drop down, Date Picker ще показва само текстовата стойност и няма да изобразява никакви интерактивни елементи или декорации.
DisplayName – Показва удобното име за поле в източника на данни.
- Функцията DataSourceInfo предоставя тези метаданни от източник на данни.
- Контролите в рамките на картата трябва да се използват Parent.DisplayName да се отнася до името на полето.
Error - Удобно за потребителя съобщение за грешка, което се показва за това поле, когато валидирането не успее.
- Това свойство се задава когато повикате SubmitForm.
- Съобщението описва проблеми с валидирането въз основа на метаданните източник на данни и проверка на свойството Required на картата.
Required - Дали картата, редактираща полето на източник на данни, трябва да съдържа стойност.
- Функцията DataSourceInfo предоставя задължителните метаданни от източник на данни.
- Контролите в рамките на картата трябва да се използват Parent.Required, за да определите дали полето на тази карта е задължително.
Update - Стойността за записване обратно в източник на данни за поле.
- Използвайте формулата на това свойство, за да изтеглите стойностите от контролите за редактиране на картата, за да се върнете обратно към източник на данни. Например, задайте свойството Update на картата на Slider.Value за актуализиране на източник на данни със стойност от плъзгача в тази карта.
Width - Разстоянието между левия и десния ръб на контрола.
WidthFit - Дали контрола автоматично нараства хоризонтално, за да запълни всяко празно пространство на контрола на контейнера, като например Edit form контрола. Ако за няколко карти е зададено това свойство вярно, пространството е разделено между тях. За повече информация вижте Разберете оформлението на формуляра за данни.
Допълнителни свойства
BorderColor – Цветът на границата на контролата.
BorderStyle – Дали границата на контрола е солидна, с тирета, с точки или няма.
BorderThickness – Дебелината на границата на контролата.
Fill – Цветът на запълване в контрола.
Height - Разстоянието между горния и долния ръб на контрола.
Valid - Дали контрола Card или контролата Edit form съдържа валидни записи, готови за изпращане в източник на данни.
Visible - Дали се появява контрола, или е скрита.
X - Разстоянието между левия ръб на контрола и левия ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер). За контролата Card в контейнер, който има няколко колони, това свойство определя колоната, в която се показва картата.
Y - Разстоянието между горния ръб на контрола и горния ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер). За контролата Card в контейнер, който има няколко реда, това свойство определя ред, в която се показва картата.
Примери
Вижте Разберете карти с данни и Разберете оформлението на формуляра за данни например.
Насоки за достъпност
Контраст на цвят
Трябва да има достатъчен цветен контраст между:
- Fill и всяка дъщерна контрола. Например, ако картата съдържа Label и етикетът има прозрачно запълване, след това на картата Fill ефективно се превръща в цвят на фона на етикета. По този начин трябва да има адекватен контраст между Fill и Color на картата.
Поддръжка на екранен четец
- DisplayName трябва да е налице.
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).