模型導向應用程式中的方格和子方格 (用戶端 API 參考)

格子格以表格形式呈現模型驅動應用程式中的資料。 請使用本文中的客戶端 API 事件與物件,來處理唯讀且可編輯的網格。 方格可以跨越整個表單,也可以是表單上的其中一個項目;後者稱為 子網格。

網格類型

模型導向應用程式中有兩種類型的方格:

  • 唯讀方格:以表格式顯示資料。 若要編輯唯讀方格中顯示的資料,您必須選取方格中的記錄以開啟表單、編輯資料,然後儲存。
  • 可編輯網格:除了以表格形式顯示資料外,還在網頁與行動用戶端提供豐富的內嵌編輯功能,包括在同一網格內分組、排序及篩選資料,讓您無需切換紀錄或檢視。 可編輯方格是自訂控制項,在 Web 用戶端的表單上的主要方格和子方格中,以及行動用戶端的儀表板和表單方格上都受支援。 雖然可編輯的網格控制項提供編輯功能,但它會遵循唯讀網格的中繼資料和欄位層級安全性設定。

取得格網上下文

方格內容是您要針對其執行程式碼的表單上的方格或子方格執行個體。 欲了解更多關於如何取得格狀上下文以執行 JavaScript 程式碼的資訊,請參閱 Client API 格狀上下文。

起跑格賽事

名稱 Description 適用於
子網格 OnLoad 事件 每次子格重新整理時都會發生。 此事件包括使用者點擊欄位標題來排序子格子欄位時的值。 唯讀方格
網格變更 當可編輯格點中儲存格中的值變更,且儲存格失去焦點時發生 可編輯的格線
格線 OnRecordSelect 在可編輯格線中選取單一列 (記錄) 時發生 可編輯的格線
網格 OnSave 發生在將更新資訊傳送至伺服器之前,且發生以下任一情況時:記錄選擇有變更、使用者透過可編輯網格的儲存按鈕明確觸發儲存操作,或在有待處理變更時,使用者從可編輯格線套用排序、篩選、分組、分頁或導航操作。 可編輯的格線

備註

你可以透過使用模型驅動應用程式頁面的事件標籤,註冊 OnChange、OnRecordSelect 和 OnSave 事件,該標籤可啟用可編輯的表格或唯讀網格。

格網物件

使用下列物件與格線互動。 這些物件會形成階層,如下圖所示:

以下為網格與子網格中可用的客戶端 API 物件階層結構截圖。

名稱 Description 適用於
網格控制 提供使用方格或子方格控制項的方法。 唯讀和可編輯的方格
網格 提供存取網格中資料相關資訊的方法。 唯讀和可編輯的方格
網格列 提供處理格線中列或選取列的方法。 唯讀和可編輯的方格
GridRowData 提供處理格線中列或選取列的方法。 唯讀和可編輯的方格
網格實體 提供存取資料列中特定記錄相關資料的方法。 唯讀和可編輯的方格
GridAttribute 提供存取可編輯格線儲存格中資料的方法。 可編輯的格線
網格單元 提供方法來存取與表單控制項相關的資料,這些表單是繫結至可編輯方格中欄的表單。 可編輯的格線
ViewSelector 提供取得或設定子格控制項檢視選取器的相關資訊的方法。 唯讀方格

用戶端 API 網格內容
使用可編輯的格線
模型導向應用程式的用戶端 API 參考
模型驅動應用程式開發指南