laravel form builder
1.53.1
Symfony のフォームビルダーからインスピレーションを得た Laravel 5 用のフォームビルダー。 Laravels FormBuilder クラスの助けを借りて、簡単に変更して再利用できるフォームを作成します。デフォルトでは Bootstrap 3 をサポートしています。
Laravel 4 のバージョンについては、laravel4-form-builder を確認してください。
ブートストラップ 3 の代わりにブートストラップ 4 を使用するには、laravel-form-builder-bs4 をインストールします。
1.5.*以前から>1.6.*にアップグレードし、フォーム値バインディングで問題が発生した場合は、 default_value名前をvalueに変更します。
詳細については変更ログをご覧ください。
詳細なドキュメントについては、https://kristijanhusak.github.io/laravel-form-builder/ を参照してください。
変更ログはここにあります。
composer require kris/laravel-form-builderまたは、 composer.jsonファイルを変更して手動で行います。
{
"require" : {
"kris/laravel-form-builder" : " 1.* "
}
}そしてcomposer installを実行します
次に、サービスプロバイダーをconfig/app.phpに追加します。
' providers ' => [
// ...
Kris LaravelFormBuilder FormBuilderServiceProvider::class
]そしてFacade ( config/app.phpにもあります)
' aliases ' => [
// ...
' FormBuilder ' => Kris LaravelFormBuilder Facades FormBuilder::class
]注意: このパッケージは、 laravelcollective/htmlパッケージを追加し、エイリアス (Form、Html) が IoC コンテナーに存在しない場合にロードします。
フォームクラスの作成は簡単です。簡単な職人コマンドを使用すると、次のようになります。
php artisan make:form Forms/SongForm --fields= " name:text, lyrics:textarea, publish:checkbox "フォームはパスapp/Forms/SongForm.phpに次の内容で作成されます。
<?php
namespace App Forms ;
use Kris LaravelFormBuilder Form ;
use Kris LaravelFormBuilder Field ;
class SongForm extends Form
{
public function buildForm ()
{
$ this
-> add ( ' name ' , Field:: TEXT , [
' rules ' => ' required|min:5 '
])
-> add ( ' lyrics ' , Field:: TEXTAREA , [
' rules ' => ' max:5000 '
])
-> add ( ' publish ' , Field:: CHECKBOX );
}
}フィールドのない空のフォームをインスタンス化したい場合は、 --fieldsパラメーターの渡しをスキップしてください。
php artisan make:form Forms/PostForm与えるもの:
<?php
namespace App Forms ;
use Kris LaravelFormBuilder Form ;
class PostForm extends Form
{
public function buildForm ()
{
// Add fields here...
}
}その後、コントローラーでクラスをインスタンス化し、ビューに渡します。
<?php
namespace App Http Controllers ;
use Illuminate Routing Controller as BaseController ;
use Kris LaravelFormBuilder FormBuilder ;
class SongsController extends BaseController {
public function create ( FormBuilder $ formBuilder )
{
$ form = $ formBuilder -> create ( App Forms SongForm::class, [
' method ' => ' POST ' ,
' url ' => route ( ' song.store ' )
]);
return view ( ' song.create ' , compact ( ' form ' ));
}
public function store ( FormBuilder $ formBuilder )
{
$ form = $ formBuilder -> create ( App Forms SongForm::class);
if (! $ form -> isValid ()) {
return redirect ()-> back ()-> withErrors ( $ form -> getErrors ())-> withInput ();
}
// Do saving and other things...
}
}別の例:
<?php
namespace App Http Controllers ;
use Illuminate Routing Controller as BaseController ;
use Kris LaravelFormBuilder FormBuilder ;
use App Forms SongForm ;
class SongsController extends BaseController {
public function create ( FormBuilder $ formBuilder )
{
$ form = $ formBuilder -> create (SongForm::class, [
' method ' => ' POST ' ,
' url ' => route ( ' song.store ' )
]);
return view ( ' song.create ' , compact ( ' form ' ));
}
public function store ( FormBuilder $ formBuilder )
{
$ form = $ formBuilder -> create (SongForm::class);
if (! $ form -> isValid ()) {
return redirect ()-> back ()-> withErrors ( $ form -> getErrors ())-> withInput ();
}
// Do saving and other things...
}
}すべてのフィールドがモデルのプロパティであることを考慮して、フォームの送信後にモデルを保存する場合は、次のようにします。
<?php
namespace App Http Controllers ;
use App Http Controllers Controller ;
use Kris LaravelFormBuilder FormBuilder ;
use App SongForm ;
class SongFormController extends Controller
{
public function store ( FormBuilder $ formBuilder )
{
$ form = $ formBuilder -> create ( App Forms SongForm::class);
$ form -> redirectIfNotValid ();
SongForm:: create ( $ form -> getFieldValues ());
// Do redirecting...
}必要なプロパティのみを保存できます。
<?php
namespace App Http Controllers ;
use App Http Controllers Controller ;
use Kris LaravelFormBuilder FormBuilder ;
use App SongForm ;
class SongFormController extends Controller
{
public function store ( FormBuilder $ formBuilder , Request $ request )
{
$ form = $ formBuilder -> create ( App Forms SongForm::class);
$ form -> redirectIfNotValid ();
$ songForm = new SongForm ();
$ songForm -> fill ( $ request -> only ([ ' name ' , ' artist ' ])-> save ();
// Do redirecting...
}または、フォーム送信後にモデルを更新することもできます。
<?php
namespace App Http Controllers ;
use App Http Controllers Controller ;
use Kris LaravelFormBuilder FormBuilder ;
use App SongForm ;
class SongFormController extends Controller
{
public function update ( int $ id , Request $ request )
{
$ songForm = SongForm:: findOrFail ( $ id );
$ form = $ this -> getForm ( $ songForm );
$ form -> redirectIfNotValid ();
$ songForm -> update ( $ form -> getFieldValues ());
// Do redirecting...
}ルートを作成する
// app/Http/routes.php
Route:: get ( ' songs/create ' , [
' uses ' => ' SongsController@create ' ,
' as ' => ' song.create '
]);
Route:: post ( ' songs ' , [
' uses ' => ' SongsController@store ' ,
' as ' => ' song.store '
]); form()ヘルパー関数を使用してビュー内のフォームを印刷します。
<!-- resources/views/song/create.blade.php -->
@extends('app')
@section('content')
{!! form($form) !!}
@endsection /songs/createに移動します。上記のコードは次の HTML を生成します。
< form method =" POST " action =" http://example.dev/songs " >
< input name =" _token " type =" hidden " value =" FaHZmwcnaOeaJzVdyp4Ml8B6l1N1DLUDsZmsjRFL " >
< div class =" form-group " >
< label for =" name " class =" control-label " > Name </ label >
< input type =" text " class =" form-control " id =" name " >
</ div >
< div class =" form-group " >
< label for =" lyrics " class =" control-label " > Lyrics </ label >
< textarea name =" lyrics " class =" form-control " id =" lyrics " > </ textarea >
</ div >
< div class =" form-group " >
< label for =" publish " class =" control-label " > Publish </ label >
< input type =" checkbox " name =" publish " id =" publish " >
</ div >
</ form >または、単純な配列を使用してフォームをより簡単に生成することもできます
<?php
namespace App Http Controllers ;
use Illuminate Routing Controller as BaseController ;
use Kris LaravelFormBuilder FormBuilder ;
use Kris LaravelFormBuilder Field ;
use App Forms SongForm ;
class SongsController extends BaseController {
public function create ( FormBuilder $ formBuilder )
{
$ form = $ formBuilder -> createByArray ([
[
' name ' => ' name ' ,
' type ' => Field:: TEXT ,
],
[
' name ' => ' lyrics ' ,
' type ' => Field:: TEXTAREA ,
],
[
' name ' => ' publish ' ,
' type ' => Field:: CHECKBOX
],
]
,[
' method ' => ' POST ' ,
' url ' => route ( ' song.store ' )
]);
return view ( ' song.create ' , compact ( ' form ' ));
}
}プロジェクトは PSR-2 標準に従っており、PHPUnit テストでカバーされています。プル リクエストにはテストが含まれており、Travis CI ビルドに合格する必要があります。
テストを実行するには、まず、 composer install使用して依存関係をインストールします。
その後、 vendor/bin/phpunitを使用してテストを実行できます。
