class ButtonBuilder implements IteratorAggregate, FormBuilderInterface

A builder for {@link Button} instances.

Methods

__construct(string $name, array $options = array())

Creates a new button builder.

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

Unsupported method.

create(string $name, string|null $type = null, array $options = array())

Unsupported method.

get(string $name)

Unsupported method.

remove(string $name)

Unsupported method.

bool
has(string $name)

Unsupported method.

array
all()

Returns the children.

getForm()

Creates the button.

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

Unsupported method.

$this
addEventSubscriber(EventSubscriberInterface $subscriber)

Unsupported method.

$this
addViewTransformer(DataTransformerInterface $viewTransformer, bool $forcePrepend = false)

Unsupported method.

$this
resetViewTransformers()

Unsupported method.

$this
addModelTransformer(DataTransformerInterface $modelTransformer, bool $forceAppend = false)

Unsupported method.

$this
resetModelTransformers()

Unsupported method.

$this
setAttribute(string $name, mixed $value)

Sets the value for an attribute.

$this
setAttributes(array $attributes)

Sets the attributes.

$this
setDataMapper(DataMapperInterface $dataMapper = null)

Unsupported method.

$this
setDisabled(bool $disabled)

Set whether the button is disabled.

$this
setEmptyData(mixed $emptyData)

Unsupported method.

$this
setErrorBubbling(bool $errorBubbling)

Unsupported method.

$this
setRequired(bool $required)

Unsupported method.

$this
setPropertyPath(null|string|PropertyPathInterface $propertyPath)

Unsupported method.

$this
setMapped(bool $mapped)

Unsupported method.

$this
setByReference(bool $byReference)

Unsupported method.

$this
setCompound(bool $compound)

Unsupported method.

$this
setType(ResolvedFormTypeInterface $type)

Sets the type of the button.

$this
setData(mixed $data)

Unsupported method.

$this
setDataLocked(bool $locked)

Unsupported method.

setFormFactory(FormFactoryInterface $formFactory)

Unsupported method.

$this
setAction(string $action)

Unsupported method.

$this
setMethod(string $method)

Unsupported method.

$this
setRequestHandler(RequestHandlerInterface $requestHandler)

Unsupported method.

$this
setAutoInitialize(bool $initialize)

Unsupported method.

$this
setInheritData(bool $inheritData)

Unsupported method.

getFormConfig()

Builds and returns the button configuration.

string
getName()

Returns the name of the form used as HTTP parameter.

getPropertyPath()

Unsupported method.

bool
getMapped()

Unsupported method.

bool
getByReference()

Unsupported method.

bool
getCompound()

Unsupported method.

getType()

Returns the form type used to construct the button.

getDataMapper()

Unsupported method.

bool
getRequired()

Unsupported method.

bool
getDisabled()

Returns whether the button is disabled.

bool
getErrorBubbling()

Unsupported method.

mixed
getEmptyData()

Unsupported method.

array
getAttributes()

Returns additional attributes of the button.

bool
hasAttribute(string $name)

Returns whether the attribute with the given name exists.

mixed
getAttribute(string $name, mixed $default = null)

Returns the value of the given attribute.

mixed
getData()

Unsupported method.

null|string
getDataClass()

Unsupported method.

bool
getDataLocked()

Unsupported method.

getFormFactory()

Unsupported method.

string
getAction()

Unsupported method.

string
getMethod()

Unsupported method.

bool
getAutoInitialize()

Unsupported method.

bool
getInheritData()

Unsupported method.

array
getOptions()

Returns all options passed during the construction of the button.

bool
hasOption(string $name)

Returns whether a specific option exists.

mixed
getOption(string $name, mixed $default = null)

Returns the value of a specific option.

int
count()

Unsupported method.

getIterator()

Unsupported method.

Details

at line line 63
__construct(string $name, array $options = array())

Creates a new button builder.

Parameters

string $name The name of the button
array $options The button's options

Exceptions

InvalidArgumentException if the name is empty

at line line 85
FormBuilderInterface add(string|int|FormBuilderInterface $child, string|null $type = null, array $options = array())

Unsupported method.

This method should not be invoked.

Parameters

string|int|FormBuilderInterface $child
string|null $type
array $options

Return Value

FormBuilderInterface

Exceptions

BadMethodCallException

at line line 101
FormBuilderInterface create(string $name, string|null $type = null, array $options = array())

Unsupported method.

This method should not be invoked.

Parameters

string $name The name of the form or the name of the property
string|null $type The type of the form or null if name is a property
array $options The options

Return Value

