初探PivotTable.js（二）
阿新 • • 發佈：2022-03-14
PivotTable.js的引數
PivotTable主要有兩個呼叫函式：pivot() 和pivotUI() ，注意，這兩個函式接收的引數並不完全一樣。
pivot() 的引數：input [,options [,locale]]
pivot()可以在input物件中根據options選項生成一個html表格。
- input：包含物件的陣列、包含陣列的陣列、jquery的dom物件、或者function。
- locale：本地化語言包配置。
- options：配置項，具體如下。
| key | 型別 | 預設值 | 描述 |
| rows | [ "string" ] | [] | 設定為行的欄位 |
| cols | [ "string" ] | [] | 設定為列的欄位 |
| aggregator | function | $.pivotUtilities .aggregators["Count"]() | 總計的計算方法 |
| aggregatorName | string | "Count" | 總計的名稱 |
| renderer | function | table() | 生成表格的方法 |
| rowOrder | string | "key_a_to_z" | 行的排列方式： "key_a_to_z"、 "value_a_to_z"、 "value_z_to_a" |
| colOrder | string | "key_a_to_z" | 列的排列方式，同上。 |
| derivedAttributes | object of functions | {} | 派生屬性 |
| dataClass | function | $.pivotUtilities.PivotData | 不祥，待完善 |
| filter | function | function(){return true;} | 自定義的過濾方法 |
| sorters | object or function | {} | 自定義排序名稱和排序方式 |
| rendererOptions | object | {} | 渲染表格配置 |
| localeStrings | string |
en |
本地化(語言包)配置 |
pivotUI() 的引數：input [,options [,overwrite [,locale]]]
- input：同上。
- locale：同上。
- overwrite：布林值，控制資料更新時UI狀態是否改變，true-覆蓋當前狀態，false-UI狀態保持不變，預設false。
- options：配置項，具體如下。
| key | 型別 | 預設值 | 描述 |
| rows | array of strings | [] | 同上 |
| cols | array of strings | [] | 同上 |
| vals | array of strings | [] | 值區域中預先填充的欄位 |
| aggregators | object of functions | $.pivotUtilities.aggregators | 同上 |
| aggregatorName | string | aggregators的第一個key |
同上 |
| renderers | object of functions | $.pivotUtilities.renderers | 表格渲染方法的集合 |
| rendererName | string | renderers的第一個key | 渲染選項的下拉列表 |
| rowOrder | string | "key_a_to_z" | 同上 |
| colOrder | string | "key_a_to_z" | 同上 |
| derivedAttributes | object of functions | {} | 同上 |
| dataClass | function | $.pivotUtilities.PivotData | 不詳，待完善 |
| filter | function | function(){return true;} | 同上 |
| inclusions | object of arrays of strings | {} | 不詳，待完善 |
| exclusions | object of arrays of strings | {} | 不詳，待完善 |
| hiddenAttributes | array of strings | [] | 忽略的欄位 |
| hiddenFromAggregators | array of strings | [] | 忽略的總計的計算方法 |
| hiddenFromDragDrop | array of strings | [] | 拖拽時的忽略的欄位 |
| sorters | object or function | {} | 同上 |
| onRefresh | function | function(){} | UI更新時觸發的方法 |
| menuLimit | integer | 50 | 雙擊選單的最大選單數量 |
| autoSortUnusedAttrs | boolean | false | 是否在UI中保留未使用的屬性 |
| unusedAttrsVertical | boolean or integer | 85 | 垂直顯示/水平顯示 |
| showUI | boolean | true | 控制是否顯示拖放UI |
| rendererOptions | object | {} | 同上 |
| localeStrings | object | en | 同上 |