Form/Element/Xhtml.php

Show: PublicProtectedPrivateinherited
Table of Contents
Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

Category
Zend  
Copyright
Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  
Package
Zend_Form  
Subpackage
Element  

\Zend_Form_Element_Xhtml

Package: Zend\Form\Element
Base element for XHTML elements
Parent(s)
\Zend_Form_Element
Children
\Zend_Form_Element_Hidden
\Zend_Form_Element_Text
\Zend_Form_Element_Checkbox
\Zend_Form_Element_File
\Zend_Form_Element_Image
\Zend_Form_Element_Password
\Zend_Form_Element_Submit
\Zend_Form_Element_Captcha
\Zend_Form_Element_Hash
\Zend_Form_Element_Multi
\Zend_Form_Element_Textarea
\Zend_Form_Element_Note
Category
Zend  
Copyright
Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)  
License
New BSD License  
Version
$Id: Xhtml.php 24593 2012-01-05 20:35:02Z matthew $  

Constants

>VConstant  DECORATOR = 'DECORATOR'
inherited
Element Constants
Inherited from: \Zend_Form_Element::DECORATOR
>VConstant  FILTER = 'FILTER'
inheritedInherited from: \Zend_Form_Element::FILTER
Inherited_from
\Zend_Form_Element::FILTER  
>VConstant  VALIDATE = 'VALIDATE'
inheritedInherited from: \Zend_Form_Element::VALIDATE

Properties

>VPropertyprotectedbool $_allowEmpty = true
inherited
'Allow empty' flag
Inherited from: \Zend_Form_Element::$$_allowEmpty
Default valuetrueDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_allowEmpty  
>VPropertyprotectedbool $_autoInsertNotEmptyValidator = true
inherited
Flag indicating whether or not to insert NotEmpty validator when element is required
Inherited from: \Zend_Form_Element::$$_autoInsertNotEmptyValidator
Default valuetrueDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_autoInsertNotEmptyValidator  
>VPropertyprotectedstring $_belongsTo
inherited
Array to which element belongs
Inherited from: \Zend_Form_Element::$$_belongsTo
Details
Type
string
Inherited_from
\Zend_Form_Element::$$_belongsTo  
>VPropertyprotectedarray $_decorators = array()
inherited
Element decorators
Inherited from: \Zend_Form_Element::$$_decorators
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_decorators  
>VPropertyprotectedstring $_description
inherited
Element description
Inherited from: \Zend_Form_Element::$$_description
Details
Type
string
Inherited_from
\Zend_Form_Element::$$_description  
>VPropertyprotectedbool $_disableLoadDefaultDecorators = false
inherited
Should we disable loading the default decorators?
Inherited from: \Zend_Form_Element::$$_disableLoadDefaultDecorators
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_disableLoadDefaultDecorators  
>VPropertyprotectedstring $_errorMessageSeparator = '; '
inherited
Separator to use when concatenating aggregate error messages (for elements having array values)
Inherited from: \Zend_Form_Element::$$_errorMessageSeparator
Default value'; 'Details
Type
string
Inherited_from
\Zend_Form_Element::$$_errorMessageSeparator  
>VPropertyprotectedarray $_errorMessages = array()
inherited
Custom error messages
Inherited from: \Zend_Form_Element::$$_errorMessages
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_errorMessages  
>VPropertyprotectedarray $_errors = array()
inherited
Validation errors
Inherited from: \Zend_Form_Element::$$_errors
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_errors  
>VPropertyprotectedarray $_filters = array()
inherited
Element filters
Inherited from: \Zend_Form_Element::$$_filters
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_filters  
>VPropertyprotectedbool $_ignore = false
inherited
Ignore flag (used when retrieving values at form level)
Inherited from: \Zend_Form_Element::$$_ignore
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_ignore  
>VPropertyprotectedbool $_isArray = false
inherited
Does the element represent an array?
Inherited from: \Zend_Form_Element::$$_isArray
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_isArray  
>VPropertyprotectedbool $_isError = false
inherited
Is the error marked as in an invalid state?
Inherited from: \Zend_Form_Element::$$_isError
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_isError  
>VPropertyprotectedbool $_isErrorForced = false
inherited
Has the element been manually marked as invalid?
Inherited from: \Zend_Form_Element::$$_isErrorForced
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_isErrorForced  
>VPropertyprotectedbool $_isPartialRendering = false
inherited
Is a specific decorator being rendered via the magic renderDecorator()?
Inherited from: \Zend_Form_Element::$$_isPartialRendering

