共用方式為


控制項 (用戶端 API 參考)

控制項代表表單上存在的 HTML 元素。 某些控制項系結至特定資料行,而其他控制項可能代表未系結的控制項,例如 IFRAME、Web 資源或新增至表單的子格線。

控制項物件提供方法來變更控制項的呈現或行為,並識別對應的資料行。 您可以使用下列其中一個集合來存取控制項:

  • formContext.ui.controls
  • formContext.ui 區段.controls
  • formContext.data.entity屬性.controls

formContextgetControl方法是一種存取formContext.ui.controls.get的捷徑方法。

控制項會依類型分類。 您可以使用 getControlType 方法來判斷控制項的類型。 某些控制方法僅適用於特定類型的控制項。

本文提供每個控制項類型可用方法的相關資訊。

標準控制類型

這些是標準控制項可用的方法。

 

在此版本中,已 取代 下列標準控制項的方法: addOnKeyPressfireOnKeyPressremoveOnKeyPress

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

Columns