FormBuilderInterface

Exceptions

BadMethodCallException

at line line 115
FormBuilderInterface get(string $name)

Unsupported method.

This method should not be invoked.

Parameters

string $name The name of the child

Return Value

FormBuilderInterface

Exceptions

BadMethodCallException

at line line 129
FormBuilderInterface remove(string $name)

Unsupported method.

This method should not be invoked.

Parameters

string $name

Return Value

FormBuilderInterface

Exceptions

BadMethodCallException

at line line 141
bool has(string $name)

Unsupported method.

Parameters

string $name

Return Value

bool

at line line 151
array all()

Returns the children.

Return Value

array

at line line 161
FormInterface getForm()

Creates the button.

Return Value

FormInterface The form

at line line 177
$this addEventListener(string $eventName, callable $listener, int $priority)

Unsupported method.

This method should not be invoked.

Parameters

string $eventName The name of the event to listen to
callable $listener The listener to execute
int $priority The priority of the listener. Listeners with a higher priority are called before listeners with a lower priority.

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 189
$this addEventSubscriber(EventSubscriberInterface $subscriber)

Unsupported method.

This method should not be invoked.

Parameters

EventSubscriberInterface $subscriber

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 204
$this addViewTransformer(DataTransformerInterface $viewTransformer, bool $forcePrepend = false)

Unsupported method.

This method should not be invoked.

Parameters

DataTransformerInterface $viewTransformer
bool $forcePrepend if set to true, prepend instead of appending

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 216
$this resetViewTransformers()

Unsupported method.

This method should not be invoked.

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 231
$this addModelTransformer(DataTransformerInterface $modelTransformer, bool $forceAppend = false)

Unsupported method.

This method should not be invoked.

Parameters

DataTransformerInterface $modelTransformer
bool $forceAppend if set to true, append instead of prepending

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 243
$this resetModelTransformers()

Unsupported method.

This method should not be invoked.

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 251
$this setAttribute(string $name, mixed $value)

Sets the value for an attribute.

Parameters

string $name The name of the attribute
mixed $value The value of the attribute

Return Value

$this The configuration object

at line line 261
$this setAttributes(array $attributes)

Sets the attributes.

Parameters

array $attributes

Return Value

$this The configuration object

at line line 275
$this setDataMapper(DataMapperInterface $dataMapper = null)

Unsupported method.

This method should not be invoked.

Parameters

DataMapperInterface $dataMapper

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 287
$this setDisabled(bool $disabled)

Set whether the button is disabled.

Parameters

bool $disabled Whether the form is disabled

Return Value

$this The configuration object

at line line 303
$this setEmptyData(mixed $emptyData)

Unsupported method.

This method should not be invoked.

Parameters

mixed $emptyData The empty data

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 317
$this setErrorBubbling(bool $errorBubbling)

Unsupported method.

This method should not be invoked.

Parameters

bool $errorBubbling

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 331
$this setRequired(bool $required)

Unsupported method.

This method should not be invoked.

Parameters

bool $required

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 345
$this setPropertyPath(null|string|PropertyPathInterface $propertyPath)

Unsupported method.

This method should not be invoked.

Parameters

null|string|PropertyPathInterface $propertyPath the property path or null if the path should be set automatically based on the form's name

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 359
$this setMapped(bool $mapped)

Unsupported method.

This method should not be invoked.

Parameters

bool $mapped Whether the form should be mapped

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 373
$this setByReference(bool $byReference)

Unsupported method.

This method should not be invoked.

Parameters

bool $byReference whether the data should be modified by reference

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 387
$this setCompound(bool $compound)

Unsupported method.

This method should not be invoked.

Parameters

bool $compound Whether the form should be compound

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 397
$this setType(ResolvedFormTypeInterface $type)

Sets the type of the button.

Parameters

ResolvedFormTypeInterface $type

Return Value

$this The configuration object

at line line 413
$this setData(mixed $data)

Unsupported method.

This method should not be invoked.

Parameters

mixed $data The data of the form in application format

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 427
$this setDataLocked(bool $locked)

Unsupported method.

This method should not be invoked.

Parameters

bool $locked Whether to lock the default data

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 439
setFormFactory(FormFactoryInterface $formFactory)

Unsupported method.

This method should not be invoked.

Parameters

FormFactoryInterface $formFactory

Exceptions

BadMethodCallException

at line line 451
$this setAction(string $action)

Unsupported method.

Parameters

string $action The target URL of the form

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 463
$this setMethod(string $method)

Unsupported method.

Parameters