This is to allow execution of logic inside the render() methods of child elements during the magic call while skipping the parent render() method.

Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_isPartialRendering  
>VPropertyprotectedstring $_label
inherited
Element label
Inherited from: \Zend_Form_Element::$$_label
Details
Type
string
Inherited_from
\Zend_Form_Element::$$_label  
>VPropertyprotectedarray $_loaders = array()
inherited
Plugin loaders for filter and validator chains
Inherited from: \Zend_Form_Element::$$_loaders
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_loaders  
>VPropertyprotectedarray $_messages = array()
inherited
Formatted validation error messages
Inherited from: \Zend_Form_Element::$$_messages
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_messages  
>VPropertyprotectedstring $_name
inherited
Element name
Inherited from: \Zend_Form_Element::$$_name
Details
Type
string
Inherited_from
\Zend_Form_Element::$$_name  
>VPropertyprotectedint $_order
inherited
Order of element
Inherited from: \Zend_Form_Element::$$_order
Details
Type
int
Inherited_from
\Zend_Form_Element::$$_order  
>VPropertyprotectedbool $_required = false
inherited
Required flag
Inherited from: \Zend_Form_Element::$$_required
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_required  
>VPropertyprotected\Zend_Translate $_translator
inherited
Inherited from: \Zend_Form_Element::$$_translator
>VPropertyprotectedbool $_translatorDisabled = false
inherited
Is translation disabled?
Inherited from: \Zend_Form_Element::$$_translatorDisabled
Default valuefalseDetails
Type
bool
Inherited_from
\Zend_Form_Element::$$_translatorDisabled  
>VPropertyprotectedstring $_type
inherited
Element type
Inherited from: \Zend_Form_Element::$$_type
Details
Type
string
Inherited_from
\Zend_Form_Element::$$_type  
>VPropertyprotectedarray $_validatorRules = array()
inherited
Array of un-initialized validators
Inherited from: \Zend_Form_Element::$$_validatorRules
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_validatorRules  
>VPropertyprotectedarray $_validators = array()
inherited
Array of initialized validators
Inherited from: \Zend_Form_Element::$$_validators
Default valuearray()Details
Type
array
Inherited_from
\Zend_Form_Element::$$_validators  
>VPropertyprotectedmixed $_value
inherited
Element value
Inherited from: \Zend_Form_Element::$$_value
Details
Type
mixed
Inherited_from
\Zend_Form_Element::$$_value  
>VPropertyprotected\Zend_View_Interface $_view
inherited
Inherited from: \Zend_Form_Element::$$_view
>VPropertypublicstring $helper = 'formText'
inherited
Default view helper to use
Inherited from: \Zend_Form_Element::$$helper
Default value'formText'Details
Type
string
Inherited_from
\Zend_Form_Element::$$helper  

Methods

methodpublic__call(string $method, array $args) : string
inherited

Overloading: allow rendering specific decorators

Inherited from: \Zend_Form_Element::__call()

Call renderDecoratorName() to render a specific decorator.

Parameters
NameTypeDescription
$methodstring
$argsarray
Returns
TypeDescription
string
Throws
ExceptionDescription
\Zend_Form_Exceptionfor invalid decorator or invalid method call
methodpublic__construct(string | array | \Zend_Config $spec, array | \Zend_Config $options = null) : void
inherited

Constructor

