欄包含模型導向應用程式表單或方格中的資料。 使用 formContext.data.entity.attributes 集合或 formContext.getAttribute 快捷方式方法來存取資料行集合。 如需集合的詳細資訊,請參閱集合 (用戶端 API 參考)。
要存取集合中的欄位,將欄位名稱(字串)或索引值(編號)作為參數傳遞給方法。 例如: formContext.getAttribute(arg) 。 如果你沒有指定參數,方法會回傳表單上所有屬性的集合。
欄會依類型分類。 使用 getAttributeType 方法來判斷欄位的類型。 某些資料行方法僅適用於特定類型的資料行。
本文提供每種欄位類型可用的方法資訊。
所有資料行類型
以下方法適用於所有欄位類型:
| Method | Description |
|---|---|
| addOnChange | 新增一個函式,當欄位事件發生時 OnChange 執行。 |
| fireOnChange | 觸發該欄位 OnChange 的事件。 |
| get屬性類型 | 回傳欄位的類型。 |
| get格式 | 回傳該欄的格式。 |
| getIs骯髒 | 回傳欄位是否有未儲存的變更。 |
| 取得名稱 | 回傳欄位的邏輯名稱。 |
| getParent | 回傳父 formContext.data.entity 物件。 |
| getRequiredLevel | 回傳欄位值是否需要或建議。 |
| get提交模式 | 當該欄位的資料在儲存時會回傳。 |
| getUserPrivilege | 回傳使用者建立、讀取或更新欄位值的權限。 |
| get值 | 回傳欄位的資料值。 |
| 是有效 | 回傳該欄位值是否有效。 |
| removeOnChange | 移除欄位事件處理程序中的 OnChange 一個函式。 |
| setIs有效 | 設定欄位的有效性及錯誤訊息。 |
| setRequiredLevel | 設定儲存前是否需要或建議欄位值。 |
| setSubmitMode | 設定欄位資料是否在儲存時提交。 |
| 設定值 | 設定欄位的資料值。 |
布林欄類型
除了所有欄位類型可用的方法外, 布林 欄位類型還提供以下方法:
| Method | Description |
|---|---|
| get初始值 | 回傳表單開啟時欄位的值。 |
查閱資料行類型
除了所有欄位類型可用的方法外, 查找 欄位類型還提供以下方法:
| Method | Description |
|---|---|
| getIsPartyList | 回傳查詢是否允許多筆紀錄作為政黨名單查詢。 |
選擇和選擇欄類型
除了所有欄位類型可用的方法外, 選擇 欄位與 選擇 欄位類型還提供以下方法:
| Method | Description |
|---|---|
| get初始值 | 回傳表單開啟時欄位的值。 |
| get選項 | 回傳與指定標籤或值相符的選項。 |
| get選項 | 回傳該欄位的有效選項。 |
| getSelected選項 | 回傳所選選項。 |
| getText | 回傳所選選項的文字。 |
數字欄類型(十進位、雙精度、整數、貨幣)
下列方法僅適用於 十進位、 雙精度和 整數 資料行:
| Method | Description |
|---|---|
| getMax | 回傳該欄位的最大允許值。 |
| getMin | 回傳該欄位的最小允許值。 |
| get精度 | 回傳小數點後允許的數字數。 |
| 設定精確度 | 設定小數點後允許的數字數。 |
字串資料行類型
除了先前說明適用於所有資料行類型的方法之外,下列方法僅適用於 字串 資料行:
| Method | Description |
|---|---|
| getMax長度 | 回傳該欄的最大字串長度。 |