Download the PHP package imatic/form-bundle without Composer

ImaticFormBundle

Form types

• Imatic\Bundle\FormBundle\Form\Type\AjaxChoiceType
• Imatic\Bundle\FormBundle\Form\Type\AjaxEntityChoiceType
• Imatic\Bundle\FormBundle\Form\Type\DateRangeType
• Imatic\Bundle\FormBundle\Form\Type\DateTimeRangeType
• Imatic\Bundle\FormBundle\Form\Type\RangeType

Ajax entity choice

Implements choice of single entity or collection of entities using XHR.

Dependencies: jQuery, Select2

The widget will send a GET request to the specified route with the entered search term. The request format depends on the request_type option:

• filter - ?filter[search][value]=term
• simple - ?search=term

The application should reply with a JSON response, example:

Additional options:

• multiple - allow multiple items to be selected
• placeholder - text displayed if no item is selected
• query_builder - instance of QueryBuilder or Closure(EntityManager \$em, \$class): QueryBuilder
• id_provider - callable(object \$entity): scalar (should return ID of the entity)
• text_provider - callable(object \$item): string (should return text representation of the entity)
• request_type - filter (default) or simple
• route_attrs - custom route attributes
• entity_manager - name of the entity manager to use

Datepicker

• Imatic\Bundle\FormBundle\Form\Extension\DatepickerExtension

This example shows, how to change default date type format and modify moment configurations by form extension.

Collections

This bundle provides JS functionality needed to add, edit and delete elements of the collection. By default, newly added items are prefixed with new_ and random number e.g. new_16782845986841. But this can cause mistakes in server-side validation.

From version 5.2. is possible define data_index with true or numeric value in collection definition to count items in collection from 0...N. If collection can be loaded with existing data, number of items should be specified in data_index value.

Form extensions

Form theme

This extensions allows you to set form theme through the type\'s options.

Validator constraints

Number

• ensures that number have correct precision and scale

options

• precision
• scale

Latitude

Longtitude

NotNullGroup

This class-level constraint ensures that all given properties are either set or null.

Valid states: all properties are null, all properties are NOT null.

NotNullOneOf

This class-level constraint ensures that at least one of the given properties is NOT null.

Valid states: at least one property is NOT null

Example

Data transformers

EmptyEntityToNullTransformer

This transformers converts an entity object to null, if it is considered empty. The check is performed based on list of properties that are to be verified.

If strict mode is disabled (default), both nulls and empty strings are considered empty.

If strict mode is enabled, only nulls are considered empty.