Button

class Button implements IteratorAggregate, FormInterface

A form button.

Methods

__construct(FormConfigInterface $config)

Creates a new button from a form configuration.

bool offsetExists(mixed $offset)

Unsupported method.

offsetGet(mixed $offset)

Unsupported method.

offsetSet(mixed $offset, mixed $value)

Unsupported method.

offsetUnset(mixed $offset)

Unsupported method.

FormInterface setParent(FormInterface $parent = null)

Sets the parent form.

FormInterface|null getParent()

Returns the parent form.

FormInterface add(FormInterface|string|int $child, string|null $type = null, array $options = array())

Unsupported method.

FormInterface get(string $name)

Unsupported method.

bool has(string $name)

Unsupported method.

$this remove(string $name)

Unsupported method.

FormInterface[] all()

Returns all children in this group.

FormErrorIterator getErrors(bool $deep = false, bool $flatten = true)

Returns the errors of this form.

$this setData(mixed $modelData)

Unsupported method.

mixed getData()

Unsupported method.

mixed getNormData()

Unsupported method.

mixed getViewData()

Unsupported method.

array getExtraData()

Unsupported method.

FormConfigInterface getConfig()

Returns the button's configuration.

bool isSubmitted()

Returns whether the button is submitted.

string getName()

Returns the name by which the button is identified in forms.

PropertyPathInterface getPropertyPath()

Unsupported method.

$this addError(FormError $error)

Unsupported method.

bool isValid()

Unsupported method.

bool isRequired()

Unsupported method.

bool isDisabled()

Returns whether this form is disabled.

bool isEmpty()

Unsupported method.

bool isSynchronized()

Unsupported method.

TransformationFailedException|null getTransformationFailure()

Unsupported method.

$this initialize()

Unsupported method.

$this handleRequest(mixed $request = null)

Unsupported method.

$this submit(mixed $submittedData, bool $clearMissing = true)

Submits data to the button.

FormInterface getRoot()

Returns the root of the form tree.

bool isRoot()

Returns whether the field is the root of the form tree.

FormView createView(FormView $parent = null)

Creates a view.

int count()

Unsupported method.

EmptyIterator getIterator()

Unsupported method.

Details

__construct(FormConfigInterface $config)

Creates a new button from a form configuration.

Parameters

FormConfigInterface $config The button's configuration

bool offsetExists(mixed $offset)

Unsupported method.

Parameters

mixed $offset

Return Value

bool Always returns false

offsetGet(mixed $offset)

Unsupported method.

This method should not be invoked.

Parameters

mixed $offset

Exceptions

BadMethodCallException

offsetSet(mixed $offset, mixed $value)

Unsupported method.

This method should not be invoked.

Parameters

mixed $offset
mixed $value

Exceptions

BadMethodCallException

offsetUnset(mixed $offset)

Unsupported method.

This method should not be invoked.

Parameters

mixed $offset

Exceptions

BadMethodCallException

FormInterface setParent(FormInterface $parent = null)

Sets the parent form.

Parameters

FormInterface $parent

Return Value

FormInterface

Exceptions

AlreadySubmittedException if the form has already been submitted
LogicException when trying to set a parent for a form with an empty name

FormInterface|null getParent()

Returns the parent form.

Return Value

FormInterface|null The parent form or null if there is none

FormInterface add(FormInterface|string|int $child, string|null $type = null, array $options = array())

Unsupported method.

This method should not be invoked.

Parameters

FormInterface|string|int $child The FormInterface instance or the name of the child
string|null $type The child's type, if a name was passed
array $options The child's options, if a name was passed

Return Value

FormInterface

Exceptions

BadMethodCallException

FormInterface get(string $name)

Unsupported method.

This method should not be invoked.

Parameters

string $name The name of the child

Return Value

FormInterface

Exceptions

BadMethodCallException

bool has(string $name)

Unsupported method.

Parameters

string $name The name of the child

Return Value

bool

$this remove(string $name)

Unsupported method.

This method should not be invoked.

Parameters

string $name The name of the child to remove

Return Value

$this

Exceptions

BadMethodCallException

FormInterface[] all()

Returns all children in this group.

Return Value

FormInterface[]

FormErrorIterator getErrors(bool $deep = false, bool $flatten = true)

Returns the errors of this form.

Parameters

bool $deep Whether to include errors of child forms as well
bool $flatten Whether to flatten the list of errors in case $deep is set to true

Return Value

FormErrorIterator An iterator over the {@link FormError} instances that where added to this form

$this setData(mixed $modelData)

Unsupported method.

This method should not be invoked.

Parameters

mixed $modelData The data formatted as expected for the underlying object

Return Value

$this

mixed getData()

Unsupported method.

Return Value

mixed

mixed getNormData()

Unsupported method.

Return Value

mixed When the field is not submitted, the default data is returned. When the field is submitted, the normalized submitted data is returned if the field is valid, null otherwise.

mixed getViewData()

Unsupported method.

Return Value

mixed

array getExtraData()

Unsupported method.

Return Value

array The submitted data which do not belong to a child

FormConfigInterface getConfig()

Returns the button's configuration.

Return Value

FormConfigInterface The configuration

bool isSubmitted()

Returns whether the button is submitted.

Return Value

bool true if the form is submitted, false otherwise

string getName()

Returns the name by which the button is identified in forms.

Return Value

string The name of the form

PropertyPathInterface getPropertyPath()

Unsupported method.

Return Value

PropertyPathInterface The property path

$this addError(FormError $error)

Unsupported method.

Parameters

FormError $error

Return Value

$this

Exceptions

BadMethodCallException

bool isValid()

Unsupported method.

Return Value

bool

bool isRequired()

Unsupported method.

Return Value

bool

bool isDisabled()

Returns whether this form is disabled.

The content of a disabled form is displayed, but not allowed to be modified. The validation of modified disabled forms should fail.

Forms whose parents are disabled are considered disabled regardless of their own state.

Return Value

bool

bool isEmpty()

Unsupported method.

Return Value

bool

bool isSynchronized()

Unsupported method.

Return Value

bool

TransformationFailedException|null getTransformationFailure()

Unsupported method.

Return Value

TransformationFailedException|null The transformation failure

$this initialize()

Unsupported method.

Return Value

$this

Exceptions

BadMethodCallException

$this handleRequest(mixed $request = null)

Unsupported method.

Parameters

mixed $request The request to handle

Return Value

$this

Exceptions

BadMethodCallException

$this submit(mixed $submittedData, bool $clearMissing = true)

Submits data to the button.

Parameters

mixed $submittedData The submitted data
bool $clearMissing whether to set fields to NULL when they are missing in the submitted data

Return Value

$this

Exceptions

AlreadySubmittedException if the button has already been submitted

FormInterface getRoot()

Returns the root of the form tree.

Return Value

FormInterface The root of the tree

bool isRoot()

Returns whether the field is the root of the form tree.

Return Value

bool

FormView createView(FormView $parent = null)

Creates a view.

Parameters

FormView $parent

Return Value

FormView The view

int count()

Unsupported method.

Return Value

int Always returns 0

EmptyIterator getIterator()

Unsupported method.

Return Value

EmptyIterator Always returns an empty iterator

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/4.0/Symfony/Component/Form/Button.html