共用方式為


資料行 OnChange 事件 (用戶端 API 參考)

事件 OnChange 發生在下列情況下:

  • 表單欄中的資料已變更,焦點遺失。 此行為有一個例外狀況,適用於格式化為使用選項按鈕或核取方塊的「是/否」資料行。 在這些情況下,事件會立即發生。
  • 當重新整理表單時,會擷取伺服器上的資料變更以更新直欄,例如在儲存記錄之後。
  • 使用 attribute.fireOnchange 方法。

所有欄都支援該 OnChange 事件。 資料行中的資料會在事件發生 OnChange 之前和之後進行驗證。

如果使用 attribute.setValue 方法以程式設計方式變更直欄,則不會發生此OnChange事件。 如果您想要在設定值formContext.data.entity attribute.之後執行事件的OnChange事件處理常式,您必須在程式碼中使用 fireOnchange 方法。 如果使用者正在離開已變更表單,則在捨棄變更時以程式設計方式變更資料行,也不會發生此 OnChange 事件。

備註

雖然 [狀態] 資料行支援事件OnChange ,但該資料行在表單上是唯讀的,因此事件無法透過使用者互動發生。 另一個腳本可能會在資料行上使用 fireOnchange 方法,導致發生此事件。

備註

OnChange 事件是同步的。 您 應該在事件處理常式中使用 OnChange 非同步程式碼,因為事件處理常式需要在非同步程式碼的解析時採取或處理動作。 如果解析處理常式預期應用程式內容與啟動非同步程式碼時相同,這會導致問題。 您 也不應該 在 OnChange 事件處理常式中提出同步網路要求。 這可能會導致應用程式無回應。

此事件支援的方法

您可以使用三種方法來處理 OnChange 資料行的事件:

資料行 (用戶端 API 參考)
事件 (用戶端 API 參考)
模型導向應用程式中表單與網格的事件