weotch/former

强大的表单构建器

4.1.0 2017-04-07 18:04 UTC

README

以 Laravel 风格创建和格式化表单

Build Status Latest Stable Version Total Downloads )

对于 Laravel 4,请使用 master 分支

Former 输出与您喜欢的 CSS 框架兼容的 HTML 表单元素(目前支持 Bootstrap 和 Foundation)。Former 还处理验证错误后的重新填充,包括自动渲染受影响字段的错误文本。

简介

Former 提供了一种流畅的表单创建方法,允许您做

Former::horizontal_open()
  ->id('MyForm')
  ->rules(['name' => 'required'])
  ->method('GET');

  Former::xlarge_text('name') # Bootstrap sizing
    ->class('myclass') # arbitrary attribute support
    ->value('Joseph')
    ->required(); # HTML5 validation

  Former::textarea('comments')
    ->rows(10)->columns(20)
    ->autofocus();

  Former::actions()
    ->large_primary_submit('Submit') # Combine Bootstrap directives like "lg and btn-primary"
    ->large_inverse_reset('Reset');

Former::close();

每次调用一个实际不存在的函数时,Former 都假设您正在尝试设置一个属性,并神奇地创建它。这就是为什么在上面的例子中可以这样做 ->rows(10);如果您想设置包含破折号的属性,只需将其替换为下划线:->data_foo('bar') 等于 data-foo="bar"。当然,如果您想设置实际包含下划线的属性,您始终可以使用后备方法 setAttribute('data_foo', 'bar')。欢迎您。

这是其核心,但 Former 还提供了更多功能。我邀请您查阅维基百科,以了解 Former 的功能范围。

安装

使用 Composer 需要Former包

composer require anahkiasen/former   # For Laravel 4, use anahkiasen/former:~3.5

然后运行 "composer update"。接下来修改您的 config/app.php。在 providers 数组中添加

Former\FormerServiceProvider::class

然后在同一文件中将 Former 的主类别名添加到 aliases 数组中

'Former' => 'Former\Facades\Former',

如果您不使用 Laravel,您可以将 Former 添加到您的 Composer 文件中,然后使用

use Former\Facades\Former;

目录