視覺呈現：資料表

如果設為 True，系統會將包含 HTML 標記的儲存格格式格式化為 HTML。如果設為 False，多數自訂格式將無法正常運作。

決定是否要將交替顏色樣式指派給奇數或偶數列。

物件中，每個屬性名稱都描述一個表格元素，而屬性值是字串，用於定義要指派給該表格元素的類別。請使用這項屬性將自訂 CSS 指派給資料表中的特定元素。如要使用這項屬性，請指派物件 (屬性名稱會指定資料表元素)，而屬性值是字串，且指定要指派給該元素的類別名稱。然後，您必須針對網頁上的該類別定義 CSS 樣式。系統支援下列屬性名稱：

• headerRow - 為資料表標題列 (<tr> 元素) 指派類別名稱。
• tableRow - 為非標頭列 (<tr> 元素) 指派類別名稱。
• oddTableRow - 為奇數資料表資料列 (<tr> 元素) 指派類別名稱。注意： changenatingRowStyle 選項必須設為 true。
• selectedTableRow：為所選表格列 (<tr> 元素) 指派類別名稱。
• hoverTableRow - 為懸停錶格列 (<tr> 元素) 指派類別名稱。
• headerCell - 為標題列 (<td> 元素) 中的所有儲存格指派類別名稱。
• tableCell - 為所有非標頭表格儲存格 (<td> 元素) 指派類別名稱。
• rowNumberCell - 為列號欄中的儲存格 (<td> 元素) 指派類別名稱。注意：showRowNumber 選項必須設為 true。

範例： var cssClassNames = {headerRow: 'bigAndBoldClass',
hoverTableRow: 'highlightClass'};

注意：在 CSS 中，某些元素會覆寫其他元素。舉例來說，如果您為 <tr> 元素和 <td> 元素指定背景顏色，後者的優先順序高於前者。請務必在 cssClassNames 中指定所有相關的 CSS 樣式，以免發生衝突。

資料表中第一列的列數。只有在 showRowNumber 為 True 時才可使用。

左邊要凍結的欄數。水平捲動其餘資料欄時，這些資料欄將保持不變。如果 showRowNumber 為 false，則將 frozenColumns 設為 0 時，其顯示方式會與設為 null 相同，但如果 showRowNumber 設為 true，資料列編號欄就會凍結。

設定視覺元素容器的高度。您可以使用標準 HTML 單位 (例如「100px」、「80em」、「60」)。如未指定單位，系統會假設該數值為像素。如未指定，瀏覽器會自動調整表格大小以配合表格大小，在過程中會盡可能縮小；如果設定值小於所需的高度，表格就會新增垂直的捲軸 (標題列也會凍結)。如果設為「100%」，系統會盡可能將資料表展開到容器元素中。

是否允許透過分頁執行分頁。選擇下列其中一個字串值：

• 'enable' - 表格會包含下一頁和上一頁按鈕。只要按一下這些按鈕，就會執行分頁作業，並變更顯示的網頁。您也可以設定 pageSize 選項。
• 「event」：表格包含下一頁和上一頁按鈕，但按一下這些按鈕會觸發「page」事件，但不會變更顯示的頁面。當程式碼實作自己的網頁轉彎邏輯時，應使用這個選項。如需手動處理分頁事件的範例，請參閱 TableQueryWrapper 範例。
• 'disable' - [Default] 不支援分頁。
類型：字串
預設值：「disable」

使用分頁選項啟用分頁時，每個網頁的列數。

設定分頁按鈕的指定選項。選項如下：

• 「更換」：啟用 [上一個] 和 [下一個] 按鈕
• 「prev」：只啟用 [上一個] 按鈕
• 「next」：僅啟用下一個按鈕
• [自動]：根據目前的網頁啟用按鈕。只在第一頁顯示。最後一頁只會顯示上一張。否則兩者都會啟用。
• number - 要顯示的分頁按鈕數量。這個確切的數字會覆寫 pageSize 中的計算數字。