Inherited from: \Zend_Form_Element::__construct()

$spec may be: - string: name of element - array: options with which to configure element - Zend_Config: Zend_Config with options for configuring element

Parameters
NameTypeDescription
$specstring | array | \Zend_Config
$optionsarray | \Zend_Config
Throws
ExceptionDescription
\Zend_Form_Exceptionif no element name after initialization
methodpublic__get(string $key) : mixed
inherited

Overloading: retrieve object property

Inherited from: \Zend_Form_Element::__get()

Prevents access to properties beginning with '_'.

Parameters
NameTypeDescription
$keystring
Returns
TypeDescription
mixed
methodpublic__set(string $key, mixed $value) : \voide
inherited

Overloading: set object property

Inherited from: \Zend_Form_Element::__set()
Parameters
NameTypeDescription
$keystring
$valuemixed
Returns
TypeDescription
\voide
methodpublic__toString() : string
inherited

String representation of form element

Inherited from: \Zend_Form_Element::__toString()

Proxies to render().

Returns
TypeDescription
string
methodprotected_filterValue(string $value, string $key) : void
inherited

Filter a value

Inherited from: \Zend_Form_Element::_filterValue()
Parameters
NameTypeDescription
$valuestring
$keystring
methodprotected_getDecorator(string $name, null | array $options) : \Zend_Form_Decorator_Interface
inherited

Instantiate a decorator based on class name or class name fragment

Inherited from: \Zend_Form_Element::_getDecorator()
Parameters
NameTypeDescription
$namestring
$optionsnull | array
Returns
TypeDescription
\Zend_Form_Decorator_Interface
methodprotected_getErrorMessages() : array
inherited

Retrieve error messages and perform translation and value substitution

Inherited from: \Zend_Form_Element::_getErrorMessages()
Returns
TypeDescription
array
methodprotected_hasErrorMessages() : bool
inherited

Are there custom error messages registered?

Inherited from: \Zend_Form_Element::_hasErrorMessages()
Returns
TypeDescription
bool
methodprotected_loadDecorator(array $decorator, mixed $name) : \Zend_Form_Decorator_Interface
inherited

Lazy-load a decorator

Inherited from: \Zend_Form_Element::_loadDecorator()
Parameters
NameTypeDescription
$decoratorarray

Decorator type and options

$namemixed

Decorator name or alias

Returns
TypeDescription
\Zend_Form_Decorator_Interface
methodprotected_loadFilter(array $filter) : \Zend_Filter_Interface
inherited

Lazy-load a filter

Inherited from: \Zend_Form_Element::_loadFilter()
Parameters
NameTypeDescription
$filterarray
Returns
TypeDescription
\Zend_Filter_Interface
methodprotected_loadValidator(array $validator) : \Zend_Validate_Interface
inherited

Lazy-load a validator

Inherited from: \Zend_Form_Element::_loadValidator()
Parameters
NameTypeDescription
$validatorarray

Validator definition

Returns
TypeDescription
\Zend_Validate_Interface
methodpublicaddDecorator(string | \Zend_Form_Decorator_Interface $decorator, array | \Zend_Config $options = null) : \Zend_Form_Element
inherited

Add a decorator for rendering the element

Inherited from: \Zend_Form_Element::addDecorator()
Parameters
NameTypeDescription
$decoratorstring | \Zend_Form_Decorator_Interface
$optionsarray | \Zend_Config

Options with which to initialize decorator

Returns
TypeDescription
\Zend_Form_Element
methodpublicaddDecorators(array $decorators) : \Zend_Form_Element
inherited

Add many decorators at once

Inherited from: \Zend_Form_Element::addDecorators()
Parameters
NameTypeDescription
$decoratorsarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddError(string $message) : \Zend_Form_Element
inherited

Add an error message and mark element as failed validation

Inherited from: \Zend_Form_Element::addError()
Parameters
NameTypeDescription
$messagestring
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddErrorMessage(string $message) : \Zend_Form_Element
inherited

