表单布局

多列布局 (column)

表单布局 - 图1

类似于上图的左右两列布局方式,可以参考下面的代码来实现

  1. // 第一列占据1/2的页面宽度
  2. $form->column(6, function (Form $form) {
  3. $form->text('name')->required();
  4. $form->date('born')->required();
  5. $form->select('education')->options([...])->required();
  6. $form->text('nation')->required();
  7. $form->text('native')->required();
  8. $form->text('job')->required();
  9. $form->text('code')->required();
  10. $form->text('phone')->required();
  11. $form->text('work')->required();
  12. $form->text('census')->required();
  13. });
  14. // 第二列占据1/2的页面宽度
  15. $form->column(6, function (Form $form) {
  16. $form->image('avatar');
  17. $form->decimal('wages');
  18. $form->decimal('fund');
  19. $form->decimal('pension');
  20. $form->decimal('fee');
  21. $form->decimal('business');
  22. $form->decimal('other');
  23. $form->text('area')->default(0);
  24. $form->textarea('illness');
  25. $form->textarea('comment');
  26. });
  27. // 调整所有表单的宽度
  28. $form->width(9, 2);

以上布局功能使用了bootstrap的栅格布局系统,所有列的宽度总和不得超出12,并且也支持在hasManyarray表单中使用

  1. $form->hasMany('jobs', function ($form) {
  2. $form->column(6, function (Form $form) {
  3. $form->text('name')->required();
  4. $form->date('born')->required();
  5. });
  6. $form->column(6, function (Form $form) {
  7. $form->image('avatar');
  8. $form->decimal('wages');
  9. });
  10. });

多行布局 (row)

使用

  1. $form->row(function (Form\Row $form) {
  2. $form->width(4)->text('username')->required();
  3. $form->width(3)->text('title');
  4. ...
  5. });
  6. $form->row(function (Form\Row $form) {
  7. ...
  8. });
  9. ...

效果 表单布局 - 图2

并且也支持在hasManyarray表单中使用

  1. $form->hasMany('jobs', function ($form) {
  2. $form->row(function (Form\Row $form) {
  3. ...
  4. });
  5. $form->row(function (Form\Row $form) {
  6. ...
  7. });
  8. });

选项卡表单 (tab)

如果表单元素太多,会导致表单页面太长, 这种情况下可以使用tab方法来分隔表单:

  1. $form->tab('Basic info', function (Form $form) {
  2. $form->text('username');
  3. $form->email('email');
  4. })->tab('Profile', function (Form $form) {
  5. $form->image('avatar');
  6. $form->text('address');
  7. $form->mobile('phone');
  8. })->tab('Jobs', function (Form $form) {
  9. $form->hasMany('jobs', function ($form) {
  10. $form->text('company');
  11. $form->date('start_date');
  12. $form->date('end_date');
  13. });
  14. })

同时,tab 布局中也允许嵌套使用columnrow布局

  1. $form->tab('Basic info', function (Form $form) {
  2. $form->column(6, function (Form\BlockForm $form) {
  3. $form->display('id');
  4. $form->text('name');
  5. });
  6. $form->column(6, function (Form\BlockForm $form) {
  7. $form->text('username');
  8. });
  9. })

设置默认显示的 Tab

  1. // 默认显示标题为 标题2 的 Tab
  2. $form->getTab()->active('标题2');
  3. // 也可以指定偏移量
  4. $form->getTab()->activeByIndex(1);
  5. $form->tab('标题1', function ($form) {
  6. ...
  7. });
  8. $form->tab('标题2', function ($form) {
  9. ...
  10. });

Fieldset布局

  1. $form->fieldset('分组', function (Form $form) {
  2. $form->text('company');
  3. $form->date('start_date');
  4. $form->date('end_date');
  5. });

如果想要默认收起

  1. $form->fieldset('分组', function (Form $form) {
  2. ...
  3. })->collapsed();

效果

表单布局 - 图3

分块布局 (block)

如果你的表单中字段非常多,那么可以通过以下方式让你的表单分块布局,并且允许嵌套使用columnrow布局

  1. $form->block(8, function (Form\BlockForm $form) {
  2. // 设置标题
  3. $form->title('基本设置');
  4. // 显示底部提交按钮
  5. $form->showFooter();
  6. // 设置字段宽度
  7. $form->width(9, 2);
  8. $form->column(6, function (Form\BlockForm $form) {
  9. $form->display('id');
  10. $form->text('name');
  11. $form->email('email');
  12. $form->image('avatar');
  13. $form->password('password');
  14. });
  15. $form->column(6, function (Form\BlockForm $form) {
  16. $form->text('username');
  17. $form->email('mobile');
  18. $form->textarea('description');
  19. });
  20. });
  21. $form->block(4, function (Form\BlockForm $form) {
  22. $form->title('分块2');
  23. $form->text('nickname');
  24. $form->number('age');
  25. $form->radio('status')->options(['1' => '默认', 2 => '冻结'])->default(1);
  26. $form->next(function (Form\BlockForm $form) {
  27. $form->title('分块3');
  28. $form->date('birthday');
  29. $form->date('created_at');
  30. });
  31. });

效果 表单布局 - 图4