PHP Class Symfony\Component\Form\FieldGroup

Author: Fabien Potencier ([email protected])

Inheritance: extends Field, implements IteratorAggregate, implements Symfony\Component\Form\FieldGroupInterface

Afficher le fichier Open project: pmjones/php-framework-benchmarks Class Usage Examples

Protected Properties

Свойство	Type	Description
$extraFields	array	Contains the names of bound values who don't belong to any fields
$fields	array	Contains all the fields of this group

Méthodes publiques

Méthode	Description
__clone ( )	Clones this group
add ( Symfony\Component\Form\FieldInterface $field )	Adds a new field to this group. A field must have a unique name within the group. Otherwise the existing field is overwritten.
addError ( Symfony\Component\Form\FieldError $error, Symfony\Component\Form\PropertyPathIterator $pathIterator = null, $type = null )	{@inheritDoc}
bind ( string \| array $taintedData ) : boolean	Binds POST data to the field, transforms and validates it.
count ( ) : integer	Returns the number of form fields (implements the \Countable interface).
get ( string $key ) : Symfony\Component\Form\FieldInterface	Returns the field with the given key.
getAllHiddenFields ( ) : array	Returns an array of hidden fields from the current schema.
getAllVisibleFields ( ) : array	Returns an array of visible fields from the current schema.
getDisplayedData ( )	Returns the data of the field as it is displayed to the user.
getFields ( ) : array	Returns all fields in this group
getHiddenFields ( ) : array	Returns an array of hidden fields from the current schema.
getIterator ( ) : ArrayIterator	Returns the iterator for this group.
getVisibleFields ( ) : array	Returns an array of visible fields from the current schema.
has ( string $key ) : boolean	Returns whether a field with the given key exists.
isBoundWithExtraFields ( ) : boolean	Returns whether this form was bound with extra fields
isMultipart ( ) : boolean	Returns whether the field requires a multipart form.
isValid ( ) : boolean	Returns whether the field is valid.
merge ( FieldGroup $group )	Merges a field group into this group. The group must have a unique name within the group. Otherwise the existing field is overwritten.
offsetExists ( string $key ) : boolean	Returns true if the bound field exists (implements the \ArrayAccess interface).
offsetGet ( string $key ) : Field	Returns the form field associated with the name (implements the \ArrayAccess interface).
offsetSet ( $key, $field )	Throws an exception saying that values cannot be set (implements the \ArrayAccess interface).
offsetUnset ( string $key )	Throws an exception saying that values cannot be unset (implements the \ArrayAccess interface).
remove ( string $key )	Removes the field with the given key.
setData ( $data )	Initializes the field group with an object to operate on
setLocale ( $locale )	Sets the locale of this field.

Méthodes protégées

Méthode	Description
getFieldsByVisibility ( boolean $hidden, boolean $recursive ) : array	Returns a filtered array of fields from the current schema.
preprocessData ( array $data ) : array	Processes the bound data before it is passed to the individual fields

Method Details

__clone() public méthode

Clones this group

public __clone ( )

add() public méthode

If you add a nested group, this group should also be represented in the object hierarchy. If you want to add a group that operates on the same hierarchy level, use merge().


class Entity
{
  public $location;
}

class Location
{
  public $longitude;
  public $latitude;
}

$entity = new Entity();
$entity->location = new Location();

$form = new Form('entity', $entity, $validator);

$locationGroup = new FieldGroup('location');
$locationGroup->add(new TextField('longitude'));
$locationGroup->add(new TextField('latitude'));

$form->add($locationGroup);

public add ( Symfony\Component\Form\FieldInterface $field )
$field	Symfony\Component\Form\FieldInterface

addError() public méthode

{@inheritDoc}

public addError ( Symfony\Component\Form\FieldError $error, Symfony\Component\Form\PropertyPathIterator $pathIterator = null, $type = null )
$error	Symfony\Component\Form\FieldError
$pathIterator	Symfony\Component\Form\PropertyPathIterator

bind() public méthode