Add a custom error message to return in the event of failed validation

Inherited from: \Zend_Form_Element::addErrorMessage()
Parameters
NameTypeDescription
$messagestring
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddErrorMessages(array $messages) : \Zend_Form_Element
inherited

Add multiple custom error messages to return in the event of failed validation

Inherited from: \Zend_Form_Element::addErrorMessages()
Parameters
NameTypeDescription
$messagesarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddErrors(array $messages) : \Zend_Form_Element
inherited

Add multiple error messages and flag element as failed validation

Inherited from: \Zend_Form_Element::addErrors()
Parameters
NameTypeDescription
$messagesarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddFilter(string | \Zend_Filter_Interface $filter,  $options = array()) : \Zend_Form_Element
inherited

Add a filter to the element

Inherited from: \Zend_Form_Element::addFilter()
Parameters
NameTypeDescription
$filterstring | \Zend_Filter_Interface
$options
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddFilters(array $filters) : \Zend_Form_Element
inherited

Add filters to element

Inherited from: \Zend_Form_Element::addFilters()
Parameters
NameTypeDescription
$filtersarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddPrefixPath(string $prefix, string $path, string $type = null) : \Zend_Form_Element
inherited

Add prefix path for plugin loader

Inherited from: \Zend_Form_Element::addPrefixPath()

If no $type specified, assumes it is a base path for both filters and validators, and sets each according to the following rules: - decorators: $prefix = $prefix . '_Decorator' - filters: $prefix = $prefix . '_Filter' - validators: $prefix = $prefix . '_Validate'

Otherwise, the path prefix is set on the appropriate plugin loader.

Parameters
NameTypeDescription
$prefixstring
$pathstring
$typestring
Returns
TypeDescription
\Zend_Form_Element
Throws
ExceptionDescription
\Zend_Form_Exceptionfor invalid type
methodpublicaddPrefixPaths(array $spec) : \Zend_Form_Element
inherited

Add many prefix paths at once

Inherited from: \Zend_Form_Element::addPrefixPaths()
Parameters
NameTypeDescription
$specarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicaddValidator(string | \Zend_Validate_Interface $validator, bool $breakChainOnFailure = false, array $options = array()) : \Zend_Form_Element
inherited

Add validator to validation chain

Inherited from: \Zend_Form_Element::addValidator()

Note: will overwrite existing validators if they are of the same class.

Parameters
NameTypeDescription
$validatorstring | \Zend_Validate_Interface
$breakChainOnFailurebool
$optionsarray
Returns
TypeDescription
\Zend_Form_Element
Throws
ExceptionDescription
\Zend_Form_Exceptionif invalid validator type
methodpublicaddValidators(array $validators) : \Zend_Form_Element
inherited

Add multiple validators

Inherited from: \Zend_Form_Element::addValidators()
Parameters
NameTypeDescription
$validatorsarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicautoInsertNotEmptyValidator() : bool
inherited

Get flag indicating whether a NotEmpty validator should be inserted when element is required

Inherited from: \Zend_Form_Element::autoInsertNotEmptyValidator()
Returns
TypeDescription
bool
methodpublicclearDecorators() : \Zend_Form_Element
inherited

Clear all decorators

Inherited from: \Zend_Form_Element::clearDecorators()
Returns
TypeDescription
\Zend_Form_Element
methodpublicclearErrorMessages() : \Zend_Form_Element
inherited

Clear custom error messages stack

Inherited from: \Zend_Form_Element::clearErrorMessages()
Returns
TypeDescription
\Zend_Form_Element
methodpublicclearFilters() : \Zend_Form_Element
inherited

Clear all filters

Inherited from: \Zend_Form_Element::clearFilters()
Returns
TypeDescription
\Zend_Form_Element
methodpublicclearValidators() : \Zend_Form_Element
inherited

Clear all validators

