> For the complete documentation index, see [llms.txt](https://tony915.gitbook.io/laravel-4-2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tony915.gitbook.io/laravel-4-2/dong-shou-zuo-jin-jie/use-form.md).
# Form 進階
## 建立表單
```
{{ Form::open(['url' => 'foo']) }}
//...
{{ Form::close() }}
```
使用 open() 及 close() 方法來建立一個表單。open() 方法的參數是以陣列，必須指定要傳送到哪個 url，method 預設為 POST，可省略，如果要指定其他的方法，可自行增加，例如：
```
{{ Form::open(['url' => 'foo', 'method' => 'put']) }}
```
你也可以不使用 url，改用 route：
```
{{ Form::open(['route' => 'route.name']) }}
```
如果使用 route，記得在 Routes.php 中，必須設定對應的 route name。
route 帶參數：
```
{{ Form::open(['route' => ['route.name', $user->id] ]) }}
```
或是使用 action 來指定 Controller：
```
{{ Form::open(['action' => 'Controller@method']) }}
```
Controller 帶參數：
```
{{ Form::open(['action' => ['Controller@method', $user->id] ]) }}
```
## Form Model Binding
表單可以綁定資料模型，可以讓你在需要載入資料到表單欄位時更加方便。在前面的迷你部落格例子中，當我們在編輯文章時，可以改用 Model Binding 的方式來改寫：
原本的
```
{{Form::open(['url'=>'post/'.$post->id, 'method'=>'put'])}}
```
改成
```
{{ Form::model($post, ['action'=>['HomeController@update', $post->id]]) }}
```
現在這個表單已經和 $post 所儲存的 Post 模型綁定，在之後的欄位，就不需要指定值，只要欄位名稱和 Post 的屬性名稱相同即可。
原本的
```
{{Form::text('title', $post->title)}}
```
改為
```
{{Form::text('title')}}
```
這裡的 'title' 和 Post 的屬性，也就是資料庫中的欄位同名。因此可以不用 $post->title 指定值。
## 表單元件
### Label
標籤文字，通常放在輸入框的前面，用來說明輸入框內要填入什麼內容。使用方式：
```
{{ Form::label('title', '標題') }}
```
如果要加入 HTML 屬性，可以使用第三個參數，陣列型態：
```
{{ Form::label('title', '標題', ['class'=>'title']) }}
```
要用到 css 去指定樣式時，可以加入 class 屬性。後面其他的表單元件都可以這麼使用。
### Input (Text, TextArea, Password, Hidden, Email, File)
文字輸入框，沒有值的狀態：
```
{{ Form::text('title') }}
{{ Form::textarea('content') }}
{{ Form::password('password') }}
```
指定值：
```
{{ Form::text('title', '這是標題') }}
{{ Form::textarea('content', '這是內容') }}
{{ Form::password('password', '12345678') }}
{{ Form::hidden('id', '5') }}
```
密碼欄位會以點或星號顯示輸入的文字。
text 可以使用第三個參數加入 HTML 屬性 \['size'=>30] 來改變輸入框的寬度。textarea 則是 \['size'=>'50x50']，中間那個是小寫的 x。
email 及檔案的使用方式：
```
{{ Form::email('email') }}
{{ Form::file('upload') }}
```
！重要，當你有使用到 file 欄位時，在 open() 方法中必須加入 \['files' => true] 參數，才能執行上傳的動作，否則上傳欄位是無效的，例如：
```
{{ Form::open(['url'=>'foo', 'method'=>'post', 'files'=>true]) }}
```
### Checkboxes (複選) 及 Radio (單選)
複選
```
{{ Form::checkbox('habit', 'reading', true) }}看書
```
habit 是欄位名稱，reading 是值，true 表示預設為勾選，可以省略不寫，表示不勾選。
單選
```
{{ Form::radio('city', 'taipei', true) }}Taipei
{{ Form::radio('city', 'taichung') }}Taichung
{{ Form::radio('city', 'kaohsiung') }}Kaohsiung
```
city 是欄位名稱，同名的視為一組，同一組中只有一個可以被選取。taipei 等第二個參數是值，true 表示選取。
### Drop-Down Lists (下拉式清單)
一般清單
```
{{ Form::select('size', ['L'=>'大','M'=>'中','S'=>'小'], 'M') }}
```
size 是欄位名稱；第二個參數是陣列，表示清單項目；第三個參數可省略，是前面陣列中的 Key，表示預設選取的項目。
群組清單
```
{{ Form::select('fruit', [
'A' => ['apple' => 'Apple'],
'B' => ['banana' => 'Banana'],
])}}
```
fruit 是欄位名稱；陣列是清單項目；A 是群組名稱，之後的陣列是屬於該群組的清單項目。
連續數字清單
```
{{ Form::selectRange('number', 10, 20) }}
```
number 是欄位名稱，10 是起始值，20 是結束值，這個清單會自動產生 10\~20 的數字項目。
月份清單
```
{{ Form::selectMonth('month') }}
```
自動產生月份名的清單項目，不過是英文的。
### Buttons (按鈕)
Submit
```
{{ Form::submit('發表文章') }}
```
Button
```
{{ Form::button('按鈕') }}
```