elao/form-bundle

Various Form improvements

ElaoFormBundle

Best served with Elao/form.js!, _(*1)

Tools & enhancements for Symfony 2 forms, _(*2)

Installation:

Add ElaoFormBundle to your composer.json:, _(*3)

``` bash $ composer require "elao/form-bundle":"~2.1", <sub>(*4)</sub>

Enable the bundle in the kernel:

``` php
<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Elao\Bundle\FormBundle\ElaoFormBundle(),
    );
}

Usage:

Use the provided form template, globally:, <sub>(*5)</sub>

``` yaml, <sub>(*6)</sub>

Twig Configuration

twig: form_themes: - "@ElaoForm/Form/form_elao_layout.html.twig", <sub>(*7)</sub>

Or on a specific form:

``` twig
{% form_theme form '@ElaoForm/Form/form_elao_layout.html.twig' %}

Features:

Collections:

Provide support for collection:, <sub>(*8)</sub>

$('[data-collection]').collection();

Note: For more details, see Elao/form.js collection documentation., <sub>(*9)</sub>

Help:

Provide an help option that automatically adds an help block to the field. Use as below:, <sub>(*10)</sub>

$builder->add('email', EmailType::class, array('help' => "A valid email address"));

Note: The help string is gonna be translated by default just like the label of the field., <sub>(*11)</sub>

Buttons:

Provide sortcut for adding submit and reset buttons: All form have now an optional option "submit" and "reset", setting it to true adds a default submit/reset button, <sub>(*12)</sub>

$form = $this->createForm(PostType::class, $post, array('submit' => true, 'reset' => true));