nf/form

Form builder

1.0.2 2018-01-10 18:09 UTC

MIT

• Hieupv

README

• Installation
• Opening A Form
• Labels
• Text, Text Area, Password & Hidden Fields
• Checkboxes and Radio Buttons
• File Input
• Number Input
• Date Input
• Drop-Down Lists
• Buttons

Installation

Begin by installing this package through Composer.

composer require nf/form

Opening A Form

$form = Form::open(['url' => 'foo/bar', 'method' => 'post', 'files' => true]);

$form .= Form::close();

echo $form;

You may also use it in view file

{!! Form::open(['url' => 'foo/bar', 'method' => 'post', 'files' => true]) !!}
    //
{!! Form::close() !!}

Labels

Generating A Label Element

echo Form::label('email', 'E-Mail Address');

Specifying Extra HTML Attributes

echo Form::label('email', 'E-Mail Address', ['class' => 'awesome']);

Note: After creating a label, any form element you create with a name matching the label name will automatically receive an ID matching the label name as well.

Text, Text Area, Password & Hidden Fields

Generating A Text Input

echo Form::text('username');

Specifying A Default Value

echo Form::text('email', '[e-mail]');

Note: The hidden and textarea methods have the same signature as the text method.

Generating A Password Input

echo Form::password('password', ['class' => 'awesome']);

Generating Other Inputs

echo Form::email($name, $value = null, $attributes = []);
echo Form::file($name, $attributes = []);

Checkboxes and Radio Buttons

Generating A Checkbox Or Radio Input

echo Form::checkbox('name', 'value');

echo Form::radio('name', 'value');

Generating A Checkbox Or Radio Input That Is Checked

echo Form::checkbox('name', 'value', true);

echo Form::radio('name', 'value', true);

Number

Generating A Number Input

echo Form::number('name', 'value');

Date

Generating A Date Input

echo Form::date('name', \Carbon\Carbon::now());

File Input

Generating A File Input

echo Form::file('image');

Note: The form must have been opened with the files option set to true.

Drop-Down Lists

Generating A Drop-Down List

echo Form::select('size', ['L' => 'Large', 'S' => 'Small']);

Generating A Drop-Down List With Selected Default

echo Form::select('size', ['L' => 'Large', 'S' => 'Small'], 'S');

Generating a Drop-Down List With an Empty Placeholder

This will create an <option> element with no value as the very first option of your drop-down.

echo Form::select('size', ['L' => 'Large', 'S' => 'Small'], null, ['placeholder' => 'Pick a size...']);

Generating A Grouped List

echo Form::select('animal',[
    'Cats' => ['leopard' => 'Leopard'],
    'Dogs' => ['spaniel' => 'Spaniel'],
]);

Generating A Drop-Down List With A Range

echo Form::selectRange('number', 10, 20);

Generating A List With Month Names

echo Form::selectMonth('month');

Generating A List of years

echo Form::year('year', 1990, 2018);

Buttons

Generating A Submit Button

echo Form::submit('Click Me!');

Note: Need to create a button element? Try the button method. It has the same signature as submit.