Inherited from: \Zend_Form_Element::clearValidators()
Returns
TypeDescription
\Zend_Form_Element
methodpublicfilterName(string $value, bool $allowBrackets = false) : string
inherited

Filter a name to only allow valid variable characters

Inherited from: \Zend_Form_Element::filterName()
Parameters
NameTypeDescription
$valuestring
$allowBracketsbool
Returns
TypeDescription
string
methodpublicgetAllowEmpty() : bool
inherited

Get 'allow empty' flag

Inherited from: \Zend_Form_Element::getAllowEmpty()
Returns
TypeDescription
bool
methodpublicgetAttrib(string $name) : string
inherited

Retrieve element attribute

Inherited from: \Zend_Form_Element::getAttrib()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
string
methodpublicgetAttribs() : array
inherited

Return all attributes

Inherited from: \Zend_Form_Element::getAttribs()
Returns
TypeDescription
array
methodpublicgetBelongsTo() : string
inherited

Return array name to which element belongs

Inherited from: \Zend_Form_Element::getBelongsTo()
Returns
TypeDescription
string
methodpublicgetDecorator(string $name) : false | \Zend_Form_Decorator_Abstract
inherited

Retrieve a registered decorator

Inherited from: \Zend_Form_Element::getDecorator()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
false | \Zend_Form_Decorator_Abstract
methodpublicgetDecorators() : array
inherited

Retrieve all decorators

Inherited from: \Zend_Form_Element::getDecorators()
Returns
TypeDescription
array
methodpublicgetDescription() : string
inherited

Retrieve element description

Inherited from: \Zend_Form_Element::getDescription()
Returns
TypeDescription
string
methodpublicgetErrorMessageSeparator() : string
inherited

Get errorMessageSeparator

Inherited from: \Zend_Form_Element::getErrorMessageSeparator()
Returns
TypeDescription
string
methodpublicgetErrorMessages() : array
inherited

Retrieve custom error messages

Inherited from: \Zend_Form_Element::getErrorMessages()
Returns
TypeDescription
array
methodpublicgetErrors() : array
inherited

Retrieve validator chain errors

Inherited from: \Zend_Form_Element::getErrors()
Returns
TypeDescription
array
methodpublicgetFilter(string $name) : \Zend_Filter_Interface
inherited

Retrieve a single filter by name

Inherited from: \Zend_Form_Element::getFilter()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
\Zend_Filter_Interface
methodpublicgetFilters() : array
inherited

Get all filters

Inherited from: \Zend_Form_Element::getFilters()
Returns
TypeDescription
array
methodpublicgetFullyQualifiedName() : string
inherited

Get fully qualified name

Inherited from: \Zend_Form_Element::getFullyQualifiedName()

Places name as subitem of array and/or appends brackets.

Returns
TypeDescription
string
methodpublicgetId() : string
inherited

Get element id

Inherited from: \Zend_Form_Element::getId()
Returns
TypeDescription
string
methodpublicgetIgnore() : bool
inherited

Get ignore flag (used when retrieving values at form level)

Inherited from: \Zend_Form_Element::getIgnore()
Returns
TypeDescription
bool
methodpublicgetLabel() : string
inherited

Retrieve element label

Inherited from: \Zend_Form_Element::getLabel()
Returns
TypeDescription
string
methodpublicgetMessages() : array
inherited

Retrieve error messages

Inherited from: \Zend_Form_Element::getMessages()

The array keys are validation failure message identifiers, and the array values are the corresponding human-readable message strings.

If isValid() was never called or if the most recent isValid() call returned true, then this method returns an empty array.

Returns
TypeDescription
array
methodpublicgetName() : string
inherited

Return element name

Inherited from: \Zend_Form_Element::getName()
Returns
TypeDescription
string
methodpublicgetOrder() : int
inherited

Retrieve element order

Inherited from: \Zend_Form_Element::getOrder()
Returns
TypeDescription
int
methodpublicgetPluginLoader(string $type) : \Zend_Loader_PluginLoader
inherited

