mediatekformation

FormBuilderInterface extends Traversable, Countable, FormConfigBuilderInterface
in

Tags
author

Bernhard Schussek bschussek@gmail.com

extends

\Traversable<string, self>

Table of Contents

add()  : self
Adds a new field to this group. A field must have a unique name within the group. Otherwise the existing field is overwritten.
addEventListener()  : $this
Adds an event listener to an event on this form.
addEventSubscriber()  : $this
Adds an event subscriber for events on this form.
addModelTransformer()  : $this
Prepends / appends a transformer to the normalization transformer chain.
addViewTransformer()  : $this
Appends / prepends a transformer to the view transformer chain.
all()  : array<string, self>
Returns the children.
create()  : self
Creates a form builder.
get()  : self
Returns a child by name.
getAction()  : string
Returns the target URL of the form.
getAttribute()  : mixed
Returns the value of the given attribute.
getAttributes()  : array<string|int, mixed>
Returns additional attributes of the form.
getAutoInitialize()  : bool
Returns whether the form should be initialized upon creation.
getByReference()  : bool
Returns whether the form's data should be modified by reference.
getCompound()  : bool
Returns whether the form is compound.
getData()  : mixed
Returns the initial data of the form.
getDataClass()  : string|null
Returns the class of the view data or null if the data is scalar or an array.
getDataLocked()  : bool
Returns whether the form's data is locked.
getDataMapper()  : DataMapperInterface|null
Returns the data mapper of the compound form or null for a simple form.
getDisabled()  : bool
Returns whether the form is disabled.
getEmptyData()  : mixed
Used when the view data is empty on submission.
getErrorBubbling()  : bool
Returns whether errors attached to the form will bubble to its parent.
getEventDispatcher()  : EventDispatcherInterface
Returns the event dispatcher used to dispatch form events.
getForm()  : FormInterface
Creates the form.
getFormConfig()  : FormConfigInterface
Builds and returns the form configuration.
getFormFactory()  : FormFactoryInterface
Returns the form factory used for creating new forms.
getInheritData()  : bool
Returns whether the form should read and write the data of its parent.
getMapped()  : bool
Returns whether the form should be mapped to an element of its parent's data.
getMethod()  : string
Returns the HTTP method used by the form.
getModelTransformers()  : array<string|int, DataTransformerInterface>
Returns the model transformers of the form.
getName()  : string
Returns the name of the form used as HTTP parameter.
getOption()  : mixed
Returns the value of a specific option.
getOptions()  : array<string, mixed>
Returns all options passed during the construction of the form.
getPropertyPath()  : PropertyPathInterface|null
Returns the property path that the form should be mapped to.
getRequestHandler()  : RequestHandlerInterface
Returns the request handler used by the form.
getRequired()  : bool
Returns whether the form is required.
getType()  : ResolvedFormTypeInterface
Returns the resolved form type used to construct the form.
getViewTransformers()  : array<string|int, DataTransformerInterface>
Returns the view transformers of the form.
has()  : bool
Returns whether a field with the given name exists.
hasAttribute()  : bool
Returns whether the attribute with the given name exists.
hasOption()  : bool
Returns whether a specific option exists.
remove()  : self
Removes the field with the given name.
resetModelTransformers()  : $this
Clears the normalization transformers.
resetViewTransformers()  : $this
Clears the view transformers.
setAction()  : $this
Sets the target URL of the form.
setAttribute()  : $this
Sets the value for an attribute.
setAttributes()  : $this
Sets the attributes.
setAutoInitialize()  : $this
Sets whether the form should be initialized automatically.
setByReference()  : $this
Sets whether the form's data should be modified by reference.
setCompound()  : $this
Sets whether the form should be compound.
setData()  : $this
Sets the initial data of the form.
setDataLocked()  : $this
Locks the form's data to the data passed in the configuration.
setDataMapper()  : $this
Sets the data mapper used by the form.
setDisabled()  : $this
Sets whether the form is disabled.
setEmptyData()  : $this
Sets the data used for the client data when no value is submitted.
setErrorBubbling()  : $this
Sets whether errors bubble up to the parent.
setFormFactory()  : mixed
Sets the form factory used for creating new forms.
setInheritData()  : $this
Sets whether the form should read and write the data of its parent.
setMapped()  : $this
Sets whether the form should be mapped to an element of its parent's data.
setMethod()  : $this
Sets the HTTP method used by the form.
setPropertyPath()  : $this
Sets the property path that the form should be mapped to.
setRequestHandler()  : $this
Sets the request handler used by the form.
setRequired()  : $this
Sets whether this field is required to be filled out when submitted.
setType()  : $this
Sets the resolved type.

Methods

add()

