AbstractCompositeRenderable extends AbstractRenderable implements CompositeRenderableInterface
Convenience base class which implements common functionality for most classes which implement CompositeRenderableInterface, i.e. have **child renderable elements**.
Scope: frontend This class is NOT meant to be sub classed by developers.
Table of Contents
Interfaces
- CompositeRenderableInterface
- Interface which all Form Parts must adhere to **when they have sub elements**.
Properties
- $identifier : string
- The identifier of this renderable
- $index : int
- The position of this renderable inside the parent renderable.
- $label : string
- The label of this renderable
- $parentRenderable : CompositeRenderableInterface|null
- The parent renderable
- $renderables : array<string|int, RenderableInterface>
- array of child renderables
- $renderingOptions : array<string|int, mixed>
- associative array of rendering options
- $templateName : string
- The name of the template file of the renderable.
- $type : string
- Abstract "type" of this Renderable. Is used during the rendering process to determine the template file or the View PHP class being used to render the particular element.
- $variants : array<string|int, mixed>
- associative array of rendering variants
Methods
- addValidator() : mixed
- Add a validator to the element
- addVariant() : mixed
- Adds the specified variant to this form element
- applyVariant() : mixed
- Apply the specified variant to this form element regardless of their conditions
- createValidator() : mixed
- Create a validator for the element
- createVariant() : RenderableVariantInterface
- getIdentifier() : string
- Get the identifier of the element
- getIndex() : int
- Get the index of the renderable
- getLabel() : string
- Get the label of the renderable
- getParentRenderable() : CompositeRenderableInterface|null
- Get the parent renderable
- getRenderablesRecursively() : array<string|int, RenderableInterface>
- Returns all RenderableInterface instances of this composite renderable recursively
- getRendererClassName() : string
- Get the classname of the renderer
- getRenderingOptions() : array<string|int, mixed>
- Get all rendering options
- getRootForm() : FormDefinition
- Get the root form this element belongs to
- getTemplateName() : string
- Get the templateName name of the renderable
- getType() : string
- Get the type of the renderable
- getValidators() : SplObjectStorage
- Get all validators on the element
- getVariants() : array<string|int, RenderableVariantInterface>
- Get all rendering variants
- isEnabled() : bool
- Returns whether this renderable is enabled
- onRemoveFromParentRenderable() : mixed
- This function is called after a renderable has been removed from its parent renderable.
- registerInFormIfPossible() : mixed
- Register this element at the parent form, if there is a connection to the parent form.
- setDataType() : mixed
- Set the datatype
- setDefaultValue() : mixed
- setIdentifier() : mixed
- Set the identifier of the element
- setIndex() : mixed
- Set the index of the renderable
- setLabel() : mixed
- Set the label which shall be displayed next to the form element
- setOptions() : mixed
- Set multiple properties of this object at once.
- setParentRenderable() : mixed
- Set the parent renderable
- setProperty() : mixed
- setRenderingOption() : mixed
- Set the rendering option $key to $value.
- addRenderable() : mixed
- Add a renderable to the list of child renderables.
- moveRenderableAfter() : mixed
- Move $renderableToMove after $referenceRenderable
- moveRenderableBefore() : mixed
- Move $renderableToMove before $referenceRenderable
- removeRenderable() : mixed
- Remove a renderable from this renderable.
Properties
$identifier
The identifier of this renderable
protected
string
$identifier
$index
The position of this renderable inside the parent renderable.
protected
int
$index
= 0
$label
The label of this renderable
protected
string
$label
= ''
$parentRenderable
The parent renderable
protected
CompositeRenderableInterface|null
$parentRenderable
$renderables
array of child renderables
protected
array<string|int, RenderableInterface>
$renderables
= []
$renderingOptions
associative array of rendering options
protected
array<string|int, mixed>
$renderingOptions
= []
$templateName
The name of the template file of the renderable.
protected
string
$templateName
= ''
$type
Abstract "type" of this Renderable. Is used during the rendering process to determine the template file or the View PHP class being used to render the particular element.
protected
string
$type
$variants
associative array of rendering variants
protected
array<string|int, mixed>
$variants
= []
Methods
addValidator()
Add a validator to the element
public
addValidator(ValidatorInterface $validator) : mixed
Parameters
- $validator : ValidatorInterface
addVariant()
Adds the specified variant to this form element
public
addVariant(RenderableVariantInterface $variant) : mixed
Parameters
- $variant : RenderableVariantInterface
applyVariant()
Apply the specified variant to this form element regardless of their conditions
public
applyVariant(RenderableVariantInterface $variant) : mixed
Parameters
- $variant : RenderableVariantInterface
createValidator()
Create a validator for the element
public
createValidator(string $validatorIdentifier[, array<string|int, mixed> $options = [] ]) : mixed
Parameters
- $validatorIdentifier : string
- $options : array<string|int, mixed> = []
Tags
createVariant()
public
createVariant(array<string|int, mixed> $options) : RenderableVariantInterface
Parameters
- $options : array<string|int, mixed>
Return values
RenderableVariantInterfacegetIdentifier()
Get the identifier of the element
public
getIdentifier() : string
Return values
stringgetIndex()
Get the index of the renderable
public
getIndex() : int
Return values
intgetLabel()
Get the label of the renderable
public
getLabel() : string
Return values
stringgetParentRenderable()
Get the parent renderable
public
getParentRenderable() : CompositeRenderableInterface|null
Return values
CompositeRenderableInterface|nullgetRenderablesRecursively()
Returns all RenderableInterface instances of this composite renderable recursively
public
getRenderablesRecursively() : array<string|int, RenderableInterface>
Return values
array<string|int, RenderableInterface>getRendererClassName()
Get the classname of the renderer
public
getRendererClassName() : string
Return values
stringgetRenderingOptions()
Get all rendering options
public
getRenderingOptions() : array<string|int, mixed>
Return values
array<string|int, mixed>getRootForm()
Get the root form this element belongs to
public
getRootForm() : FormDefinition
Tags
Return values
FormDefinitiongetTemplateName()
Get the templateName name of the renderable
public
getTemplateName() : string
Return values
stringgetType()
Get the type of the renderable
public
getType() : string
Return values
stringgetValidators()
Get all validators on the element
public
getValidators() : SplObjectStorage
Return values
SplObjectStoragegetVariants()
Get all rendering variants
public
getVariants() : array<string|int, RenderableVariantInterface>
Return values
array<string|int, RenderableVariantInterface>isEnabled()
Returns whether this renderable is enabled
public
isEnabled() : bool
Return values
boolonRemoveFromParentRenderable()
This function is called after a renderable has been removed from its parent renderable.
public
onRemoveFromParentRenderable() : mixed
This just passes the event down to all child renderables of this composite renderable.
registerInFormIfPossible()
Register this element at the parent form, if there is a connection to the parent form.
public
registerInFormIfPossible() : mixed
setDataType()
Set the datatype
public
setDataType(string $dataType) : mixed
Parameters
- $dataType : string
setDefaultValue()
public
setDefaultValue(mixed $defaultValue) : mixed
Parameters
- $defaultValue : mixed
setIdentifier()
Set the identifier of the element
public
setIdentifier(string $identifier) : mixed
Parameters
- $identifier : string
setIndex()
Set the index of the renderable
public
setIndex(int $index) : mixed
Parameters
- $index : int
setLabel()
Set the label which shall be displayed next to the form element
public
setLabel(string $label) : mixed
Parameters
- $label : string
setOptions()
Set multiple properties of this object at once.
public
setOptions(array<string|int, mixed> $options[, bool $resetValidators = false ]) : mixed
Every property which has a corresponding set* method can be set using the passed $options array.
Parameters
- $options : array<string|int, mixed>
- $resetValidators : bool = false
setParentRenderable()
Set the parent renderable
public
setParentRenderable(CompositeRenderableInterface $parentRenderable) : mixed
Parameters
- $parentRenderable : CompositeRenderableInterface
setProperty()
public
setProperty(string $key, mixed $value) : mixed
Parameters
- $key : string
- $value : mixed
setRenderingOption()
Set the rendering option $key to $value.
public
setRenderingOption(string $key, mixed $value) : mixed
Parameters
- $key : string
- $value : mixed
addRenderable()
Add a renderable to the list of child renderables.
protected
addRenderable(RenderableInterface $renderable) : mixed
This function will be wrapped by the subclasses, f.e. with an "addPage" or "addElement" method with the correct type hint.
Parameters
- $renderable : RenderableInterface
Tags
moveRenderableAfter()
Move $renderableToMove after $referenceRenderable
protected
moveRenderableAfter(RenderableInterface $renderableToMove, RenderableInterface $referenceRenderable) : mixed
This function will be wrapped by the subclasses, f.e. with an "movePageAfter" or "moveElementAfter" method with the correct type hint.
Parameters
- $renderableToMove : RenderableInterface
- $referenceRenderable : RenderableInterface
Tags
moveRenderableBefore()
Move $renderableToMove before $referenceRenderable
protected
moveRenderableBefore(RenderableInterface $renderableToMove, RenderableInterface $referenceRenderable) : mixed
This function will be wrapped by the subclasses, f.e. with an "movePageBefore" or "moveElementBefore" method with the correct type hint.
Parameters
- $renderableToMove : RenderableInterface
- $referenceRenderable : RenderableInterface
Tags
removeRenderable()
Remove a renderable from this renderable.
protected
removeRenderable(RenderableInterface $renderableToRemove) : mixed
This function will be wrapped by the subclasses, f.e. with an "removePage" or "removeElement" method with the correct type hint.
Parameters
- $renderableToRemove : RenderableInterface