string $method The HTTP method of the form

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 473
$this setRequestHandler(RequestHandlerInterface $requestHandler)

Unsupported method.

Parameters

RequestHandlerInterface $requestHandler

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 487
$this setAutoInitialize(bool $initialize)

Unsupported method.

Parameters

bool $initialize True to initialize the form automatically, false to suppress automatic initialization. In the second case, you need to call {@link FormInterface::initialize()} manually.

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 503
$this setInheritData(bool $inheritData)

Unsupported method.

Parameters

bool $inheritData Whether the form should inherit its parent's data

Return Value

$this The configuration object

Exceptions

BadMethodCallException

at line line 513
FormConfigInterface getFormConfig()

Builds and returns the button configuration.

Return Value

FormConfigInterface

at line line 525
EventDispatcherInterface getEventDispatcher()

Unsupported method.

Return Value

EventDispatcherInterface The dispatcher

at line line 532
string getName()

Returns the name of the form used as HTTP parameter.

Return Value

string The form name

at line line 540
null|PropertyPathInterface getPropertyPath()

Unsupported method.

Return Value

null|PropertyPathInterface The property path

at line line 549
bool getMapped()

Unsupported method.

Return Value

bool Whether the form is mapped

at line line 559
bool getByReference()

Unsupported method.

Return Value

bool Whether to modify the form's data by reference

at line line 569
bool getCompound()

Unsupported method.

Return Value

bool Whether the form is compound

at line line 579
ResolvedFormTypeInterface getType()

Returns the form type used to construct the button.

Return Value

ResolvedFormTypeInterface The form's type

at line line 589
DataTransformerInterface[] getViewTransformers()

Unsupported method.

Return Value

DataTransformerInterface[] An array of {@link DataTransformerInterface} instances

at line line 599
DataTransformerInterface[] getModelTransformers()

Unsupported method.

Return Value

DataTransformerInterface[] An array of {@link DataTransformerInterface} instances

at line line 607
DataMapperInterface getDataMapper()

Unsupported method.

Return Value

DataMapperInterface The data mapper

at line line 616
bool getRequired()

Unsupported method.

Return Value

bool Whether the form is required

at line line 626
bool getDisabled()

Returns whether the button is disabled.

Return Value

bool Whether the form is disabled

at line line 636
bool getErrorBubbling()

Unsupported method.

Return Value

bool Whether errors will bubble up

at line line 644
mixed getEmptyData()

Unsupported method.

Return Value

mixed The data returned if the form is empty

at line line 653
array getAttributes()

Returns additional attributes of the button.

Return Value

array An array of key-value combinations

at line line 665
bool hasAttribute(string $name)

Returns whether the attribute with the given name exists.

Parameters

string $name The attribute name

Return Value

bool Whether the attribute exists

at line line 678
mixed getAttribute(string $name, mixed $default = null)

Returns the value of the given attribute.

Parameters

string $name The attribute name
mixed $default The value returned if the attribute does not exist

Return Value

mixed The attribute value

at line line 686
mixed getData()

Unsupported method.

Return Value

mixed The initial form data

at line line 693
null|string getDataClass()

Unsupported method.

Return Value

null|string The data class or null

at line line 702
bool getDataLocked()

Unsupported method.

Return Value

bool Whether the data is locked

at line line 710
FormFactoryInterface getFormFactory()

Unsupported method.

Return Value

FormFactoryInterface The form factory

at line line 717
string getAction()

Unsupported method.

Return Value

string The target URL of the form

at line line 724
string getMethod()

Unsupported method.

Return Value

string The HTTP method of the form

at line line 731
RequestHandlerInterface getRequestHandler()

Unsupported method.

Return Value

RequestHandlerInterface The request handler

at line line 740
bool getAutoInitialize()

Unsupported method.

Return Value

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

at line line 750
bool getInheritData()

Unsupported method.

Return Value

bool Whether the form should inherit its parent's data

at line line 760
array getOptions()

Returns all options passed during the construction of the button.

Return Value

array The passed options

at line line 772
bool hasOption(string $name)

Returns whether a specific option exists.

Parameters

string $name The option name,

Return Value

bool Whether the option exists

at line line 785
mixed getOption(string $name, mixed $default = null)

Returns the value of a specific option.

Parameters

string $name The option name
mixed $default The value returned if the option does not exist

Return Value

mixed The option value

at line line 795
int count()

Unsupported method.

Return Value

int Always returns 0

at line line 805
EmptyIterator getIterator()

Unsupported method.

Return Value

EmptyIterator Always returns an empty iterator