Retrieve plugin loader for validator or filter chain

Inherited from: \Zend_Form_Element::getPluginLoader()

Instantiates with default rules if none available for that type. Use 'decorator', 'filter', or 'validate' for $type.

Parameters
NameTypeDescription
$typestring
Returns
TypeDescription
\Zend_Loader_PluginLoader
Throws
ExceptionDescription
\Zend_Loader_Exceptionon invalid type.
methodpublicgetTranslator() : \Zend_Translate_Adapter | null
inherited

Retrieve localization translator object

Inherited from: \Zend_Form_Element::getTranslator()
Returns
TypeDescription
\Zend_Translate_Adapter | null
methodpublicgetType() : string
inherited

Return element type

Inherited from: \Zend_Form_Element::getType()
Returns
TypeDescription
string
methodpublicgetUnfilteredValue() : mixed
inherited

Retrieve unfiltered element value

Inherited from: \Zend_Form_Element::getUnfilteredValue()
Returns
TypeDescription
mixed
methodpublicgetValidator(string $name) : \Zend_Validate_Interface | false
inherited

Retrieve a single validator by name

Inherited from: \Zend_Form_Element::getValidator()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
\Zend_Validate_Interface | falseFalse if not found, validator otherwise
methodpublicgetValidators() : array
inherited

Retrieve all validators

Inherited from: \Zend_Form_Element::getValidators()
Returns
TypeDescription
array
methodpublicgetValue() : mixed
inherited

Retrieve filtered element value

Inherited from: \Zend_Form_Element::getValue()
Returns
TypeDescription
mixed
methodpublicgetView() : null | \Zend_View_Interface
inherited

Retrieve view object

Inherited from: \Zend_Form_Element::getView()

Retrieves from ViewRenderer if none previously set.

Returns
TypeDescription
null | \Zend_View_Interface
methodpublichasErrors() : bool
inherited

Are there errors registered?

Inherited from: \Zend_Form_Element::hasErrors()
Returns
TypeDescription
bool
methodpublichasTranslator() : bool
inherited

Does this element have its own specific translator?

Inherited from: \Zend_Form_Element::hasTranslator()
Returns
TypeDescription
bool
methodpublicinit() : void
inherited

Initialize object; used by extending classes

Inherited from: \Zend_Form_Element::init()
methodpublicisArray() : bool
inherited

Is the element representing an array?

Inherited from: \Zend_Form_Element::isArray()
Returns
TypeDescription
bool
methodpublicisRequired() : bool
inherited

Is the element required?

Inherited from: \Zend_Form_Element::isRequired()
Returns
TypeDescription
bool
methodpublicisValid(mixed $value, mixed $context = null) : boolean
inherited

Validate element value

Inherited from: \Zend_Form_Element::isValid()

If a translation adapter is registered, any error messages will be translated according to the current locale, using the given error code; if no matching translation is found, the original message will be utilized.

Note: The filtered value is validated.

Parameters
NameTypeDescription
$valuemixed
$contextmixed
Returns
TypeDescription
boolean
Throws
ExceptionDescription
\Zend_Validate_ExceptionIf validation of $value is impossible
methodpublicloadDefaultDecorators() : \Zend_Form_Element
inherited

Load default decorators

Inherited from: \Zend_Form_Element::loadDefaultDecorators()
Returns
TypeDescription
\Zend_Form_Element
methodpublicloadDefaultDecoratorsIsDisabled() : bool
inherited

Should we load the default decorators?

Inherited from: \Zend_Form_Element::loadDefaultDecoratorsIsDisabled()
Returns
TypeDescription
bool
methodpublicmarkAsError() : \Zend_Form_Element
inherited

Mark the element as being in a failed validation state

Inherited from: \Zend_Form_Element::markAsError()
Returns
TypeDescription
\Zend_Form_Element
methodpublicremoveDecorator(string $name) : \Zend_Form_Element
inherited

Remove a single decorator