Adds a new field to this group. A field must have a unique name within the group. Otherwise the existing field is overwritten.

public add(string|FormBuilderInterface $child[, string|null $type = null ][, array<string, mixed> $options = [] ]) : self

If you add a nested group, this group should also be represented in the object hierarchy.

Parameters
$child : string|FormBuilderInterface
$type : string|null = null
$options : array<string, mixed> = []
Return values
self —

addEventListener()

Adds an event listener to an event on this form.

public addEventListener(string $eventName, callable $listener, int $priority) : $this
Parameters
$eventName : string

The name of the event to listen to

$listener : callable

The listener to execute

$priority : int

The priority of the listener. Listeners with a higher priority are called before listeners with a lower priority.

Return values
$this —

The configuration object

addModelTransformer()

Prepends / appends a transformer to the normalization transformer chain.

public addModelTransformer(DataTransformerInterface $modelTransformer[, bool $forceAppend = false ]) : $this

The transform method of the transformer is used to convert data from the model to the normalized format. The reverseTransform method of the transformer is used to convert from the normalized to the model format.

Parameters
$modelTransformer : DataTransformerInterface
$forceAppend : bool = false

If set to true, append instead of prepending

Return values
$this —

The configuration object

addViewTransformer()

Appends / prepends a transformer to the view transformer chain.

public addViewTransformer(DataTransformerInterface $viewTransformer[, bool $forcePrepend = false ]) : $this

The transform method of the transformer is used to convert data from the normalized to the view format. The reverseTransform method of the transformer is used to convert from the view to the normalized format.

Parameters
$viewTransformer : DataTransformerInterface
$forcePrepend : bool = false

If set to true, prepend instead of appending

Return values
$this —

The configuration object

all()

Returns the children.

public all() : array<string, self>
Return values
array<string, self> —

create()

Creates a form builder.

public create(string $name[, string|null $type = null ][, array<string, mixed> $options = [] ]) : self
Parameters
$name : string

The name of the form or the name of the property

$type : string|null = null

The type of the form or null if name is a property

$options : array<string, mixed> = []
Return values
self —

getAction()

Returns the target URL of the form.

public getAction() : string
Return values
string —

The target URL of the form

getAttribute()

Returns the value of the given attribute.

public getAttribute(string $name[, mixed $default = null ]) : mixed
Parameters
$name : string

The attribute name

$default : mixed = null

The value returned if the attribute does not exist

Return values
mixed —

The attribute value

getAttributes()

Returns additional attributes of the form.

public getAttributes() : array<string|int, mixed>
Return values
array<string|int, mixed> —

An array of key-value combinations

getAutoInitialize()

Returns whether the form should be initialized upon creation.

public getAutoInitialize() : bool
Return values
bool —

returns true if the form should be initialized when created, false otherwise

getByReference()

Returns whether the form's data should be modified by reference.

public getByReference() : bool
Return values
bool —

Whether to modify the form's data by reference

getCompound()

Returns whether the form is compound.

public getCompound() : bool

This property is independent of whether the form actually has children. A form can be compound and have no children at all, like for example an empty collection form. The contrary is not possible, a form which is not compound cannot have any children.

Return values
bool —

Whether the form is compound

getData()

Returns the initial data of the form.

public getData() : mixed
Return values
mixed —

The initial form data

getDataClass()

Returns the class of the view data or null if the data is scalar or an array.

public getDataClass() : string|null
Return values
string|null —

The data class or null

getDataLocked()

Returns whether the form's data is locked.

public getDataLocked() : bool

A form with locked data is restricted to the data passed in this configuration. The data can only be modified then by submitting the form.

Return values
bool —

Whether the data is locked

getDisabled()

Returns whether the form is disabled.

public getDisabled() : bool
Return values
bool —

Whether the form is disabled

getEmptyData()

Used when the view data is empty on submission.

public getEmptyData() : mixed

When the form is compound it will also be used to map the children data.

The empty data must match the view format as it will passed to the first view transformer's "reverseTransform" method.

Return values
mixed —

The data used when the submitted form is initially empty

getErrorBubbling()

Returns whether errors attached to the form will bubble to its parent.

public getErrorBubbling() : bool
Return values
bool —

Whether errors will bubble up

getInheritData()

Returns whether the form should read and write the data of its parent.

public getInheritData() : bool
Return values
bool —

Whether the form should inherit its parent's data

getMapped()

Returns whether the form should be mapped to an element of its parent's data.

public getMapped() : bool
Return values
bool —

Whether the form is mapped

getMethod()

Returns the HTTP method used by the form.

public getMethod() : string
Return values
string —

The HTTP method of the form

getName()

Returns the name of the form used as HTTP parameter.

