摘要：原文地址安裝首先通過來安裝這個包編輯項目的文件在部分加入接下來從命令行更新接下來添加到的數組最后添加兩個類鏈接到的數組創建表單打開表單默認是方法你可以隨意指定其他接收方法表單僅僅支持和方法和方法將會使用一個隱藏域添加到表單中來欺騙實現你可

原文地址: 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());