library form-builder {🖫 163, ⚐ 7, ★ 2}

iyoworks/form-builder

An Object Oriented form builder that extracts form presentation from form creation. Based on Flyn San's Form Builder.

Thursday, January 15, 2015
by iyoworks
Repository
1 Watchers
2 Stars
163 Installations

PHP
0 Dependents
0 Suggesters
4 Forks
0 Open issues
7 Versions
0 % Grown

The README.md

Laravel Form Builder

A simple and intuitive form builder

Based on https://github.com/Flynsarmy/laravel-form-builder, _(*1)

Installation

Require this package in your composer.json and run composer update (or run composer require iyoworks/form-builder:1.0.* directly):, _(*2)

"iyoworks/form-builder": "1.0.*"

After updating composer, add the ServiceProvider to the providers array in app/config/app.php, _(*3)

'Iyoworks\FormBuilder\FormBuilderServiceProvider',

and optionally the Facade to the aliases array in the same file. This will allow for global callbacks (more on that later)., _(*4)

'FormBuilder'     => 'Iyoworks\FormBuilder\Facades\FormBuilder',

Usage

Add/Edit/Delete Fields

Create a form, add fields, render., _(*5)

$form = FormBuilder::form();
$form->action('UserController@create')
//$form->add[FieldType]([field_slug] [, Field Label]);
$form->addText('first_name', 'First Name');
$form->addSelect('gender')->options(['male'=>'Male', 'female'=>'Female', 'none'=>'Not Telling']);

$form->render();

Need to edit or remove a field?, _(*6)

// Set field with id 'gender' to have 3 options instead of 2.
$form->getField('gender')->options(['m'=>'Male', 'f'=>'Female', 'n'=>'Not Telling']);

// Remove the gender field
$form->remove('gender');

Add fields exactly where you want them, _(*7)

// Add last name after first name
$form->addAfter('first_name', 'last_name', 'text');
$form->addTextAfterFirstName('last_name');
$form->addBefore('last_name', 'first_name', 'text');
$form->addTextAfterLastName('first_name');

Closures are also supported, _(*8)

use Iyoworks\FormBuilder\Form;
use Iyoworks\FormBuilder\Field;
// Closure support for FormBuilder
$form = FormBuilder::form(function(Form $form) {
    $form->url('users/create');
    $form->addText('first_name');
    $form->addSelect('gender'->options(['M'=>'Male', 'F'=>'Female']);
})->html();

echo $form->open(), $form->render(), $form->close();
# the same as
echo $form->html();

Field settings

You can add fields to rows, _(*9)

$form->addRow(function($form){
    $form->addText('first_name', 'First Name')
        ->label('First Name')
        ->description('Enter your first name')
        ->columns(12);
    $form->addText('last_name', 'Last Name')
        ->label('First Name')
        ->description('Enter your last name')
        ->columns(12);
});
$form->addEmail('email', 'Email Address')
$form->addSubmit('Submit')->addClass('btn btn-block btn-primary');

Callbacks

Callbacks can be used to render your form exactly the way you want it to look., _(*10)

Supported callbacks include:, _(*11)

beforeForm(Form $form)
afterForm(Form $form)
beforeField(Form $form, Field $field)
afterField(Form $form, Field $field)

They can be used on a per-form basis, _(*12)

// Per-form Callbacks
$form->beforeField(function(Form $form, Field $field) {
    // Use field settings to display your form nicely
    return '<label>' . $field->label . '</label>';
});

or using the optional facade, a global basis, _(*13)

// Global form callbacks
FormBuilder::bind('beforeField', function(Form $form, Field $field) {
        return '


'.$field->label.'';
    })
    ->bind('afterField', function(Form $form, Field $field) {
        $output = '';
        if ( $field->description )
            $output .= '' . $field->description . ', _(*14)';
        return $output . '

';
    });
$form = FormBuilder::form(function(Form $form) {
    $form->route('user.create');
    $form->addText('first_name', 'First Name');
    $form->addText('last_name')->label('Last Name');
});

echo $form->model($model)->html();