intentor/laravel-form

Form helpers for Laravel 5.

Form helpers for Laravel 5, _(*1)

Currently the project is DISCONTINUED. However, feel free to fork it and continue its development!, _(*2)

Contents

1. Introduction
2. Installation
3. Quick start
4. Helpers
   • open
   • model
   • close
   • label
   • readonly
   • hidden
   • text
   • textarea
   • email
   • url
   • number
   • password
   • checkbox
   • radio
   • checkboxGroup
   • radioGroup
   • dropdown
   • submit
   • reset
   • buttons
5. Utilities
   • modelToList
   • modelToSelected
6. Themes
7. Changelog
8. Support
9. License

Introduction

Laravel Form provides a series of helpers for form creation in PHP pages and Blade templates., _(*3)

Compatible with Laravel 5., _(*4)

Installation

Laravel 5.0

At composer.json of your Laravel installation, add the following require line:, _(*5)

``` json { "require": { "intentor/laravel-form": "~1.0" } }, <sub>(*6)</sub>

Run `composer update` to add the package to your Laravel app.

At `config/app.php`, add the Service Provider and the Facade:

```php
    'providers' => [
        'Intentor\LaravelForm\ServiceProvider',
    ]

    //...

    'aliases' => [
        'Form' => 'Intentor\LaravelForm\Facade'
    ]

Laravel 5.1+

At composer.json of your Laravel installation, add the following require line:, <sub>(*7)</sub>

``` json { "require": { "intentor/laravel-form": "~2.0" } }, <sub>(*8)</sub>

Run `composer update` to add the package to your Laravel app.

At `config/app.php`, add the Service Provider and the Facade:

```php
    'providers' => [
        Intentor\LaravelForm\ServiceProvider::class,
    ]

    //...

    'aliases' => [
        'Form' => Intentor\LaravelForm\Facade::class,
    ]

Quick start

To create a form, you can user either Blade helpers or the Form Facade., <sub>(*9)</sub>

Using Blade helpers:, <sub>(*10)</sub>

@form_open(action('SomeController@action'))

@form_close

Using Facades:, <sub>(*11)</sub>

{!! Form::open(action('SomeController@action')) !!}

{!! Form::close() !!}

Any controls you want to create must be placed between the opening and closing of the form., <sub>(*12)</sub>

Using Blade helpers:, <sub>(*13)</sub>

@form_open(action('SomeController@action'))

@form_text('name', 'Name')

@form_buttons('Send', 'Reset')

@form_close

Using Facades:, <sub>(*14)</sub>

{!! Form::open(action('SomeController@action')) !!}

{!! Form::text('name', 'Name') !!}

{!! Form::buttons('Send', 'Reset') !!}

{!! Form::close() !!}

Helpers

open

Opens a form. See Themes for more details on form themes., <sub>(*15)</sub>

Blade helper

@form_open($url, $method = 'POST', $theme = null, $includeCsrfToken = true, $attributes = [])

Facade

{!! Form::open($url, $method = 'POST', $theme = null, $includeCsrfToken = true, $attributes = []) !!}

Parameters

• string $url Action URL.
• string $method Form method.
• bool $theme Controls' theme. It's a subfolder on the partials.form folder.
• bool $includeCsrfToken Indicates whether the CSRF token should be included.
• array $attributes Form attributes.

model

Opens a form for a model. See Themes for more details on form themes., <sub>(*16)</sub>

Blade helper

@form_

Facade

{!! Form::model($model, $url, $method = 'POST', $theme = null, $includeCsrfToken = true, $attributes = []) !!}

Parameters

• object $model Model object.
• string $url Action URL.
• string $method Form method.
• bool $theme Controls' theme. It's a subfolder on the partials.form folder.
• bool $includeCsrfToken Indicates whether the CSRF token should be included.
• array $attributes Form attributes.

close

Closes a from., <sub>(*17)</sub>

Blade helper

@form_close

Facade

{!! Form::close() !!}

Parameters

None., <sub>(*18)</sub>

label

Creates a label., <sub>(*19)</sub>

Blade helper

@form_label($text, $field = null, $attributes = [])

Facade

{!! Form::label($text, $field = null, $attributes = []) !!}

Parameters

• string $text Label text.
• string $field Related field name.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

readonly

Creates a readonly control., <sub>(*20)</sub>

Blade helper

@form_readonly($label, $text, $attributes = [])

Facade

{!! Form::readonly($label, $text, $attributes = []) !!}

Parameters

• string $label Label text.
• string $text Field text.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

hidden

Creates a hidden field., <sub>(*21)</sub>

Blade helper

@form_hidden($name, $value = null, $attributes = [])

Facade

