自动编辑按钮

autoEdit('表单项' [, '表名', '验证器名', '自动插入时间戳', '时间格式', '是否弹窗'])

版本功能
1.0.5支持弹窗

和自动添加按钮用法相类似

  1. // 读取用户数据
  2. $data_list = Db::name('admin_user')->select();
  4. // 定义新增或编辑页面的字段
  5. $fields = [
  6.     ['hidden', 'id'],
  7.     ['text', 'username', '用户名', '必填，可由英文字母、数字组成'],
  8.     ['text', 'nickname', '昵称', '可以是中文'],
  9.     ['select', 'role', '角色', '', RoleModel::getTree(null, false)],
  10.     ['text', 'email', '邮箱', ''],
  11.     ['password', 'password', '密码', '必填，6-20位'],
  12.     ['text', 'mobile', '手机号'],
  13.     ['image', 'avatar', '头像'],
  14.     ['radio', 'status', '状态', '', ['禁用', '启用'], 1]
  15. ];
  17. // 使用ZBuilder构建数据表格
  18. return ZBuilder::make('table')
  19.     ->addColumn('id', 'ID')
  20.     ->addColumn('username', '用户名')
  21.     ->addColumn('nickname', '昵称')
  22.     ->addColumn('email', '邮箱')
  23.     ->addColumn('mobile', '手机号')
  24.     ->addColumn('create_time', '创建时间')
  25.     ->addColumn('right_button', '操作', 'btn')
  26.     ->autoAdd($fields) // 添加新增按钮
  27.     ->autoEdit($fields) // 添加编辑按钮
  28.     ->setRowList($data_list) // 设置表格数据
  29.     ->fetch();

需要注意的是，编辑需要用到主键字段，一般会设置为隐藏，比如上面的['hidden', 'id']

表单项

表单项是一个数组，每个元素表示一个字段数据，具体用法可以参考添加表单项通用方法。

表名

如果你的数据表名是当前模块名_当前控制器名，那么无需填写这个参数。假如不是，那么需要填写对应的表名，比如：

  1. ->autoEdit($fields, 'admin_user')

验证器名

如果编辑数据的时候，需要用到验证器，那么可以填写验证器名，如果不需要用到验证器，那么可以不写或者填写空值。

默认情况下，填写true的话，系统会去使用验证器名为当前控制器名的验证器。比如当前控制器是Index，那么就会去调用Index验证器。

  1. ->autoEdit($fields, 'admin_user', true)

如果不填写，那么提交表单的时候，则不会验证数据，而是直接写入数据。

也可以指定验证器名

  1. ->autoEdit($fields, 'admin_user', 'User')

自动更新时间戳

如果编辑数据的时候想自动插入创建时间和更新时间，那么可以这样写

  1. ->autoEdit($fields, 'admin_user', 'User', true)

提交表单的时候，DolphinPHP会自动更新当前时间戳到字段名为update_time的字段中。

前提是表中有这个字段。

如果表中的时间字段不是update_time而是其他，比如update_at，那么也可以直接写

  1. ->autoEdit($fields, 'admin_user', 'User', 'update_at')

当然，也可以利用表单项的hidden类型来添加，比如

  1. // 定义编辑页面的字段
  2. $field = [
  3.     ['hidden', 'id'],
  4.     ['text', 'username', '用户名', '必填，可由英文字母、数字组成'],
  5.     ['text', 'nickname', '昵称', '可以是中文'],
  6.     ['select', 'role', '角色', '', RoleModel::getTree(null, false)],
  7.     ['text', 'email', '邮箱', ''],
  8.     ['password', 'password', '密码', '必填，6-20位'],
  9.     ['text', 'mobile', '手机号'],
  10.     ['image', 'avatar', '头像'],
  11.     ['radio', 'status', '状态', '', ['禁用', '启用'], 1],
  12.     ['hidden', 'update_time', $this->request->time()]
  13. ];

如果在编辑数据前需要复杂处理的，建议自己创建edit方法

自定义时间格式

从1.0.3版本开始，支持自定义时间字段的格式，默认为时间戳，如果想以普通时间格式存储的话，可以这样指定。

  1. ->autoEdit($fields, 'admin_user', 'User', true, 'Y-m-d')

那么添加数据的时候，会自动添加create_time字段和update_time字段，它们的格式为：Y-m-d.

或者单独对某个字段的格式进行指定。

  1. ->autoEdit($fields, 'admin_user', 'User', 'create_time|Y-m-d') // create_time字段写入的时间格式为Y-m-d

没有指定时间格式的字段，将默认为时间戳格式

  1. ->autoEdit($fields, 'admin_user', 'User', 'create_time|Y-m-d,update_time')

create_time字段写入的时间格式为Y-m-d，而update_time为时间戳。

如果指定了时间格式，那么没有明确指定格式的字段，将统一使用后面指定的格式。

  1. ->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。

是否弹窗

从1.0.5版本开始，支持设置为弹窗

  1. ->autoEdit($fields, 'admin_user', 'User', '', '', true)