控制項代表表單上存在的 HTML 元素。 某些控制項系結至特定資料行,而其他控制項可能代表未系結的控制項,例如 IFRAME、Web 資源或新增至表單的子格線。
控制項物件提供方法來變更控制項的呈現或行為,並識別對應的資料行。 您可以使用下列其中一個集合來存取控制項:
- formContext.ui.controls
- formContext.ui 區段.controls
- formContext.data.entity屬性.controls
formContext。getControl方法是一種存取formContext.ui.controls.get的捷徑方法。
控制項會依類型分類。 您可以使用 getControlType 方法來判斷控制項的類型。 某些控制方法僅適用於特定類型的控制項。
本文提供每個控制項類型可用方法的相關資訊。
標準控制類型
這些是標準控制項可用的方法。
在此版本中,已 取代 下列標準控制項的方法: addOnKeyPress、 fireOnKeyPress和 removeOnKeyPress。
IFRAME 控制類型
這些方法適用於 IFRAME 控制項。
Kbsearch (知識庫搜尋) 控制項類型
這些方法可用於知識庫搜尋控制。
備註
將知識庫搜尋控制項新增至社交窗格時,控制項的名稱會為 searchwidgetcontrol_notescontrol。 此名稱無法變更。
查閱控制項類型
這些方法可用於查閱控制項。
選擇和選擇控制類型
選擇和選擇控制項都有相同的方法集可用。
Quickform 控制項類型
如需此控制項型別支援方法的相關資訊,請參閱 formContext.ui.quickForms 。
子格控項類型
請參閱 格線和子格線, 以取得此控制項類型支援的資訊方法。
時間軸牆控制項類型
時間表控制項會在統一檢視中呈現貼文、活動和附註。 這些方法適用於此控制項類型。
定時器控制類型
這些方法可用於計時器控制。
Web 資源控制類型
Web 資源控制項具有與 iframe 控制項相同的方法集。 請參閱 iframe 控制項類型
Silverlight Web 資源具有以下額外方法:
小提示
如果您想要修改繫結至表單上欄的所有控制項,請使用欄類型內的控制項集合。 例如,若要將通知新增至繫結至 name 資料行的每個控制項,您可以執行下列動作:
const notification = { messages: ['Sample Notification on Name Controls'], notificationLevel: 'RECOMMENDATION', uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));
表單元件控制類型
表單元件控制項型別具有與主要表單上的 formContext 相同的方法集。 請參閱 表單元件行為 > 使用者端API