## raw('字段名') 在創建數據表格時，如果數據是由模型獲取的，且模型中定義了修改器和獲取器，那么獲取器會起作用，而修改器不起作用。 假設User模型定義了獲取器和修改器，以下代碼僅作為演示，不需要深究為什么這么寫。 ~~~ // username字段的獲取器 public function getUsernameAttr($v) { return '用戶：'.$v; } // username字段的修改器 public function setUsernameAttr() { return 123; } ~~~ 創建數據表格 ~~~ // 數據列表 $data_list = User::where($map)->order('sort,id desc')->paginate(); // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setTableName('admin_user') // 設置數據表名 ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱']) // 設置搜索參數 ->addColumns([ // 批量添加列 ['id', 'ID'], ['username', '用戶名'], ['nickname', '昵稱'], ['nickname', '昵稱', 'text.edit'], ['email', '郵箱'], ['mobile', '手機號'], ['create_time', '創建時間', 'datetime'], ['status', '狀態', 'switch'], ['right_button', '操作', 'btn'] ]) ->addTopButtons('add,enable,disable,delete') // 批量添加頂部按鈕 ->addRightButton('custom', $btn_access) // 添加授權按鈕 ->addRightButtons('edit,delete,enable,disable') // 批量添加右側按鈕 ->setRowList($data_list) // 設置表格數據 ->fetch(); // 渲染頁面 ~~~  可以看到，由于$data_list使用自定義模型查詢的，而且定義了獲取器，所以最終顯示的用戶名，前面會顯示‘用戶：’。 ### 使用原值顯示 有時候，雖然模型中定義了獲取器，但我們不希望使用獲取器，而是使用字段的原值來顯示，或者使用原值來處理數據，那么就需要用到raw()方法，指定某個字段或某些字段使用原值。 ~~~ // 數據列表 $data_list = User::where($map)->order('sort,id desc')->paginate(); // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setTableName('admin_user') // 設置數據表名 ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱']) // 設置搜索參數 ->addColumns([ // 批量添加列 ['id', 'ID'], ['username', '用戶名'], ['nickname', '昵稱'], ['nickname', '昵稱', 'text.edit'], ['email', '郵箱'], ['mobile', '手機號'], ['create_time', '創建時間', 'datetime'], ['status', '狀態', 'switch'], ['right_button', '操作', 'btn'] ]) ->raw('username') // 使用原值 ->addTopButtons('add,enable,disable,delete') // 批量添加頂部按鈕 ->addRightButton('custom', $btn_access) // 添加授權按鈕 ->addRightButtons('edit,delete,enable,disable') // 批量添加右側按鈕 ->setRowList($data_list) // 設置表格數據 ->fetch(); // 渲染頁面 ~~~ 由于定義了`->raw('username')`，最終表格上顯示的username字段值將不會再經過獲取器，而是直接顯示原值。 ### 設置多個字段使用原值 ~~~ ->raw('username,nickname') 或者使用數組 ->raw(['username', 'nickname']) ~~~ ### 使用不存在的字段 如果模型中定義了獲取器，并且該字段本身是不存在的，那么也需要用`raw()`方法設置，才能正常顯示。 ~~~ // username字段的獲取器 public function getUsernameAttr($v) { return '用戶：'.$v; } // 定義一個不存在的字段獲取器 public function getTestAttr() { return 123; } ~~~ ~~~ // 數據列表 $data_list = User::where($map)->order('sort,id desc')->paginate(); // 使用ZBuilder快速創建數據表格 return ZBuilder::make('table') ->setTableName('admin_user') // 設置數據表名 ->setSearch(['id' => 'ID', 'username' => '用戶名', 'email' => '郵箱']) // 設置搜索參數 ->addColumns([ // 批量添加列 ['id', 'ID'], ['username', '用戶名'], ['nickname', '昵稱'], ['test', '測試'], ['nickname', '昵稱', 'text.edit'], ['email', '郵箱'], ['mobile', '手機號'], ['create_time', '創建時間', 'datetime'], ['status', '狀態', 'switch'], ['right_button', '操作', 'btn'] ]) ->raw('test') // 使用原值 ->addTopButtons('add,enable,disable,delete') // 批量添加頂部按鈕 ->addRightButton('custom', $btn_access) // 添加授權按鈕 ->addRightButtons('edit,delete,enable,disable') // 批量添加右側按鈕 ->setRowList($data_list) // 設置表格數據 ->fetch(); // 渲染頁面 ~~~