Power Apps 中的卡片控制項

提供**顯示表單** 或**編輯表單** 控制項單一欄位的顯示和編輯體驗。

描述

顯示表單 和**編輯表單** 控制項做為顯示和檢視整個記錄的容器。 每個容器都會保存一組卡片控制項顯示個別欄位或提供方法更新這些欄位。 每張卡片都有 DataField 屬性指定它處理記錄的欄位。

會針對不同的資料類型和使用者體驗定義預先定義的卡片。 例如，可能有一張卡片編輯具有**文字輸入** 控制項 (最適合與鍵盤搭配使用) 的數字欄位。 另一張卡片可能支援改用**滑桿** 控制項編輯數字。 選取表單控制項後，即可在右窗格中根據欄位輕鬆選取卡片。

卡片本身會包含控制項。 卡片的控制項構成單一欄位的顯示和編輯體驗。 例如，數字卡片可能包含**標籤** 控制項提供欄位的顯示名稱，以及**文字輸入** 控制項提供欄位值的編輯者。 卡片也可能有**標籤** 控制項顯示任何發生的驗證錯誤，以及常見星號的**標籤** 控制項指出是必要欄位。

您可以自訂預先定義卡片的控制項，方法是調整其大小、移動它、隱藏它、新增其控制項，以及進行其他變更。 您也可以從可從頭新增控制項的完全空白卡片, "自訂卡片" 作為開始。

預設會 鎖定 預先定義的卡片。 在鎖定的卡片中，您只能修改卡片的某些屬性或卡片內的控制項，而不能刪除鎖定的卡片。 您可以顯示卡片鎖定，並在 Advanced 視圖的 View 索引標籤上將其解除鎖定。 如果鎖定屬性無法修改，名稱旁邊會顯示鎖定圖示。 解除鎖定卡片是進階活動，執行時請小心，因為卡片將無法以公式自動產生，而且您無法重新鎖定卡片。

在表單的容器內，有 ThisItem 記錄可用，並包含記錄的所有欄位。 例如，卡片的 Default 屬性通常會設定為 ThisItem.FieldName。

您可以使用 Parent 參考，設定控制項參考卡片的屬性。 例如，控制項應該使用 Parent.Default 讀取資料來源中欄位的初始狀態。 使用 Parent 而非直接存取您想要的資訊，可更適當地封裝卡片，而且您可以將它變更為不同的欄位，而不中斷內部公式。

如需如何自訂、解除鎖定以及建立卡片的範例，請參閱 了解資料卡片。

主要屬性

DataField – 這張卡片顯示和編輯記錄中的欄位名稱。

• 指定名稱為雙引號括住的單一靜態字串 (例如，"Name")，而非公式。
• 將其 DataField 屬性設定為 空白，以將卡片解除繫結。 會忽略已解除繫結的卡片的 Valid 和 Update 屬性。

Default – 控制項在遭到使用者變更之前的初始值。

• 針對卡片中的每個控制項，將此屬性設定為 Parent.Default，以根據資料來源來參考欄位的預設值。 例如，將滑桿的 Default 屬性設定為 Parent.Default，確保使用者使用該滑桿的一般值開始。

DisplayMode – 其值可以是 Edit、View 或 Disabled。 設定卡片中的控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。

• 允許在編輯和檢視模式中使用單一卡片，方法是設定此屬性，此屬性預設會繫結表單行為。
• 在檢視模式中，子系控制項如**文字輸入、下拉式選單、日期選取器** 將只會顯示文字值，不會呈現任何互動元素或裝飾。

DisplayName – 資料來源欄位中的使用者易記名稱。

• DataSourceInfo 函數提供資料來源中的這個中繼資料。
• 卡片內的控制項應該使用 Parent.DisplayName 參考欄位的名稱。

Error – 驗證失敗時，針對此欄位所顯示的使用者易記錯誤訊息。

• 呼叫 SubmitForm 時設定這個屬性。
• 此訊息會根據資料來源的中繼資料檢查卡片的 Required 屬性來描述驗證問題。

Required – 編輯資料來源欄位的卡片是否必須包含一個值。

• DataSourceInfo 函數提供資料來源中必要的中繼資料。
• 卡片內的控制項應該使用 Parent.Required 來判斷該卡片的欄位是否為必要的。

Update – 預計寫回欄位的資料來源值。

• 使用此屬性公式取回卡片編輯控制項的值，以便寫回資料來源。 例如，將卡片的 Update 屬性設定為 Slider.Value，以使用該卡片中的滑桿值更新資料來源。

Width – 控制項左邊緣與右邊緣之間的距離。

WidthFit – 控制項是否會自動水平成長以填滿容器控制項，如**編輯表單** 控制項中的所有空白空間。 如果多個卡片的這個屬性都設定為 true，它們之間的空間會被分割。 如需詳細資訊，請參閱了解資料表單版面配置。

其他屬性

BorderColor – 控制項框線的色彩。

BorderStyle – 決定控制項的邊框為實線、虛線、點線或無。

BorderThickness – 控制項邊框的粗細。

Fill – 控制項背景的色彩。

Height – 控制項的頂端和底部邊緣之間的距離。

Valid – 卡片或**編輯表單** 控制項是否包含可提交給資料來源的有效輸入項目。

Visible – 控制項顯示或隱藏。

X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。 對於具有多個資料行之容器中的**卡片** 控制項，這個屬性會決定卡片出現在哪一個資料行。

Y – 控制項頂部邊緣與其父容器 (沒有父容器時則為螢幕) 頂部邊緣之間的距離。 對於具有多個資料列之容器中的**卡片** 控制項，這個屬性會決定卡片出現在哪一個資料列。

範例

請參閱 了解資料卡 和 了解資料表單版面配置 以取得範例。

協助工具指南

色彩對比

以下項目之間必須有足夠的色彩對比：

• Fill 和任何子系控制項。 例如，如果卡片包含**標籤l**，且標籤有透明的填滿，則卡片的 Fill 會有效地成為標籤的背景色彩。 因此，卡片的 Fill 和標籤的 Color 之間應該有足夠的對比。

螢幕助讀程式支援

• DisplayName 必須存在。