## 回調方法 如果某些字段的值需要特別處理，可以設置回調方法。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', 'format_time') ->fetch(); ~~~ 回調有以下幾種用法 ### 1.輸入有效的函數 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', 'format_time') ->fetch(); ~~~ 其中`format_time`是一個有效的函數。 >[info] 系統默認會將該字段值傳入到指定的回調方法內 也可以添加額外參數 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', 'format_time', 'Y-m-d') ->fetch(); ~~~ 其中，'Y-m-d'會被當作第二參數傳入函數`format_time`內。 額外參數也可以是一個變量。 ~~~ $format = 'Y-m-d'; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', 'format_time', $format) ->fetch(); ~~~ ### 2.使用匿名函數 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', function($value){ return format_time($value); }) ->fetch(); ~~~ >[danger] 使用匿名函數時，可以定義一個參數來接收字段值。該匿名函數要有返回值，否則頁面不顯示該字段的值。 也可以不接收字段值，而直接返回數據。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', function(){ return '禁止查看'; }) ->fetch(); ~~~ 匿名函數同樣可以接收第二個參數 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', function($value, $format){ return format_time($value, $format); // $format 在這里的值是“Y-m” }, 'Y-m') ->fetch(); ~~~ >[info] 提示：如果額外參數是`__data__`，則會把整行數據當做第二個參數傳給回調方法 比如我們希望在create_time的回調方法內，能接收到其他字段的值。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('name', '用戶名') ->addColumn('create_time', '創建時間', 'callback', function($value, $data){ return $data['name']; // 可以用$data接收到其他字段的數據 }, '__data__') ->fetch(); ~~~ ### 3.以數組方式輸入對象和方法 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', [$this, 'format_time']) // 表示執行當前對象的format_time方法，并將值傳入format_time方法中 ->fetch(); ~~~ 也可以傳入額外參數 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', [$this, 'format_time'], 'Y-m') ->fetch(); ~~~ 或者傳入變量 ~~~ $format = 'Y-m'; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', [$this, 'format_time'], $format) ->fetch(); ~~~ >[info] 建議不要在回調方法內去查詢數據庫，這樣會造成頻繁訪問數據庫 ### 支持傳入任意個參數（1.0.3+） 從1.0.3版本開始，“callback”支持傳入任意個參數。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', function($value, $a, $b, $c){ // $value 字段create_time的值 // $a的值為“參數1” // $b的值為“參數2” // $c的值為“參數3” }, '參數1', '參數2', '參數3') ->fetch(); ~~~ `__data__`可以放在任意位置。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_time', '創建時間', 'callback', function($value, $a, $b, $c){ // $value 字段create_time的值 // $a的值為“參數1” // $b的值為“參數2” // $c的值為當前行的所有字段值 }, '參數1', '參數2', '__data__') ->fetch(); ~~~ >[info]如果某些字段是不存在的，使用callback時，無需接收該字段的變量。 ~~~ // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('create_at', '創建時間', 'callback', function($data){ // create_at字段是不存在的，所以匿名函數的不用再定義一個$value變量來接收值 }, '__data__') ->fetch(); ~~~