galahad/forms

Base for builder

Monday, February 19, 2018
by inxilpro
Repository
1 Watchers
3 Stars
1,814 Installations

PHP
1 Dependents
0 Suggesters
89 Forks
0 Open issues
45 Versions
63 % Grown

The README.md

, _(*1)

Galahad/Forms

Build HTML forms with a fluent syntax., _(*2)

Installation
Basic Usage
Remembering Old Input
Error Messages
CSRF Protection
Data Binding

, _(*3)

Installation

You can install this package via Composer by running this command in your terminal in the root of your project:, _(*4)

composer require galahad/forms

Laravel

This package will be auto-discovered in Laravel 5.5., _(*5)

, _(*6)

, _(*7)

Getting Started

First, instantiate a FormBuilder..., _(*8)

$builder = new Galahad\Forms\FormBuilder;

Next, use the FormBuilder to build an element. For example:, _(*9)

// <input type="text" name="email" value="example@example.com" required="required">
<?= $builder->text('email')->value('example@example.com')->required(); ?>

All elements support method chaining, so you can add as many options to an element as you need.
All elements implement __toString() so there is no need to manually render.

, _(*10)

Opening a Form

// 

<

form method="POST">
= $builder->open(); ?>

// 

<

form method="GET">
= $builder->open()->get(); ?>

// 

<

form method="POST">
// <input type="hidden" name="_method" value="PUT">
= $builder->open()->put(); ?>

// 

<

form method="POST">
// <input type="hidden" name="_method" value="DELETE">
= $builder->open()->delete(); ?>

// 

<

form method="POST" action="/test">
= $builder->open()->action('/test'); ?>

// 

<

form method="POST" action="" enctype="multipart/form-data">
= $builder->open()->multipart() ?>

// 

<

form method="POST" action="" enctype="custom">
= $builder->open()->encodingType("custom") ?>

, _(*11)

Text and Password Fields

Text and password fields share the same interface., _(*12)

// <input type="text" name="email">
= $builder->text('email'); ?>

// <input type="text" name="email" id="email_field">
= $builder->text('email')->id('email_field'); ?>

// <input type="password" name="password" class="required">
= $builder->password('password')->addClass('required'); ?>

// <input type="text" name="email" value="example@example.com" required="required">
= $builder->text('email')->value('example@example.com')->required(); ?>

Other available methods:, _(*13)

placeholder($string)
optional()
defaultValue($string)
disable()
enable()

, _(*14)

Textareas

Textareas share the same interface as regular text fields, with a couple of extra useful methods., _(*15)

// <textarea name="bio" rows="5" cols="50"></textarea>
= $builder->textarea('bio')->rows(5); ?>

// <textarea name="bio" rows="10" cols="20"></textarea>
= $builder->textarea('bio')->cols(20); ?>

// <textarea name="bio" rows="5" cols="20" class="important">My biography</textarea>
= $builder->textarea('bio')->rows(5)->cols(20)->addClass('important')->value('My biography'); ?>

, _(*16)

Checkboxes and Radio Buttons

// <input type="checkbox" name="terms" value="1">
= $builder->checkbox('terms'); ?>

// <input type="checkbox" name="terms" value="1" checked="checked">
= $builder->checkbox('terms')->check(); ?>

// <input type="checkbox" name="terms" value="1">
= $builder->checkbox('terms')->uncheck(); ?>

// <input type="checkbox" name="terms" value="1" checked="checked">
= $builder->checkbox('terms')->defaultToChecked(); ?>

// <input type="checkbox" name="terms" value="agree">
= $builder->checkbox('terms')->value('agree'); ?>

// <input type="radio" name="color" value="red">
= $builder->radio('color', 'red'); ?>

, _(*17)

Selects

// <select name="birth_year"></select>
= $builder->select('birth_year'); ?>

// <select name="birth_year">
//   <option value="0">1990</option>
//   <option value="1">1991</option>
//   <option value="2">1992</option>
// </select>
= $builder->select('birth_year', [1990, 1991, 1992]); ?>

// <select name="birth_year">
//   <option value="1990">1990</option>
//   <option value="1991">1991</option>
//   <option value="1992">1992</option>
// </select>
= $builder->select('birth_year', ['1990' => 1990, '1991' => 1991, '1992' => 1992]); ?>

// <select name="birth_year">
//   <optgroup label="Ontario">
//     <option value="toronto">Toronto</option>
//     <option value="ottawa">Ottawa</option>
//   </optgroup>
//   <optgroup label="Quebec">
//     <option value="montreal">Montreal</option>
//     <option value="quebec_city">Quebec City</option>
//   </optgroup>
// </select>
$options = [
    'Ontario' => [
        'toronto' => 'Toronto',
        'ottawa' => 'Ottawa',
    ],
    'Quebec' => [
        'montreal' => 'Montreal',
        'quebec_city' => 'Quebec City',
    ]
];

= $builder->select('birth_year', $options); ?>

// <select name="birth_year">
//   <option value="1">1990</option>
// </select>
= $builder->select('birth_year')->addOption('1', 1990); ?>

// <select name="birth_year">
//   <option value="1">1990</option>
//   <option value="2">1991</option>
//   <option value="3" selected>1992</option>
// </select>
= $builder->select('birth_year', ['1' => 1990, '2' => 1991, '3' => 1992])->select('3'); ?>

