## addColumn('字段名', '標題', '類型' [, '默認值', '額外參數', 'css類名']) | 版本 | 新增功能 | | --- | --- | | 1.0.2 | 支持用`__字段名__`獲取字段原值 | | 1.0.5 | 新增索引編號顯示__INDEX__ | | 參數 | 含義 | 類型 | | --- | --- | --- | | name | 字段名 | string | | title | 標題 | string | | type | 類型 | string | | default | 默認值 | string | | param | 額外參數 | string | | class | css類名 | string | ### 小例子 給數據表格添加一列，一般只需用到兩個參數，`字段名`和`標題`。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('username', '用戶名') ->fetch(); ~~~ 效果：  再多添加幾列 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->fetch(); ~~~ 效果：  ### 設置數據 為了演示方便，我們給表格添加點數據，這些數據是從數據庫讀取出來的，后面會講到。 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 效果：  ### 類型 默認情況下，添加的列都是以純文本顯示的，如果是一些特殊格式，比如日期時間、可編輯文本等，那么可以給字段指定類型，系統會自動處理。 比如上面的“創建時間”，從數據庫取出來是時間戳，顯示的時候，我們想把他格式化一下，那么可以給這個字段指明類型為`datetime`。 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間', 'datetime') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 效果：  >[info] 額外參數和默認值這兩個參數會根據不同類型，含義有所不同，詳情請看后面的章節 #### 獲取原值 有時候，可能某個字段需要用到兩次，比如： ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間', 'datetime') ->addColumn('create_time', '創建時間', 'datetime') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 這樣的話，時間顯示會錯誤，其他字段也同樣，如果使用兩次，可能會出現數據不正確的問題。當然，如果沒有用到“類型”來處理字段值就不會顯示錯誤。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->addColumn('create_time', '創建時間') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 出現這種情況的原因是，之前的`create_time`指定了類型為“datetime”，等于把`create_time`進行了格式化，然后第二次用`create_time`時，就不再是時間戳，而是第一個`create_time`格式化后的，自然就格式化錯誤了。 如果需要第二次使用`create_time`，可以用`__update_time__`代替，其他字段也是如此。 >[info] ### 1.0.7版本之后，無需使用`__字段名__`的形式，而是直接使用字段名。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumns([ // 批量添加列 ['id', 'ID'], ['username', '用戶名'], ['nickname', '昵稱'], ['email', '郵箱'], ['mobile', '手機號'], ['status', '狀態', 'switch'], ['status', '狀態'], ['create_time', '創建時間', 'datetime'] ]) ->fetch(); ~~~  第一個`status`字段指定了類型為`switch`，所以以開關的形式展示，第二個`status`字段沒有指定類型，所以輸出原值。也可以指定其他類型，比如： ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumns([ // 批量添加列 ['id', 'ID'], ['username', '用戶名'], ['nickname', '昵稱'], ['email', '郵箱'], ['mobile', '手機號'], ['status', '狀態', 'switch'], ['status', '狀態', 'status'], ['create_time', '創建時間', 'datetime'] ]) ->fetch(); ~~~  ### css類名 如果想設置某一列劇中顯示，可以添加css類名`text-center`。 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID', '', '', '', 'text-center') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 也可以添加多個css類名 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID', '', '', '', 'text-center my-class') ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ >[info]提示：從1.0.2版本開始，表格的每個列表頭增加了一個類名，方便使用css進行控制。類名為：column-列名 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID', '', '', '', 'text-center my-class') ->setRowList($data_list) // 設置表格數據 ->css('style') // 引入自定義的css文件 ->fetch(); ~~~ style.css內容如下： ~~~ /*設置id列的寬度*/ .column-id{ min-width: 100px; } ~~~ ### 索引編號 >[info] 1.0.5版本開始支持 如果希望增加索引編號顯示，可以添加`__INDEX__`字段，比如： ~~~ ->addColumn('__INDEX__', '#') ~~~ 那么表格會顯示從1開始的索引編號。