SmartField 控制元件解釋表示 OData 服務中的實體關係模型、資料型別、服務功能和註釋的後設資料，以自動生成`底層內部控制元件`並減少開發應用程式所需的程式碼量。在某些情況下，OData 實體派生自控制元件的繫結上下文。隨控制元件更改或顯示的 OData 實體的屬性派生自控制元件的 value 屬性。

重要提示：SmartField 與所有 SAPUI5 智慧控制元件一樣，會檢索和分析 OData 服務的後設資料和註釋。 OData 後設資料是其主要 API。這些 OData 服務不是 SAPUI5 框架的一部分，通常由應用程式的後端開發人員維護。

隨著時間的推移，SmartField 可以發展並獲得新功能。這意味著如果定義此更改的註釋保留在後端後設資料中，則其行為或功能可能會更改。要從新功能中受益，SAP UI5 應用程式應該能夠適應後端後設資料。因此，SAP 建議僅當開發人員可以完全控制應用程式的後設資料時，才使用 SmartField.

# Accessibility

出於互操作性和可訪問性的原因，SmartField 控制元件必須由 sap.ui.comp.smartfield.SmartLabel 控制元件而不是 sap.m.Label 控制元件標記，因為 sap.m.Label 控制元件不知道內部結構 一個 SmartField 控制元件。 如果 SmartField 控制元件呈現在智慧容器控制元件（例如 SmartForm 控制元件）中，則會自動生成 SmartLabel 控制元件以減少應用程式端所需的程式碼量。 但是，在其他情況下，當 SmartField 單獨使用或在智慧容器控制元件之外使用時，例如 SimpleForm 控制元件，在這些情況下不會自動生成 SmartLabel 控制元件。 儘管 sap.ui.comp.smartfield.SmartLabel 是私有/內部控制元件，但應用程式允許以下基本用途用於標記 SmartField 控制元件。

一個例子：

```xml
<sap.ui.comp.smartfield.smartlabel labelfor="IDProduct"></sap.ui.comp.smartfield.smartlabel>
<sap.ui.comp.smartfield.smartfield id="IDProduct" value="{ProductId}"></sap.ui.comp.smartfield.smartfield>
```

不建議單獨使用 SmartLabel 控制元件。 只允許基本使用，不包括自動處理可見性。 如果單獨使用，應用程式邏輯必須注意標籤的可見性。

# FieldControl

定義欄位是強制的、隱藏的還是處於只讀/可編輯模式。

實體資料模型 (EDM) 屬性可以使用 OData V4 模型中的 com.sap.vocabularies.Common.v1.FieldControl 註釋或 OData V2 模型中的 sap:field-control 註釋動態註釋，方法是提供到另一個屬性的繫結路徑型別為 Edm.Byte 的 EDM 屬性，其在資料模型中的值可以是：

- 0：表示該欄位已隱藏。注意： Hidden 是不適用的同義詞，不推薦使用，不要使用它來靜態隱藏使用者介面上的欄位，而是使用靜態 FieldControl 註釋。

- 1：表示該欄位處於只讀模式，其值不能更改。注意：要將 EDM 屬性靜態註釋為只讀，請改用 Org.OData.Core.V1.Computed 註釋。

- 3：表示該欄位是可編輯的和可選的（預設）。

- 7：表示從業務角度來看該欄位是強制性的。此值並不意味著對 EDM 屬性的值範圍有任何限制。例如，為了限制值範圍的使用，必須使用值為 false 的標準型別 facet Nullable 來排除空值，或者必須使用 Org.OData.Validation.V1 詞彙表中的術語。

什麼是 SAP UI5 的 Smart Field

相關文章