Елемент керування "Картка" в Power Apps

Забезпечує можливість відображення та редагування для одного поля елемента керування Display form або Edit form.

Опис

Елементи керування Display form й Edit form виступають як контейнери для відображення та перегляду записів. Кожен контейнер може містити набір елементів керування Картка, які відображають окремі поля або дають змогу оновлювати ці поля. Кожна картка має властивість DataField, яка вказує, для якого поля запису використовується картка.

Попередньо визначені картки призначені для різних типів даних і умов роботи користувачів. Наприклад, може бути картка для редагування числового поля з елементом керування Text input, з яким дуже зручно працювати за допомогою клавіатури. Натомість інша картка може підтримувати редагування числа за допомогою елемента керування Slider. Коли вибрано елемент керування "Форма", можна легко вибрати картку на основі поля на панелі праворуч.

Самі картки містять елементи керування. Елементи керування картки створюють інтерфейс для відображення та редагування одного поля. Наприклад, числова картка може складатися з елемента керування Label для відображення імені поля та елемента керування Text input, щоб указати значення поля для редактора. Картка також може мати елемент керування Label, в якому відображаються помилки перевірки, і елемент керування Label для відображення зірочки, яка вказує на те, що поле є обов’язковим.

Можна настроїти елементи керування попередньо визначеної картки шляхом змінення її розміру, переміщення, приховання, додавання до неї елементів керування та внесення інших змін. Також можна почати роботу з пустої "настроюваної картки" й самостійно додати до неї потрібні елементи керування.

Попередньо визначені картки заблоковані за замовчуванням. У заблокованій картці можна змінювати лише певні властивості картки або елементи керування в картці. Заблоковану картку видалити неможливо. Можна відобразити стан блокування картки й розблокувати її на вкладці Подання в поданні Додатково. Якщо властивість заблокована та її неможливо змінити, поруч з її іменем відображається піктограма блокування. Розблокування картки мають здійснювати користувачі з досвідом. Робіть це обережно, оскільки після розблокування для картки не будуть автоматично створюватися формули, і цю картку неможливо буде заблокувати знову.

У контейнері форми є запис ThisItem, який містить усі поля запису. Наприклад, властивість картки За замовчуванням часто має значення ThisItem.FieldName.

Щоб настроїти елемент керування, який використовує властивості картки, можна скористатися посиланням на Батьківський об’єкт. Наприклад, елемент керування має використовувати Parent.Default для зчитування початкового стану поля з джерела даних. Якщо використовувати Батьківський об’єкт замість безпосереднього доступу до необхідної інформації, картка буде краще інкапсульована, і ви зможете змінити її на інше поле без порушення внутрішніх формул.

Приклади налаштування, розблокування й створення карток наведено в розділі Огляд карток даних.

Ключові властивості

DataField – ім’я поля в записі, яке відображає й змінює ця картка.

• Укажіть ім’я у форматі єдиного статичного рядка, взятого в подвійні лапки (наприклад, "Ім’я"). Не використовуйте формулу.
• Відкріпіть картку, встановивши для її властивості DataField значення пуста. Властивості Припустимо й Оновити ігноруються для відкріплених карток.

За замовчуванням – початкове значення елемента керуванням перед тим, як його змінює користувач.

• Для кожного елемента керування в картці встановіть для цієї властивості значення Parent.Default, щоб використовувати значення поля за замовчуванням відповідно до джерела даних. Наприклад, для властивості повзунка За замовчуванням установіть значення Parent.Default, щоб користувач міг почати роботу з універсального значення для цього повзунка.

DisplayMode – можливі наступні значення: Редагування, Перегляд або Вимкнуто. Настроює, чи елемент керування в картці дозволяє користувачеві вводити дані (Редагувати), лише відображає дані (Подання) або є вимкнутим (Вимкнуто).

• Дає змогу використовувати одну картку у формах редагування та перегляду. Для цього потрібно настроїти цю властивість, прив’язану до поведінки форми за замовчуванням.
• У режимі Подання дочірні елементи керування, такі як Text input, Drop down, Date Picker, відображатимуть лише текстове значення, а не інтерактивні елементи чи оформлення.

DisplayName – зрозуміле ім’я для поля в джерелі даних.

• Функція DataSourceInfo надає ці метадані з джерела даних.
• Елементи керування в картці повинні використовувати Parent.DisplayName, щоб посилатися на ім’я поля.

Помилка – зрозуміле повідомлення про помилку, яке відображається для цього поля в разі невдалої перевірки.

• Ця властивість встановлюється під час виклику SubmitForm.
• У повідомленні описуються проблеми перевірки на основі метаданих джерела даних і властивості Обов’язково картки.

Обов’язково – чи має картка містити значення під час редагування поля джерела даних.

• Функція DataSourceInfo надає потрібні метадані з джерела даних.
• Елементи керування в картці повинні використовувати Parent.Required, щоб визначити, чи є поле цієї картки обов’язковим.

Оновити – значення, яке записується в джерело даних для поля.

• Використовуйте формулу цієї властивості для отримання значень з елементів керування "Редагувати" картки, щоб записати ці значення в джерело даних. Наприклад, установіть для властивості картки Оновити значення Slider.Value, щоб оновити джерело даних за допомогою значення з повзунка в цій картці.

Width  – відстань між лівим і правим краями елемента керування.

WidthFit – дозволяє увімкнути автоматичне змінення розміру елемента керування по горизонталі для заповнення порожнього простору в контейнері, наприклад в елементі керування Edit form. Якщо в кількох картках вказано значення True, простір розподіляється між ними. Щоб отримати додаткові відомості, див розділ Ознайомлення з макетом форми даних.

Додаткові властивості

BorderColor  – колір межі елемента керування.

BorderStyle  – визначає стиль межі елемента керування: Суцільна, Штрихова, Пунктирна або Немає.

BorderThickness  – товщина межі елемента керування.

Fill  – колір фону елемента керування.

Height  – відстань між верхнім і нижнім краями елемента керування.

Припустимо – визначає, чи елемент керування Картка або Edit form містить припустимі значення, готові до надсилання в джерело даних.

Visible  – відображення або приховання елемента керування.

X  – відстань між лівим краєм елемента керування та лівим краєм його батьківського контейнера (екрана, якщо батьківський контейнер відсутній). Для елемента керування Card у контейнері з кількома стовпцями ця властивість визначає стовпець, в якому відображається картка.

Y  – відстань між верхнім краєм елемента керування та верхнім краєм батьківського контейнера (екрана, якщо батьківський контейнер відсутній). Для елемента керування Card у контейнері з кількома рядками ця властивість визначає рядок, в якому відображається картка.

Приклади

Див. приклади в розділах Огляд карток даних і Огляд макета форми даних.

Рекомендації щодо спеціальних можливостей

Контрастність кольору

Необхідно налаштувати відповідну контрастність кольору для таких елементів:

• Заливка та будь-які дочірні елементи керування. Наприклад, якщо картка містить Label, а підпис має прозору заливку, то Заливка картки стане кольором фону для підпису. Таким чином, між Заливкою картки й Кольором підпису має бути відповідна контрастність.

Підтримка зчитування екрана

• Обов’язковим є DisplayName.