https://anahkiasen.github.io/former

A powerful form builder, for Laravel and other frameworks (stand-alone too)
https://anahkiasen.github.io/former

form-builder laravel-package

Last synced: 2 months ago
JSON representation

A powerful form builder, for Laravel and other frameworks (stand-alone too)

• Host: GitHub
• URL: https://anahkiasen.github.io/former
• Owner: formers
• Created: 2012-09-15T02:21:29.000Z (over 12 years ago)
• Default Branch: 4.x
• Last Pushed: 2024-03-22T11:33:23.000Z (9 months ago)
• Last Synced: 2024-05-19T20:45:30.409Z (7 months ago)
• Topics: form-builder, laravel-package
• Language: PHP
• Homepage: https://formers.github.io/former/
• Size: 3.02 MB
• Stars: 1,343
• Watchers: 65
• Forks: 207
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md

Awesome Lists containing this project

• awesome-laravel - Former - Package to structure and format web forms in Laravel idiomatic style. (Packages / Web Forms)
• awesome-laravel - Former - Package to structure and format web forms in Laravel idiomatic style. (Packages / Web Forms)

README

        
# Former

## A Laravelish way to create and format forms

[![Latest Stable Version](http://img.shields.io/packagist/v/anahkiasen/former.svg?style=flat)](https://packagist.org/packages/anahkiasen/former)

[![Total Downloads](http://img.shields.io/packagist/dt/anahkiasen/former.svg?style=flat)](https://packagist.org/packages/anahkiasen/former)

Former outputs form elements in HTML compatible with your favorite CSS framework (Bootstrap and Foundation are currently supported). Former also handles repopulation after validation errors, including automatically rendering error text with affected fields.

### Introduction

Former provides a fluent method of form creation, allowing you to do:

```php

Former::framework('TwitterBootstrap3');

Former::horizontal_open()

  ->id('MyForm')

  ->rules(['name' => 'required'])

  ->method('GET');

  Former::xlarge_text('name') # Bootstrap sizing

    ->class('myclass') # arbitrary attribute support

    ->label('Full name')

    ->value('Joseph')

    ->required() # HTML5 validation

    ->help('Please enter your full name');

  Former::textarea('comments')

    ->rows(10)

    ->columns(20)

    ->autofocus();

  Former::actions()

    ->large_primary_submit('Submit') # Combine Bootstrap directives like "lg and btn-primary"

    ->large_inverse_reset('Reset');

Former::close();

```

Every time you call a method that doesn't actually exist, Former assumes you're trying to set an attribute and creates it magically. That's why you can do in the above example `->rows(10)` ; in case you want to set attributes that contain dashes, just replace them by underscores : `->data_foo('bar')` equals `data-foo="bar"`.

Now of course in case you want to set an attribute that actually contains an underscore you can always use the fallback method `setAttribute('data_foo', 'bar')`. You're welcome.

This is the core of it, but Former offers a lot more. I invite you to consult the wiki to see the extent of what Former does.

-----

### Installation

Require Former package using Composer:

    composer require anahkiasen/former

Publish config files with artisan:

    

    php artisan vendor:publish --provider="Former\FormerServiceProvider"

#### App.php config for Laravel 5.4 and below

For Laravel 5.4 and below, you must modify your `config/app.php`.

In the `providers` array add :

    Former\FormerServiceProvider::class

Add then alias Former's main class by adding its facade to the `aliases` array in the same file :

    'Former' => 'Former\Facades\Former',

-----

### Documentation

Please refer to the [wiki](https://github.com/formers/former/wiki) for the full documentation.