Inherited from: \Zend_Form_Element::removeDecorator()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
\Zend_Form_Element
methodpublicremoveFilter(string $name) : \Zend_Form_Element
inherited

Remove a filter by name

Inherited from: \Zend_Form_Element::removeFilter()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
\Zend_Form_Element
methodpublicremoveValidator(string $name) : bool
inherited

Remove a single validator by name

Inherited from: \Zend_Form_Element::removeValidator()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
bool
methodpublicrender(\Zend_View_Interface $view = null) : string
inherited

Render form element

Inherited from: \Zend_Form_Element::render()
Parameters
NameTypeDescription
$view\Zend_View_Interface
Returns
TypeDescription
string
methodpublicresolveElementId(\Zend_Form_Decorator_Interface $decorator) : string
staticinherited

Used to resolve and return an element ID

Inherited from: \Zend_Form_Element::resolveElementId()

Passed to the HtmlTag decorator as a callback in order to provide an ID.

Parameters
NameTypeDescription
$decorator\Zend_Form_Decorator_Interface
Returns
TypeDescription
string
methodpublicsetAllowEmpty(bool $flag) : \Zend_Form_Element
inherited

Set 'allow empty' flag

Inherited from: \Zend_Form_Element::setAllowEmpty()

When the allow empty flag is enabled and the required flag is false, the element will validate with empty values.

Parameters
NameTypeDescription
$flagbool
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetAttrib(string $name, mixed $value) : \Zend_Form_Element
inherited

Set element attribute

Inherited from: \Zend_Form_Element::setAttrib()
Parameters
NameTypeDescription
$namestring
$valuemixed
Returns
TypeDescription
\Zend_Form_Element
Throws
ExceptionDescription
\Zend_Form_Exceptionfor invalid $name values
methodpublicsetAttribs(array $attribs) : \Zend_Form_Element
inherited

Set multiple attributes at once

Inherited from: \Zend_Form_Element::setAttribs()
Parameters
NameTypeDescription
$attribsarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetAutoInsertNotEmptyValidator(bool $flag) : \Zend_Form_Element
inherited

Set flag indicating whether a NotEmpty validator should be inserted when element is required

Inherited from: \Zend_Form_Element::setAutoInsertNotEmptyValidator()
Parameters
NameTypeDescription
$flagbool
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetBelongsTo(string $array) : \Zend_Form_Element
inherited

Set array to which element belongs

Inherited from: \Zend_Form_Element::setBelongsTo()
Parameters
NameTypeDescription
$arraystring
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetConfig(\Zend_Config $config) : \Zend_Form_Element
inherited

Set object state from Zend_Config object

Inherited from: \Zend_Form_Element::setConfig()
Parameters
NameTypeDescription
$config\Zend_Config
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetDecorators(array $decorators) : \Zend_Form_Element
inherited

Overwrite all decorators

Inherited from: \Zend_Form_Element::setDecorators()
Parameters
NameTypeDescription
$decoratorsarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetDescription(string $description) : \Zend_Form_Element
inherited

Set element description

Inherited from: \Zend_Form_Element::setDescription()
Parameters
NameTypeDescription
$descriptionstring
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetDisableLoadDefaultDecorators(bool $flag) : \Zend_Form_Element
inherited

Set flag to disable loading default decorators

Inherited from: \Zend_Form_Element::setDisableLoadDefaultDecorators()
Parameters
NameTypeDescription
$flagbool
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetDisableTranslator(bool $flag) : \Zend_Form_Element
inherited

Indicate whether or not translation should be disabled

Inherited from: \Zend_Form_Element::setDisableTranslator()
Parameters
NameTypeDescription
$flagbool
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetErrorMessageSeparator(string $separator) : \Zend_Form_Element
inherited

Set errorMessageSeparator

Inherited from: \Zend_Form_Element::setErrorMessageSeparator()
Parameters
NameTypeDescription
$separatorstring
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetErrorMessages(array $messages) : \Zend_Form_Element
inherited