public getName() : string
Return values
string —

The form name

getOption()

Returns the value of a specific option.

public getOption(string $name[, mixed $default = null ]) : mixed
Parameters
$name : string

The option name

$default : mixed = null

The value returned if the option does not exist

Return values
mixed —

The option value

getOptions()

Returns all options passed during the construction of the form.

public getOptions() : array<string, mixed>
Return values
array<string, mixed> —

The passed options

getRequired()

Returns whether the form is required.

public getRequired() : bool
Return values
bool —

Whether the form is required

has()

Returns whether a field with the given name exists.

public has(string $name) : bool
Parameters
$name : string
Return values
bool —

hasAttribute()

Returns whether the attribute with the given name exists.

public hasAttribute(string $name) : bool
Parameters
$name : string

The attribute name

Return values
bool —

Whether the attribute exists

hasOption()

Returns whether a specific option exists.

public hasOption(string $name) : bool
Parameters
$name : string

The option name,

Return values
bool —

Whether the option exists

remove()

Removes the field with the given name.

public remove(string $name) : self
Parameters
$name : string
Return values
self —

resetModelTransformers()

Clears the normalization transformers.

public resetModelTransformers() : $this
Return values
$this —

The configuration object

resetViewTransformers()

Clears the view transformers.

public resetViewTransformers() : $this
Return values
$this —

The configuration object

setAction()

Sets the target URL of the form.

public setAction(string $action) : $this
Parameters
$action : string

The target URL of the form

Return values
$this —

The configuration object

setAttribute()

Sets the value for an attribute.

public setAttribute(string $name, mixed $value) : $this
Parameters
$name : string

The name of the attribute

$value : mixed

The value of the attribute

Return values
$this —

The configuration object

setAttributes()

Sets the attributes.

public setAttributes(array<string|int, mixed> $attributes) : $this
Parameters
$attributes : array<string|int, mixed>
Return values
$this —

The configuration object

setAutoInitialize()

Sets whether the form should be initialized automatically.

public setAutoInitialize(bool $initialize) : $this

Should be set to true only for root forms.

Parameters
$initialize : bool

True to initialize the form automatically, false to suppress automatic initialization. In the second case, you need to call manually.

Return values
$this —

The configuration object

setByReference()

Sets whether the form's data should be modified by reference.

public setByReference(bool $byReference) : $this
Parameters
$byReference : bool

Whether the data should be modified by reference

Return values
$this —

The configuration object

setData()

Sets the initial data of the form.

public setData(mixed $data) : $this
Parameters
$data : mixed

The data of the form in model format

Return values
$this —

The configuration object

setDataLocked()

Locks the form's data to the data passed in the configuration.

public setDataLocked(bool $locked) : $this

A form with locked data is restricted to the data passed in this configuration. The data can only be modified then by submitting the form or using PRE_SET_DATA event.

It means data passed to a factory method or mapped from the parent will be ignored.

Parameters
$locked : bool

Whether to lock the default configured data

Return values
$this —

The configuration object

setDisabled()

Sets whether the form is disabled.

public setDisabled(bool $disabled) : $this
Parameters
$disabled : bool

Whether the form is disabled

Return values
$this —

The configuration object

setEmptyData()

Sets the data used for the client data when no value is submitted.

public setEmptyData(mixed $emptyData) : $this
Parameters
$emptyData : mixed

The empty data

Return values
$this —

The configuration object

setErrorBubbling()

Sets whether errors bubble up to the parent.

public setErrorBubbling(bool $errorBubbling) : $this
Parameters
$errorBubbling : bool
Return values
$this —

The configuration object

setInheritData()

Sets whether the form should read and write the data of its parent.

public setInheritData(bool $inheritData) : $this
Parameters
$inheritData : bool

Whether the form should inherit its parent's data

Return values
$this —

The configuration object

setMapped()

Sets whether the form should be mapped to an element of its parent's data.

public setMapped(bool $mapped) : $this
Parameters
$mapped : bool

Whether the form should be mapped

Return values
$this —

The configuration object

setMethod()

Sets the HTTP method used by the form.

public setMethod(string $method) : $this
Parameters
$method : string

The HTTP method of the form

Return values
$this —

The configuration object

setPropertyPath()

Sets the property path that the form should be mapped to.

public setPropertyPath(string|PropertyPathInterface|null $propertyPath) : $this
Parameters
$propertyPath : string|PropertyPathInterface|null

The property path or null if the path should be set automatically based on the form's name

Return values
$this —

The configuration object

setRequired()

Sets whether this field is required to be filled out when submitted.

public setRequired(bool $required) : $this
Parameters
$required : bool
Return values
$this —

The configuration object

Search results