Binds POST data to the field, transforms and validates it.

public bind ( string \| array $taintedData ) : boolean
$taintedData	string \| array	The POST data
Résultat	boolean	Whether the form is valid

count() public méthode

Returns the number of form fields (implements the \Countable interface).

public count ( ) : integer
Résultat	integer	The number of embedded form fields

get() public méthode

Returns the field with the given key.

public get ( string $key ) : Symfony\Component\Form\FieldInterface
$key	string
Résultat	Symfony\Component\Form\FieldInterface

getAllHiddenFields() public méthode

This variant of the method will recursively get all the fields from the nested forms or field groups

public getAllHiddenFields ( ) : array
Résultat	array

getAllVisibleFields() public méthode

This variant of the method will recursively get all the fields from the nested forms or field groups

public getAllVisibleFields ( ) : array
Résultat	array

getDisplayedData() public méthode

Returns the data of the field as it is displayed to the user.

getFields() public méthode

Returns all fields in this group

public getFields ( ) : array
Résultat	array

getFieldsByVisibility() protected méthode

Returns a filtered array of fields from the current schema.

protected getFieldsByVisibility ( boolean $hidden, boolean $recursive ) : array
$hidden	boolean	Whether to return hidden fields only or visible fields only
$recursive	boolean	Whether to recur through embedded schemas
Résultat	array

getHiddenFields() public méthode

Returns an array of hidden fields from the current schema.

public getHiddenFields ( ) : array
Résultat	array

getIterator() public méthode

Returns the iterator for this group.

public getIterator ( ) : ArrayIterator
Résultat	ArrayIterator

getVisibleFields() public méthode

Returns an array of visible fields from the current schema.

public getVisibleFields ( ) : array
Résultat	array

has() public méthode

Returns whether a field with the given key exists.

public has ( string $key ) : boolean
$key	string
Résultat	boolean

isBoundWithExtraFields() public méthode

Returns whether this form was bound with extra fields

public isBoundWithExtraFields ( ) : boolean
Résultat	boolean

isMultipart() public méthode

Returns whether the field requires a multipart form.

public isMultipart ( ) : boolean
Résultat	boolean

isValid() public méthode

Returns whether the field is valid.

public isValid ( ) : boolean
Résultat	boolean

merge() public méthode

Contrary to added groups, merged groups operate on the same object as the group they are merged into.


class Entity
{
  public $longitude;
  public $latitude;
}

$entity = new Entity();

$form = new Form('entity', $entity, $validator);

$locationGroup = new FieldGroup('location');
$locationGroup->add(new TextField('longitude'));
$locationGroup->add(new TextField('latitude'));

$form->merge($locationGroup);

public merge ( FieldGroup $group )
$group	FieldGroup

offsetExists() public méthode

Returns true if the bound field exists (implements the \ArrayAccess interface).

public offsetExists ( string $key ) : boolean
$key	string	The key of the bound field
Résultat	boolean	true if the widget exists, false otherwise

offsetGet() public méthode

Returns the form field associated with the name (implements the \ArrayAccess interface).

public offsetGet ( string $key ) : Field
$key	string	The offset of the value to get
Résultat	Field	A form field instance

offsetSet() public méthode

Throws an exception saying that values cannot be set (implements the \ArrayAccess interface).

public offsetSet ( $key, $field )

offsetUnset() public méthode

Throws an exception saying that values cannot be unset (implements the \ArrayAccess interface).

public offsetUnset ( string $key )
$key	string

preprocessData() protected méthode

The data is in the user format.

protected preprocessData ( array $data ) : array
$data	array
Résultat	array

remove() public méthode

Removes the field with the given key.

public remove ( string $key )
$key	string

setData() public méthode

Initializes the field group with an object to operate on

setLocale() public méthode

Sets the locale of this field.

Property Details

$extraFields protected_oe property

Contains the names of bound values who don't belong to any fields

protected array $extraFields
Résultat	array

$fields protected_oe property

Contains all the fields of this group

protected array $fields
Résultat	array