Skip to content

Elao/ElaoFormBundle

Repository files navigation

ElaoFormBundle

Best served with Elao/form.js!

Tools & enhancements for Symfony 2 forms

Installation:

Add ElaoFormBundle to your composer.json:

$ composer require "elao/form-bundle":"~2.1"

Enable the bundle in the kernel:

<?php
// app/AppKernel.php

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

Usage:

Use the provided form template, globally:

# Twig Configuration
twig:
    form_themes:
        - "@ElaoForm/Form/form_elao_layout.html.twig"

Or on a specific form:

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

Features:

Collections:

Provide support for collection:

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

Note: For more details, see Elao/form.js collection documentation.

Help:

Provide an help option that automatically adds an help block to the field. Use as below:

$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.

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

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