{!! Form::hidden($name, $value = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $value Field value.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

text

Creates a text field., <sub>(*22)</sub>

Blade helper

@form_text($name, $label = null, $attributes = [])

Facade

{!! Form::text($name, $label = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

textarea

Creates a textarea field., <sub>(*23)</sub>

Blade helper

@form_textarea($name, $label = null, $attributes = [])

Facade

{!! Form::textarea($name, $label = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

email

Creates an e-mail field., <sub>(*24)</sub>

Blade helper

@form_email($name, $label = null, $attributes = [])

Facade

{!! Form::email($name, $label = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

url

Creates an URL field., <sub>(*25)</sub>

Blade helper

@form_url($name, $label = null, $attributes = [])

Facade

{!! Form::url($name, $label = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

number

Creates a number field., <sub>(*26)</sub>

Blade helper

@form_number($name, $label = null, $min = 0, $max = 9999, $step = 1, $attributes = [])

Facade

{!! Form::number($name, $label = null, $min = 0, $max = 9999, $step = 1, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• int $min Minimum number.
• int $max Maximum number.
• int $step Combined with the min value, defines the acceptable numbers in the range.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

password

Creates a password field., <sub>(*27)</sub>

Blade helper

@form_password($name, $label = null, $attributes = [])

Facade

{!! Form::password($name, $label = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

checkbox

Creates a checkbox field., <sub>(*28)</sub>

Blade helper

@form_checkbox($name, $label = null, $value = 1, $attributes = [])

Facade

{!! Form::checkbox($name, $label = null, $value = 1, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• string $value Field value.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

radio

Creates a radio field., <sub>(*29)</sub>

Blade helper

@form_radio($name, $label = null, $attributes = [])

Facade

{!! Form::radio($name, $label = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

checkboxGroup

Creates a checkbox group., <sub>(*30)</sub>

Blade helper

@form_checkbox_group($name, $label = null, $list = [], $selected = [], $attributes = [])

Facade

{!! Form::checkboxGroup($name, $label = null, $list = [], $selected = [], $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $list Item's list. Format: [ 'value' => '', 'text' => '' ]. Use modelToList to generate a list from models.
• array $selected Selected values. Format: [ 'value', 'value', ... ]. Use modelToSelected to generate values from models.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

radioGroup

Creates a radio group., <sub>(*31)</sub>

Blade helper

@form_radio_group($name, $label = null, $list = [], $selected = null, $attributes = [])

Facade

{!! Form::radioGroup($name, $label = null, $list = [], $selected = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $list Item's list. Format: [ 'value' => '', 'text' => '' ]. Use modelToList to generate a list from models.
• string $selected Selected value.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

dropdown

Creates a dropdown field., <sub>(*32)</sub>

Blade helper

@form_dropdown($name, $label = null, $list = [], $empty = null, $selected = null, $attributes = [])

Facade

{!! Form::dropdown($name, $label = null, $list = [], $empty = null, $selected = null, $attributes = []) !!}

Parameters

• string $name Field name.
• string $label Field label.
• array $list Item's list. Format: [ 'value' => 'text', 'text' => '' ]. Use modelToList to generate a list from models.
• string $empty Empty value text. If no text is provided, there will not be an empty option.
• string $selected Selected value.
• array $attributes Element attributes. Format: [ 'attribute' => 'value' ].

submit

Creates a submit button., <sub>(*33)</sub>

Blade helper

@form_submit($label)

Facade

{!! Form::submit($label) !!}

Parameters

• string $label Control label.

reset

Creates a reset button., <sub>(*34)</sub>

Blade helper

@form_reset($label)

Facade

{!! Form::reset($label) !!}

Parameters

• string $label Control label.

buttons

Creates form buttons (submit and reset)., <sub>(*35)</sub>

Blade helper

@form_buttons($submitLabel, $resetLabel = null)

Facade

{!! Form::buttons($submitLabel, $resetLabel = null) !!}

Parameters

• string $submitLabel Submit button label.
• string $resetLabel Reset button label. If no label is given, the button is not created.

Utilities

modelToList

Generates an array compatible with lists (dropdowns, checkbox groups, etc.)., <sub>(*36)</sub>

Facade

Form::modelToList($model, $valueField, $textField)

Parameters

• object $model Model to be converted.
• string $valueField Field on data that is the value.
• string $textField Field on data that is the text.

modelToSelected

Generates an array of selected values., <sub>(*37)</sub>

Facade

Form::modelToSelected($model, $valueField)

Parameters

• object $model Model to be converted.
• string $valueField Field on data that is the value.

Themes

Themes are a way to customize the look of forms using partial views., <sub>(*38)</sub>

Available themes

There are three different themes available:, <sub>(*39)</sub>

1. default: a simple form theme without any third party dependencies.
2. horizontal: default Bootstrap horizontal form (Requires Bootstrap 3).
3. vertical: default Bootstrap vertical form (Requires Bootstrap 3).

All themes are subfolders at src/resources/views/partials/form folder., <sub>(*40)</sub>

Creating a custom theme

To create a custom theme, copy a base theme from vendor/intentor/laravel-form/src/resources/views/partials/form at your local Laravel installation to the resources/views/partials/form of your app., <sub>(*41)</sub>

Each helper has its own Blade template file, which can then be customized., <sub>(*42)</sub>

Note: the name of the theme's folder is the name that must be used when setting the theme., <sub>(*43)</sub>

Changelog

Please see CHANGELOG.md., <sub>(*44)</sub>

Support

Found a bug? Please create an issue on the GitHub project page or send a pull request if you have a fix or extension., <sub>(*45)</sub>

You can also send me a message at support@intentor.com.br to discuss more obscure matters about the component., <sub>(*46)</sub>

License

Licensed under the The MIT License (MIT). Please see LICENSE for more information., <sub>(*47)</sub>