## autoAdd('表單項' [, '表名', '驗證器名', '自動插入時間戳', '時間格式', '是否彈窗']) | 版本 | 功能 | | --- | --- | | 1.0.5 | 支持彈窗 | 如果用`addTopButton('add')` 來添加”新增“按鈕，那么新增的方法需要自己實現，也就是在當前控制器下，新建一個add方法來創建表單，并且寫入數據。 追求極簡的開發是**DolphinPHP**的核心思想之一，為了節省開發者的寶貴時間，我們為大家準備了一個神奇的方法，可以讓開發者無需編寫add方法也能實現創建表單和寫入數據。 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 定義新增頁面的字段 $fields = [ ['text', 'username', '用戶名', '必填，可由英文字母、數字組成'], ['text', 'nickname', '昵稱', '可以是中文'], ['select', 'role', '角色', '', RoleModel::getTree(null, false)], ['text', 'email', '郵箱', ''], ['password', 'password', '密碼', '必填，6-20位'], ['text', 'mobile', '手機號'], ['image', 'avatar', '頭像'], ['radio', 'status', '狀態', '', ['禁用', '啟用'], 1] ]; // 使用ZBuilder構建數據表格 return ZBuilder::make('table') ->addColumn('id', 'ID') ->addColumn('username', '用戶名') ->addColumn('nickname', '昵稱') ->addColumn('email', '郵箱') ->addColumn('mobile', '手機號') ->addColumn('create_time', '創建時間') ->addColumn('right_button', '操作', 'btn') ->autoAdd($fields) // 添加新增按鈕 ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ 就這么簡單，點擊頁面上的”新增“按鈕，就添加數據了。 ### 表單項 表單項是一個數組，每個元素表示一個字段數據，具體用法可以參考[添加表單項通用方法](添加表單項通用方法.md)。 ### 表名 如果你的數據表名是`當前模塊名_當前控制器名`，那么無需填寫這個參數。假如不是，那么需要填寫對應的表名，比如： ~~~ ->autoAdd($fields, 'admin_user') ~~~ ### 驗證器名 如果新增數據的時候，需要用到驗證器，那么可以填寫驗證器名，如果不需要用到驗證器，那么可以不寫或者填寫空值。 默認情況下，填寫`true`的話，系統會去使用驗證器名為**當前控制器名**的驗證器。比如當前控制器是Index，那么就會去調用Index驗證器。 ~~~ ->autoAdd($fields, 'admin_user', true) ~~~ 如果不填寫，那么提交表單的時候，則不會驗證數據，而是直接寫入數據。 也可以指定驗證器名 ~~~ ->autoAdd($fields, 'admin_user', 'User') ~~~ ### 自動插入時間戳 如果新增數據的時候想自動插入創建時間和更新時間，那么可以這樣寫 ~~~ ->autoAdd($fields, 'admin_user', 'User', true) ~~~ 提交表單的時候，DolphinPHP會自動添加當前**時間戳**到字段名為`create_time`和`update_time`的字段中。 >[danger] 前提是表中有這個兩個字段。 如果只想寫入其中一個字段，比如create_time，那么可以這樣寫 ~~~ ->autoAdd($fields, 'admin_user', 'User', 'create_time') ~~~ 或者干脆兩個都指明 ~~~ ->autoAdd($fields, 'admin_user', 'User', 'create_time,update_time') ~~~ 如果表中的時間字段不是`create_tiem`而是其他，比如`create_at`，那么也可以直接寫 ~~~ ->autoAdd($fields, 'admin_user', 'User', 'create_at') ~~~ 當然，也可以利用表單項的`hidden`類型來添加，比如 ~~~ // 定義新增頁面的字段 $fields = [ ['text', 'username', '用戶名', '必填，可由英文字母、數字組成'], ['text', 'nickname', '昵稱', '可以是中文'], ['select', 'role', '角色', '', RoleModel::getTree(null, false)], ['text', 'email', '郵箱', ''], ['password', 'password', '密碼', '必填，6-20位'], ['text', 'mobile', '手機號'], ['image', 'avatar', '頭像'], ['radio', 'status', '狀態', '', ['禁用', '啟用'], 1], ['hidden', 'create_time', $this->request->time()], ['hidden', 'update_time', $this->request->time()] ]; ~~~ >[info] 如果在添加數據前需要復雜處理的，建議自己創建add方法 ### 自定義時間格式 從`1.0.3`版本開始，支持自定義時間字段的格式，默認為時間戳，如果想以普通時間格式存儲的話，可以這樣指定。 ~~~ ->autoAdd($fields, 'admin_user', 'User', true, 'Y-m-d') ~~~ 那么添加數據的時候，會自動添加create_time字段和update_time字段，它們的格式為：`Y-m-d`. 或者單獨對某個字段的格式進行指定。 ~~~ ->autoAdd($fields, 'admin_user', 'User', 'create_time|Y-m-d') // create_time字段寫入的時間格式為Y-m-d ~~~ 沒有指定時間格式的字段，將默認為時間戳格式 ~~~ ->autoAdd($fields, 'admin_user', 'User', 'create_time|Y-m-d,update_time') ~~~ `create_time`字段寫入的時間格式為`Y-m-d`，而`update_time`為時間戳。 如果指定了時間格式，那么沒有明確指定格式的字段，將統一使用后面指定的格式。 ~~~ ->autoAdd($fields, 'admin_user', 'User', 'create_time|Y-m-d,update_time,log_time', 'Y/m/d H:i') ~~~ `create_time`字段寫入的時間格式為`Y-m-d`，而`update_time`和`log_time`的格式為`Y/m/d H:i`。 ### 是否彈窗 >[info] 從1.0.5版本開始，支持設置為彈窗 ~~~ ->autoAdd($fields, 'admin_user', 'User', '', '', true) ~~~