Laravel 组件之 Forms & HTML 组件 (laravelcollective

摘要：原文地址安装首先通过来安装这个包编辑项目的文件在部分加入接下来从命令行更新接下来添加到的数组最后添加两个类链接到的数组创建表单打开表单默认是方法你可以随意指定其他接收方法表单仅仅支持和方法和方法将会使用一个隐藏域添加到表单中来欺骗实现你可

原文地址: Laravel Collective Forms & HTML

首先通过 composer 来安装这个 包, 编辑项目的 composer.json 文件. 在 require 部分 加入 laravelcollective/html :

"require": {
    "laravelcollective/html": "5.1.*"
}

接下来从命令行更新 composer :

composer update -vvv

接下来添加 provider 到 config/app.php 的 providers 数组:

"providers" => [
    // ...
    CollectiveHtmlHtmlServiceProvider::class,
    // ...
],

最后 添加两个类链接到 config/app.php 的 aliases 数组:

"aliases" => [
    // ...
    "Form" => CollectiveHtmlFormFacade::class,
    "Html" => CollectiveHtmlHtmlFacade::class,
    // ...
],

{!! Form::open(array("url" => "foo/bar")) !!}
    //
{!! Form::close() !!}

默认是 POST 方法, 你可以随意指定其他接收方法

echo Form::open(array("url" => "foo/bar", "method" => "put"))

Note: HTML 表单仅仅支持 POST 和 GET方法, PUT 和DELETE 方法将会使用一个隐藏域_method 添加到form 表单中来欺骗实现

你可以使用指定的控制器@动作 或者命名的路由来创建表单

echo Form::open(array("route" => "route.name"))

echo Form::open(array("action" => "Controller@method"))

同样也可以向路由中传入参数.

echo Form::open(array("route" => array("route.name", $user->id)))

echo Form::open(array("action" => array("Controller@method", $user->id)))

如果你的表单需要支持文件上传, 在数组中添加 一个 files 配置项.

echo Form::open(array("url" => "foo/bar", "files" => true))

Laravel 提供了一个简单的方法来防止你的应用遭受跨站攻击. 首先会在你的session 中生成一个随机的 token, 如果你使用 Form::open 方法并且提交方法是 POST, PUT或者是 DELETE, CSRF token 将会自动的添加到你的form 表单的隐藏域中. 换种方法 如果你像自己生成 CSRF token 字段, 你可以使用 token 方法.

echo Form::token();

Route::post("profile", array("before" => "csrf", function()
{
    //
}));

通常, 你需要想表单中填入来自数据库模型的数据. 想这样做你可以使用 Form::model 方法.

echo Form::model($user, array("route" => array("user.update", $user->id)))

现在当你自动生成一个表单元素, 例如文本输入框. Model 的值将会自动匹配并且填写到相关的表单字段中.例如. 一个文本输入框的 name 是 email这个字段将会用 用户 Model 的 email 属性来填充并且设置. 当然, 还有其他用法. 如果一个字段在session 闪存数据中 也存在这个名字, 这个将会覆盖模型中的这个字段值. 优先级是这个样子的:

Session Flash Data (Old Input) [session 闪存 / 老的输入数据 ]

Explicitly Passed Value [输入值]

Model Attribute Data [模型属性值]

这个可以让你快速的使用模型数据来创建表单, 也能轻松的在服务器校验错误之后重新发布表单.

Note: 使用 Form::model方法的时候一定要使用 Form::close来关闭表单!

echo Form::label("email", "E-Mail Address");

echo Form::label("email", "E-Mail Address", array("class" => "awesome"));

Note: 在创建了一个标签之后, 如果有创建的表单元素的 name 值和 label 的 name 值相符的话, 将会自动在 表单元素 中自动匹配增加 id 属性. id 的值就是 label 的name 值.

echo Form::text("username");

echo Form::text("email", "example@gmail.com");

Note:  hidden 和 textarea 方法的参数和 text 相同.

echo Form::password("password", array("class" => "awesome"));

echo Form::email($name, $value = null, $attributes = array());
echo Form::file($name, $attributes = array());

echo Form::checkbox("name", "value");
echo Form::radio("name", "value");

echo Form::checkbox("name", "value", true);
echo Form::radio("name", "value", true);

echo Form::number("name", "value");

echo Form::date("name", CarbonCarbon::now());

echo Form::file("image");

Note: 表单中必须设置 files 参数的值为 true

echo Form::select("size", array("L" => "Large", "S" => "Small"));

echo Form::select("size", array("L" => "Large", "S" => "Small"), "S");

这回创建一个没有任何值的 元素作为下拉列表的第一个选择值.

echo Form::select("size", array("L" => "Large", "S" => "Small"), null, ["placeholder" => "Pick a size..."]);

echo Form::select("animal", array(
        "Cats" => array("leopard" => "Leopard"),
        "Dogs" => array("spaniel" => "Spaniel"),
    ));

echo Form::selectRange("number", 10, 20);

echo Form::selectMonth("month");

echo Form::submit("Click Me!");

Note: 想创建一个按钮元素? 试用 button 方法. 他和 submit 方法有相同的参数.

用来很方便的来自定义一个表单元素的方法叫做 macros . 合理是怎样使用它. 首先简单的使用名称和闭包函数来注册一个 :

Form::macro("myField", function()
{
    return "";
});

现在你可以使用自定义的名字来调用这个 macro

echo Form::myField();

根据给定的URL生成 html 链接

echo link_to("foo/bar", $title = null, $attributes = array(), $secure = null);

生成一个链接到指定资源的 html

echo link_to_asset("foo/bar.zip", $title = null, $attributes = array(), $secure = null);

生成一个根据给定路由的html链接

echo link_to_route("route.name", $title = null, $parameters = array(), $attributes = array());

根据指定的控制器/方法来生成 html 链接

echo link_to_action("HomeController@getIndex", $title = null, $parameters = array(), $attributes = array());