, _(*18)

Buttons

// <button type="button">Click Me</button>
= $builder->button('Click Me'); ?>

// <button type="submit">Sign Up</button>
= $builder->submit('Sign Up'); ?>

// <button type="reset">Reset Form</button>
= $builder->reset('Reset Form'); ?>

// <button type="submit" class="js-submit">Sign Up</button>
= $builder->submit('Sign Up')->addClass('js-submit'); ?>

, _(*19)

Hidden Inputs

// <input type="hidden" name="secret" value="my-secret-value">
<?= $builder->hidden('secret')->value('my-secret-value'); ?>

, _(*20)

Labels

Basic Label, _(*21)

// <label>Email</label>
= $builder->label('Email'); ?>

// <label for="email">Email</label>
= $builder->label('Email')->forId('email'); ?>

Wrapping another element, _(*22)

// <label>Email<input type="text" name="email"></label>
= $builder->label('Email')->before($emailElement); ?>

// <label><input type="text" name="email">Email</label>
= $builder->label('Email')->after($emailElement); ?>

, _(*23)

Setting Attributes

// Attributes can be set with attribute(...)
// <input type="text" name="foobar" min="4">
= $builder->text('foobar')->attribute('min', 4); ?>

// Or by calling the attribute name as a method
// <input type="text" name="foobar" min="4">
= $builder->text('foobar')->min(4); ?>

// Setting data-* attributes
// <input type="text" data-foo="bar" name="foobar">
= $builder->text('foobar')->data('foo', 'bar'); ?>

// Multiple data-* attributes can be set at once
// <input type="text" data-foo="bar" data-bar="foo" name="foobar">
= $builder->text('foobar')->data(['foo' => 'bar', 'bar' => 'foo']); ?>

, _(*24)

Remembering Old Input

The FormBuilder can remember old input and prepopulate your form fields if you redirect back to the form because of a validation error., _(*25)

To make this work, you must create a class that implements the OldInputInterface and pass it to the FormBuilder:, _(*26)

$builder->setOldInputProvider($myOldInputProvider);

Now, your form elements will automatically populate with the user's old input data if it is available., _(*27)

This works well with the defaultValue() methods, allowing you to set a default value that will be overridden by old input if the user has already submitted the form., _(*28)

This package ships with a Laravel implementation out of the box, called IlluminateOldInput., _(*29)

, _(*30)

Error Messages

FormBuilder also allows you to easily retrieve error messages for your form elements. To do so, just implement the ErrorStoreInterface and pass it to the FormBuilder:, _(*31)

$builder->setErrorStore($myErrorStore);

This package ships with a Laravel implementation out of the box, called IlluminateErrorStore., _(*32)

// Check if the form has an error for an element
$builder->hasError('email');

// Retrieve the error message for an element
$builder->getError('email');

You can also supply a format parameter to getError() to cleanup your markup. Instead of doing this:, _(*33)

<?php if ($builder->hasError('email')): ?>
    <span class="error"><?= $builder->getError('email'); ?></span>
<?php endif; ?>

...you can simply do this, which will display the formatted message if it exists, or nothing otherwise., _(*34)

<?= $builder->getError('email', '<span class="error">:message</span'); ?>

, _(*35)

CSRF Protection

Assuming you set a CSRF token when instantiating the Formbuilder (or you are using Laravel), add a CSRF token to your form easily like so:, _(*36)

<?= $builder->token(); ?>

, _(*37)

Data Binding

Sometimes you might have a form where all of the fields match properties on some sort of object or array in your system, and you want the user to be able to edit that data. Data binding makes this really easy by allowing you to bind an object or array to your form that will be used to automatically provide all of the default values for your fields., _(*38)

$model->first_name = "John";
$model->last_name = "Doe";
$model->email = "john@example.com";
$model->date_of_birth = new DateTime('1985-05-06');

= $builder->open(); ?>
= $builder->bind($model); ?>
= $builder->text('first_name'); ?>
= $builder->text('last_name'); ?>
= $builder->email('email'); ?>
= $builder->date('date_of_birth'); ?>
= $builder->close(); ?>

This will work out of the box with Laravel's Eloquent models., _(*39)

When using data binding, old input will still take priority over any of your bound values, so you can still easily redirect the user back to the form with any validation errors without losing any of the data they entered., _(*40)

Note: Be sure to bind before creating any other form elements., _(*41)

The Versions

19/02 2018

dev-master

9999999-dev

Base for builder

library forms

Base for builder

galahad/forms

The README.md

Galahad/Forms

Installation

Laravel

Basic Usage

Getting Started

Opening a Form

Text and Password Fields

Textareas

Checkboxes and Radio Buttons

Selects

Buttons

Hidden Inputs

Labels

Setting Attributes

Remembering Old Input

Error Messages

CSRF Protection

Data Binding

The Versions

dev-master

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

1.1.0

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v1.0.10

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v1.0.9

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v1.0.8

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v1.0.7

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v1.0.0

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v1.0.1

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v1.0.5

The Requires

The Development Requires

by Adam Wathan

by Chris Morrell

v0.9.0

The Requires

The Development Requires

by Adam Wathan

v0.8.13

The Requires

The Development Requires

by Adam Wathan

v0.8.12

The Requires

The Development Requires

by Adam Wathan