Same as addErrorMessages(), but clears custom error message stack first

Inherited from: \Zend_Form_Element::setErrorMessages()
Parameters
NameTypeDescription
$messagesarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetErrors(array $messages) : \Zend_Form_Element
inherited

Overwrite any previously set error messages and flag as failed validation

Inherited from: \Zend_Form_Element::setErrors()
Parameters
NameTypeDescription
$messagesarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetFilters(array $filters) : \Zend_Form_Element
inherited

Add filters to element, overwriting any already existing

Inherited from: \Zend_Form_Element::setFilters()
Parameters
NameTypeDescription
$filtersarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetIgnore(bool $flag) : \Zend_Form_Element
inherited

Set ignore flag (used when retrieving values at form level)

Inherited from: \Zend_Form_Element::setIgnore()
Parameters
NameTypeDescription
$flagbool
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetIsArray(bool $flag) : \Zend_Form_Element
inherited

Set flag indicating if element represents an array

Inherited from: \Zend_Form_Element::setIsArray()
Parameters
NameTypeDescription
$flagbool
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetLabel(string $label) : \Zend_Form_Element
inherited

Set element label

Inherited from: \Zend_Form_Element::setLabel()
Parameters
NameTypeDescription
$labelstring
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetName(string $name) : \Zend_Form_Element
inherited

Set element name

Inherited from: \Zend_Form_Element::setName()
Parameters
NameTypeDescription
$namestring
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetOptions(array $options) : \Zend_Form_Element
inherited

Set object state from options array

Inherited from: \Zend_Form_Element::setOptions()
Parameters
NameTypeDescription
$optionsarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetOrder(int $order) : \Zend_Form_Element
inherited

Set element order

Inherited from: \Zend_Form_Element::setOrder()
Parameters
NameTypeDescription
$orderint
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetPluginLoader(\Zend_Loader_PluginLoader_Interface $loader, string $type) : \Zend_Form_Element
inherited

Set plugin loader to use for validator or filter chain

Inherited from: \Zend_Form_Element::setPluginLoader()
Parameters
NameTypeDescription
$loader\Zend_Loader_PluginLoader_Interface
$typestring

'decorator', 'filter', or 'validate'

Returns
TypeDescription
\Zend_Form_Element
Throws
ExceptionDescription
\Zend_Form_Exceptionon invalid type
methodpublicsetRequired(bool $flag = true) : \Zend_Form_Element
inherited

Set required flag

Inherited from: \Zend_Form_Element::setRequired()
Parameters
NameTypeDescription
$flagbool

Default value is true

Returns
TypeDescription
\Zend_Form_Element
methodpublicsetTranslator(\Zend_Translate | null $translator = null) : \Zend_Form_Element
inherited

Set translator object for localization

Inherited from: \Zend_Form_Element::setTranslator()
Parameters
NameTypeDescription
$translator\Zend_Translate | null
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetValidators(array $validators) : \Zend_Form_Element
inherited

Set multiple validators, overwriting previous validators

Inherited from: \Zend_Form_Element::setValidators()
Parameters
NameTypeDescription
$validatorsarray
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetValue(mixed $value) : \Zend_Form_Element
inherited

Set element value

Inherited from: \Zend_Form_Element::setValue()
Parameters
NameTypeDescription
$valuemixed
Returns
TypeDescription
\Zend_Form_Element
methodpublicsetView(\Zend_View_Interface $view = null) : \Zend_Form_Element
inherited

Set view object

Inherited from: \Zend_Form_Element::setView()
Parameters
NameTypeDescription
$view\Zend_View_Interface
Returns
TypeDescription
\Zend_Form_Element
methodpublictranslatorIsDisabled() : bool
inherited

Is translation disabled?

Inherited from: \Zend_Form_Element::translatorIsDisabled()
Returns
TypeDescription
bool
Documentation was generated by phpDocumentor 2.0.0a12.