為反向輸入由右至左的語言 (例如阿拉伯文或希伯來文) 變更資料欄的排序順序，使資料欄 0 是最右欄，而最後一欄則為最左欄。這不會影響基礎資料中的資料欄索引，只有顯示順序的順序。即使採用這個選項，表格視覺化呈現還是不支援完整的雙向 (BiDi) 語言顯示功能。如果您啟用分頁 (使用頁面選項)，或者資料表含有捲軸，因為您指定的高度和寬度選項小於所需的資料表大小，系統會忽略這個選項。

設定您的水平捲動位置 (以像素為單位)，如果表格有水平捲軸，因為您已設定寬度屬性。表格會隨即開啟，其中最寬的像素會超出左側欄。

設為 true 時，將資料列編號顯示為表格的第一欄。

使用者點選欄標題時，該資料欄的排序方式和排序方式。如果已啟用排序功能，請考慮一併設定 sortAscending 和 sortColumn 屬性。請選擇下列其中一個字串值：

• 'enable' - [Default] 使用者可以按一下欄標題，按點擊的資料欄來排序。使用者按一下欄標題後，系統會自動排序列，並觸發「排序」事件。
• 「event」：使用者點擊欄標題時就會觸發「sort」事件，但系統不會自動排序資料列。如果網頁採用自己的排序方式，則應使用這個選項。如需手動處理排序事件的範例，請參閱 TableQueryWrapper 範例。
• 「disable」：按一下欄標題就不會有任何作用。

初始排序欄的排序順序。如果是遞增，傳回 True，表示遞減為 false。如未指定 sortColumn，系統會忽略這個屬性。

資料表中資料欄的初始索引，資料表在一開始是排序依據。此資料欄將標示一個用來表示排序順序的小箭頭。

第一個顯示的表格頁面。只有在 page 處於啟用/啟用模式時才會使用。

設定視覺元素容器元素的寬度。您可以使用標準 HTML 單位 (例如「100px」、「80em」、「60」)。如未指定單位，系統會假設該數值為像素。如未指定，瀏覽器會自動調整表格寬度以配合表格大小，在過程中會盡可能縮小；如果設定值小於所需的寬度，表格就會加入水平捲軸。如果設為「100%」，系統會盡可能將資料表展開到容器元素中。

繪製表格。

標準 getSelection 實作。選取元素皆為所有列元素。可傳回多個所選資料列。無論使用者互動 (排序、分頁等) 為何，選取物件中的資料列索引都會參照原始資料表。

請注意，選取項目切換設定：第一次點選儲存格時選取該儲存格；再按一下儲存格再次取消選取，就會產生選取事件，但不會在擷取的選取物件中選取任何項目。

呼叫這個方法，即可擷取已排序資料表目前排序狀態的相關資訊 (使用者通常藉由點選資料欄標題，按照特定資料欄排序資料列)。如果停用排序功能，此方法就無法運作。

如果您尚未在程式碼中排序資料，或使用者未透過選擇程式碼來排序資料，系統會傳回預設的排序值。

• column - (數字) 資料欄排序資料欄的索引。
• ascending - (如果遞增) 表示遞增，傳回 True；如果遞減，傳回 false。
• sortedIndexes - (數字陣列) 數字陣列，其中陣列的索引是排序的列號 (在可見的資料表中)，值則是基礎 (未排序) 資料表中該資料列的索引。

標準 setSelection() 實作，但只能選取整個資料列或多個資料列。無論使用者互動 (排序、分頁等) 為何，選取物件中的資料列索引都會參照原始資料表。

清除圖表並釋出其分配的所有資源。

標準選取事件，但只能選取整列。

在使用者點選網頁導覽按鈕時觸發。

在使用者按一下欄標題時觸發，排序選項則為 [停用]。

• column - (數字) 資料欄排序資料欄的索引。
• ascending - (如果遞增) 表示遞增，傳回 True；如果遞減，傳回 false。
• sortedIndexes - (數字陣列) 數字陣列，陣列中的索引是排序後顯示的資料列編號 (在可見資料表中)，值則是基礎 (未排序) 資料表中該資料列的索引。

圖表可供外部方法呼叫使用。如果您想要與圖表互動，並在繪製後呼叫方法，請先為這個事件設定事件監聽器，然後再呼叫繪圖方法，並且只在事件觸發後呼叫這些方法。