## autoEdit('表單項' [, '表名', '驗證器名', '自動插入時間戳', '時間格式', '是否彈窗']) | 版本 | 功能 | | --- | --- | | 1.0.5 | 支持彈窗 | 和[自動添加按鈕](自動添加按鈕.md)用法相類似 ~~~ // 讀取用戶數據 $data_list = Db::name('admin_user')->select(); // 定義新增或編輯頁面的字段 $fields = [ ['hidden', 'id'], ['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) // 添加新增按鈕 ->autoEdit($fields) // 添加編輯按鈕 ->setRowList($data_list) // 設置表格數據 ->fetch(); ~~~ >[danger]需要注意的是，編輯需要用到主鍵字段，一般會設置為隱藏，比如上面的`['hidden', 'id']` ### 表單項 表單項是一個數組，每個元素表示一個字段數據，具體用法可以參考[添加表單項通用方法](添加表單項通用方法.md)。 ### 表名 如果你的數據表名是`當前模塊名_當前控制器名`，那么無需填寫這個參數。假如不是，那么需要填寫對應的表名，比如： ~~~ ->autoEdit($fields, 'admin_user') ~~~ ### 驗證器名 如果編輯數據的時候，需要用到驗證器，那么可以填寫驗證器名，如果不需要用到驗證器，那么可以不寫或者填寫空值。 默認情況下，填寫`true`的話，系統會去使用驗證器名為**當前控制器名**的驗證器。比如當前控制器是Index，那么就會去調用Index驗證器。 ~~~ ->autoEdit($fields, 'admin_user', true) ~~~ 如果不填寫，那么提交表單的時候，則不會驗證數據，而是直接寫入數據。 也可以指定驗證器名 ~~~ ->autoEdit($fields, 'admin_user', 'User') ~~~ ### 自動更新時間戳 如果編輯數據的時候想自動插入創建時間和更新時間，那么可以這樣寫 ~~~ ->autoEdit($fields, 'admin_user', 'User', true) ~~~ 提交表單的時候，DolphinPHP會自動更新當前**時間戳**到字段名為`update_time`的字段中。 >[danger] 前提是表中有這個字段。 如果表中的時間字段不是`update_time`而是其他，比如`update_at`，那么也可以直接寫 ~~~ ->autoEdit($fields, 'admin_user', 'User', 'update_at') ~~~ 當然，也可以利用表單項的`hidden`類型來添加，比如 ~~~ // 定義編輯頁面的字段 $field = [ ['hidden', 'id'], ['text', 'username', '用戶名', '必填，可由英文字母、數字組成'], ['text', 'nickname', '昵稱', '可以是中文'], ['select', 'role', '角色', '', RoleModel::getTree(null, false)], ['text', 'email', '郵箱', ''], ['password', 'password', '密碼', '必填，6-20位'], ['text', 'mobile', '手機號'], ['image', 'avatar', '頭像'], ['radio', 'status', '狀態', '', ['禁用', '啟用'], 1], ['hidden', 'update_time', $this->request->time()] ]; ~~~ >[info] 如果在編輯數據前需要復雜處理的，建議自己創建edit方法 ### 自定義時間格式 從`1.0.3`版本開始，支持自定義時間字段的格式，默認為時間戳，如果想以普通時間格式存儲的話，可以這樣指定。 ~~~ ->autoEdit($fields, 'admin_user', 'User', true, 'Y-m-d') ~~~ 那么添加數據的時候，會自動添加create_time字段和update_time字段，它們的格式為：`Y-m-d`. 或者單獨對某個字段的格式進行指定。 ~~~ ->autoEdit($fields, 'admin_user', 'User', 'create_time|Y-m-d') // create_time字段寫入的時間格式為Y-m-d ~~~ 沒有指定時間格式的字段，將默認為時間戳格式 ~~~ ->autoEdit($fields, 'admin_user', 'User', 'create_time|Y-m-d,update_time') ~~~ `create_time`字段寫入的時間格式為`Y-m-d`，而`update_time`為時間戳。 如果指定了時間格式，那么沒有明確指定格式的字段，將統一使用后面指定的格式。 ~~~ ->autoEdit($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版本開始，支持設置為彈窗 ~~~ ->autoEdit($fields, 'admin_user', 'User', '', '', true) ~~~