Dojo/Form.php

Show:

inherited

Classes
- \Zend_Dojo_Form

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 [email protected] 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_Dojo
Subpackage: Form

\Zend_Dojo_Form
jump to top

Package: Zend\Dojo\Form

Dijit-enabled Form

Parent(s): \Zend_Form
Copyright: Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Uses: \global\Zend_Form
Version: $Id: Form.php 24593 2012-01-05 20:35:02Z matthew $

Constants

 
                DECORATOR
                = 'DECORATOR'

inheritedInherited from: \Zend_Form::DECORATOR

Inherited_from: \Zend_Form::DECORATOR

 
                ELEMENT
                = 'ELEMENT'

inheritedInherited from: \Zend_Form::ELEMENT

Inherited_from: \Zend_Form::ELEMENT

 
                METHOD_DELETE
                = 'delete'

inheritedInherited from: \Zend_Form::METHOD_DELETE

Inherited_from: \Zend_Form::METHOD_DELETE

 
                METHOD_GET
                = 'get'

inheritedInherited from: \Zend_Form::METHOD_GET

Inherited_from: \Zend_Form::METHOD_GET

 
                METHOD_POST
                = 'post'

inheritedInherited from: \Zend_Form::METHOD_POST

Inherited_from: \Zend_Form::METHOD_POST

 
                METHOD_PUT
                = 'put'

inheritedInherited from: \Zend_Form::METHOD_PUT

Inherited_from: \Zend_Form::METHOD_PUT

 
                ENCTYPE_URLENCODED
                = 'application/x-www-form-urlencoded'

inheritedInherited from: \Zend_Form::ENCTYPE_URLENCODED

Inherited_from: \Zend_Form::ENCTYPE_URLENCODED

 
                ENCTYPE_MULTIPART
                = 'multipart/form-data'

inheritedInherited from: \Zend_Form::ENCTYPE_MULTIPART

Inherited_from: \Zend_Form::ENCTYPE_MULTIPART

Properties

array $_attribs = array()

inherited

Form metadata and attributes

Inherited from: \Zend_Form::$$_attribs

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_attribs

array $_decorators = array()

inherited

Decorators for rendering

Inherited from: \Zend_Form::$$_decorators

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_decorators

string $_defaultDisplayGroupClass = 'Zend_Form_DisplayGroup'

inherited

Default display group class

Inherited from: \Zend_Form::$$_defaultDisplayGroupClass

Default value'Zend_Form_DisplayGroup'Details

Type: string
Inherited_from: \Zend_Form::$$_defaultDisplayGroupClass

string $_description =

inherited

Form description

Inherited from: \Zend_Form::$$_description

Details

Type: string
Inherited_from: \Zend_Form::$$_description

bool $_disableLoadDefaultDecorators = false

inherited

Should we disable loading the default decorators?

Inherited from: \Zend_Form::$$_disableLoadDefaultDecorators

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Form::$$_disableLoadDefaultDecorators

array $_displayGroupPrefixPaths = array()

inherited

Display group prefix paths

Inherited from: \Zend_Form::$$_displayGroupPrefixPaths

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_displayGroupPrefixPaths

array $_displayGroups = array()

inherited

Groups of elements grouped for display purposes

Inherited from: \Zend_Form::$$_displayGroups

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_displayGroups

null|array $_elementDecorators =

inherited

Global decorators to apply to all elements

Inherited from: \Zend_Form::$$_elementDecorators

Details

Type: null | array
Inherited_from: \Zend_Form::$$_elementDecorators

array $_elementPrefixPaths = array()

inherited

Prefix paths to use when creating elements

Inherited from: \Zend_Form::$$_elementPrefixPaths

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_elementPrefixPaths

array $_elements = array()

inherited

Form elements

Inherited from: \Zend_Form::$$_elements

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_elements

string $_elementsBelongTo =

inherited

Array to which elements belong (if any)

Inherited from: \Zend_Form::$$_elementsBelongTo

Details

Type: string
Inherited_from: \Zend_Form::$$_elementsBelongTo

array $_errorMessages = array()

inherited

Custom form-level error messages

Inherited from: \Zend_Form::$$_errorMessages

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_errorMessages

bool $_errorsExist = false

inherited

Are there errors in the form?

Inherited from: \Zend_Form::$$_errorsExist

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Form::$$_errorsExist

bool $_errorsForced = false

inherited

Has the form been manually flagged as an error?

Inherited from: \Zend_Form::$$_errorsForced

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Form::$$_errorsForced

int|null $_formOrder =

inherited

Form order

Inherited from: \Zend_Form::$$_formOrder

Details

Type: int | null
Inherited_from: \Zend_Form::$$_formOrder

bool $_isArray = false

inherited

Whether or not form elements are members of an array

Inherited from: \Zend_Form::$$_isArray

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Form::$$_isArray

bool $_isRendered = false

inherited

Inherited from: \Zend_Form::$$_isRendered

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Form::$$_isRendered

string $_legend =

inherited

Form legend

Inherited from: \Zend_Form::$$_legend

Details

Type: string
Inherited_from: \Zend_Form::$$_legend

array $_loaders = array()

inherited

Plugin loaders

Inherited from: \Zend_Form::$$_loaders

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_loaders

array $_methods = array('delete', 'get', 'post', 'put')

inherited

Allowed form methods

Inherited from: \Zend_Form::$$_methods

Default valuearray('delete', 'get', 'post', 'put')Details

Type: array
Inherited_from: \Zend_Form::$$_methods

array $_order = array()

inherited

Order in which to display and iterate elements

Inherited from: \Zend_Form::$$_order

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_order

bool $_orderUpdated = false

inherited

Whether internal order has been updated or not

Inherited from: \Zend_Form::$$_orderUpdated

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Form::$$_orderUpdated

array $_subFormPrefixPaths = array()

inherited

Sub form prefix paths

Inherited from: \Zend_Form::$$_subFormPrefixPaths

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_subFormPrefixPaths

array $_subForms = array()

inherited

Sub forms

Inherited from: \Zend_Form::$$_subForms

Default valuearray()Details

Type: array
Inherited_from: \Zend_Form::$$_subForms

\Zend_Translate $_translator =

inherited

Inherited from: \Zend_Form::$$_translator

Details

Type: \Zend_Translate
Inherited_from: \Zend_Form::$$_translator

\Zend_Translate $_translatorDefault =

staticinherited

Global default translation adapter

Inherited from: \Zend_Form::$$_translatorDefault

Details

Type: \Zend_Translate
Inherited_from: \Zend_Form::$$_translatorDefault

bool $_translatorDisabled = false

inherited

is the translator disabled?

Inherited from: \Zend_Form::$$_translatorDisabled

Default valuefalseDetails

Type: bool
Inherited_from: \Zend_Form::$$_translatorDisabled

\Zend_View_Interface $_view =

inherited

Inherited from: \Zend_Form::$$_view

Details

Type: \Zend_View_Interface
Inherited_from: \Zend_Form::$$_view

Methods

__call(string $method, array $args) : string

inherited

Overloading: allow rendering specific decorators

Inherited from: \Zend_Form::__call()

Call renderDecoratorName() to render a specific decorator.

Parameters

Name	Type	Description
$method	string
$args	array

Returns

Type	Description
string

Throws

Exception	Description
\Zend_Form_Exception	for invalid decorator or invalid method call

__clone() : void

inherited

Clone form object and all children

Inherited from: \Zend_Form::__clone()

__construct(array | \Zend_Config | null $options = null) : void

Constructor

Registers form view helper as decorator

Parameters

Name	Type	Description
$options	array \| \Zend_Config \| null

__get(string $name) : \Zend_Form_Element | \Zend_Form | null

inherited

Overloading: access to elements, form groups, and display groups

Inherited from: \Zend_Form::__get()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Form_Element \| \Zend_Form \| null

__isset(string $name) : boolean

inherited

Overloading: access to elements, form groups, and display groups

Inherited from: \Zend_Form::__isset()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
boolean

__set(string $name, \Zend_Form_Element | \Zend_Form $value) : void

inherited

Overloading: access to elements, form groups, and display groups

Inherited from: \Zend_Form::__set()

Parameters

Name	Type	Description
$name	string
$value	\Zend_Form_Element \| \Zend_Form

Throws

Exception	Description
\Zend_Form_Exception	for invalid $value

__toString() : string

inherited

Serialize as string

Inherited from: \Zend_Form::__toString()

Proxies to render().

Returns

Type	Description
string

__unset(string $name) : void

inherited

Overloading: access to elements, form groups, and display groups

Inherited from: \Zend_Form::__unset()

Parameters

Name	Type	Description
$name	string

_addDisplayGroupObject(\Zend_Form_DisplayGroup $group, string | null $name = null) : \Zend_Form

inherited

Add a display group object (used with cloning)

Inherited from: \Zend_Form::_addDisplayGroupObject()

Parameters

Name	Type	Description
$group	\Zend_Form_DisplayGroup
$name	string \| null

Returns

Type	Description
\Zend_Form

_array_replace_recursive(array $into) : void

inherited

This is a helper function until php 5.3 is widespreaded

Inherited from: \Zend_Form::_array_replace_recursive()

Parameters

Name	Type	Description
$into	array

Details

Access: protected

_attachToArray(mixed $value, string $arrayPath) : array

inherited

Converts given arrayPath to an array and attaches given value at the end of it.

Inherited from: \Zend_Form::_attachToArray()

Parameters

Name	Type	Description
$value	mixed	The value to attach
$arrayPath	string	Given array path to convert and attach to.

Returns

Type	Description
array

_dissolveArrayUnsetKey(array $array, string | null $arrayPath, string $key) : array

inherited

Given an array, an optional arrayPath and a key this method dissolves the arrayPath and unsets the key within the array if it exists.

Inherited from: \Zend_Form::_dissolveArrayUnsetKey()

Parameters

Name	Type	Description
$array	array
$arrayPath	string \| null
$key	string

Returns

Type	Description
array

_dissolveArrayValue(array $value, string $arrayPath) : string

inherited

Extract the value by walking the array using given array path.

Inherited from: \Zend_Form::_dissolveArrayValue()

Given an array path such as foo[bar][baz], returns the value of the last element (in this case, 'baz').

Parameters

Name	Type	Description
$value	array	Array to walk
$arrayPath	string	Array notation path of the part to extract

Returns

Type	Description
string

_getArrayName(string $value) : string

inherited

Determine array key name from given value

Inherited from: \Zend_Form::_getArrayName()

Given a value such as foo[bar][baz], returns the last element (in this case, 'baz').

Parameters

Name	Type	Description
$value	string

Returns

Type	Description
string

_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::_getDecorator()

Parameters

Name	Type	Description
$name	string
$options	null \| array

Returns

Type	Description
\Zend_Form_Decorator_Interface

_getErrorMessages() : array

inherited

Retrieve optionally translated custom error messages

Inherited from: \Zend_Form::_getErrorMessages()

Returns

Type	Description
array

_getIsRendered() : void

inherited

Get the value of $_isRendered member

Inherited from: \Zend_Form::_getIsRendered()

_loadDecorator(array $decorator, mixed $name) : \Zend_Form_Decorator_Interface

inherited

Lazy-load a decorator

Inherited from: \Zend_Form::_loadDecorator()

Parameters

Name	Type	Description
$decorator	array	Decorator type and options
$name	mixed	Decorator name or alias

Returns

Type	Description
\Zend_Form_Decorator_Interface

_setElementsBelongTo(string $name = null) : void

inherited

Set array to which elements belong

Inherited from: \Zend_Form::_setElementsBelongTo()

Parameters

Name	Type	Description
$name	string	Element name

_setIsRendered() : void

inherited

When calling renderFormElements or render this method is used to set $_isRendered member to prevent repeatedly merging belongsTo setting

Inherited from: \Zend_Form::_setIsRendered()

_sort() : void

inherited

Sort items according to their order

Inherited from: \Zend_Form::_sort()

addAttribs(array $attribs) : \Zend_Form

inherited

Add multiple form attributes at once

Inherited from: \Zend_Form::addAttribs()

Parameters

Name	Type	Description
$attribs	array

Returns

Type	Description
\Zend_Form

addDecorator(string | \Zend_Form_Decorator_Interface $decorator, array | \Zend_Config $options = null) : \Zend_Form

inherited

Add a decorator for rendering the element

Inherited from: \Zend_Form::addDecorator()

Parameters

Name	Type	Description
$decorator	string \| \Zend_Form_Decorator_Interface
$options	array \| \Zend_Config	Options with which to initialize decorator

Returns

Type	Description
\Zend_Form

addDecorators(array $decorators) : \Zend_Form

inherited

Add many decorators at once

Inherited from: \Zend_Form::addDecorators()

Parameters

Name	Type	Description
$decorators	array

Returns

Type	Description
\Zend_Form

addDisplayGroup(array $elements, string $name, array | \Zend_Config $options = null) : \Zend_Form

inherited

Add a display group

Inherited from: \Zend_Form::addDisplayGroup()

Groups named elements for display purposes.

If a referenced element does not yet exist in the form, it is omitted.

Parameters

Name	Type	Description
$elements	array
$name	string
$options	array \| \Zend_Config

Returns

Type	Description
\Zend_Form

Throws

Exception	Description
\Zend_Form_Exception	if no valid elements provided

addDisplayGroupPrefixPath(string $prefix, string $path) : \Zend_Form

inherited

Add prefix path for all display groups

Inherited from: \Zend_Form::addDisplayGroupPrefixPath()

Parameters

Name	Type	Description
$prefix	string
$path	string

Returns

Type	Description
\Zend_Form

addDisplayGroupPrefixPaths(array $spec) : \Zend_Form

inherited

Add multiple display group prefix paths at once

Inherited from: \Zend_Form::addDisplayGroupPrefixPaths()

Parameters

Name	Type	Description
$spec	array

Returns

Type	Description
\Zend_Form

addDisplayGroups(array $groups) : \Zend_Form

inherited

Add multiple display groups at once

Inherited from: \Zend_Form::addDisplayGroups()

Parameters

Name	Type	Description
$groups	array

Returns

Type	Description
\Zend_Form

addElement(string | \Zend_Form_Element $element, string $name = null, array | \Zend_Config $options = null) : \Zend_Form

inherited

Add a new element

Inherited from: \Zend_Form::addElement()

$element may be either a string element type, or an object of type Zend_Form_Element. If a string element type is provided, $name must be provided, and $options may be optionally provided for configuring the element.

If a Zend_Form_Element is provided, $name may be optionally provided, and any provided $options will be ignored.

Parameters

Name	Type	Description
$element	string \| \Zend_Form_Element
$name	string
$options	array \| \Zend_Config

Returns

Type	Description
\Zend_Form

Throws

Exception	Description
\Zend_Form_Exception	on invalid element

addElementPrefixPath(string $prefix, string $path, string $type = null) : \Zend_Form

inherited

Add prefix path for all elements

Inherited from: \Zend_Form::addElementPrefixPath()

Parameters

Name	Type	Description
$prefix	string
$path	string
$type	string

Returns

Type	Description
\Zend_Form

addElementPrefixPaths(array $spec) : \Zend_Form

inherited

Add prefix paths for all elements

Inherited from: \Zend_Form::addElementPrefixPaths()

Parameters

Name	Type	Description
$spec	array

Returns

Type	Description
\Zend_Form

addElements(array $elements) : \Zend_Form

inherited

Add multiple elements at once

Inherited from: \Zend_Form::addElements()

Parameters

Name	Type	Description
$elements	array

Returns

Type	Description
\Zend_Form

addError(string $message) : \Zend_Form

inherited

Add an error message and mark element as failed validation

Inherited from: \Zend_Form::addError()

Parameters

Name	Type	Description
$message	string

Returns

Type	Description
\Zend_Form

addErrorMessage(string $message) : \Zend_Form

inherited

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

Inherited from: \Zend_Form::addErrorMessage()

Parameters

Name	Type	Description
$message	string

Returns

Type	Description
\Zend_Form

addErrorMessages(array $messages) : \Zend_Form

inherited

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

Inherited from: \Zend_Form::addErrorMessages()

Parameters

Name	Type	Description
$messages	array

Returns

Type	Description
\Zend_Form

addErrors(array $messages) : \Zend_Form

inherited

Add multiple error messages and flag element as failed validation

Inherited from: \Zend_Form::addErrors()

Parameters

Name	Type	Description
$messages	array

Returns

Type	Description
\Zend_Form

addPrefixPath(string $prefix, string $path, string $type = null) : \Zend_Form

inherited

Add prefix path for plugin loader

Inherited from: \Zend_Form::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' - elements: $prefix = $prefix . '_Element'

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

If $type is 'decorator', sets the path in the decorator plugin loader for all elements. Additionally, if no $type is provided, the prefix and path is added to both decorator and element plugin loader with following settings: $prefix . '_Decorator', $path . '/Decorator/' $prefix . '_Element', $path . '/Element/'

Parameters

Name	Type	Description
$prefix	string
$path	string
$type	string

Returns

Type	Description
\Zend_Form

Throws

Exception	Description
\Zend_Form_Exception	for invalid type

addPrefixPaths(array $spec) : \Zend_Form

inherited

Add many prefix paths at once

Inherited from: \Zend_Form::addPrefixPaths()

Parameters

Name	Type	Description
$spec	array

Returns

Type	Description
\Zend_Form

addSubForm(\Zend_Form $form, string $name, int $order = null) : \Zend_Form

inherited

Add a form group/subform

Inherited from: \Zend_Form::addSubForm()

Parameters

Name	Type	Description
$form	\Zend_Form
$name	string
$order	int

Returns

Type	Description
\Zend_Form

addSubForms(array $subForms) : \Zend_Form

inherited

Add multiple form subForms/subforms at once

Inherited from: \Zend_Form::addSubForms()

Parameters

Name	Type	Description
$subForms	array

Returns

Type	Description
\Zend_Form

clearAttribs() : \Zend_Form

inherited

Clear all form attributes

Inherited from: \Zend_Form::clearAttribs()

Returns

Type	Description
\Zend_Form

clearDecorators() : \Zend_Form

inherited

Clear all decorators

Inherited from: \Zend_Form::clearDecorators()

Returns

Type	Description
\Zend_Form

clearDisplayGroups() : \Zend_Form

inherited

Remove all display groups

Inherited from: \Zend_Form::clearDisplayGroups()

Returns

Type	Description
\Zend_Form

clearElements() : \Zend_Form

inherited

Remove all form elements

Inherited from: \Zend_Form::clearElements()

Returns

Type	Description
\Zend_Form

clearErrorMessages() : \Zend_Form

inherited

Clear custom error messages stack

Inherited from: \Zend_Form::clearErrorMessages()

Returns

Type	Description
\Zend_Form

clearSubForms() : \Zend_Form

inherited

Remove all form subForms/subforms

Inherited from: \Zend_Form::clearSubForms()

Returns

Type	Description
\Zend_Form

count() : int

inherited

Count of elements/subforms that are iterable

Inherited from: \Zend_Form::count()

Returns

Type	Description
int

createElement(string $type, string $name, array | \Zend_Config $options = null) : \Zend_Form_Element

inherited

Create an element

Inherited from: \Zend_Form::createElement()

Acts as a factory for creating elements. Elements created with this method will not be attached to the form, but will contain element settings as specified in the form object (including plugin loader prefix paths, default decorators, etc.).

Parameters

Name	Type	Description
$type	string
$name	string
$options	array \| \Zend_Config

Returns

Type	Description
\Zend_Form_Element

current() : \Zend_Form_Element | \Zend_Form_DisplayGroup | \Zend_Form

inherited

Current element/subform/display group

Inherited from: \Zend_Form::current()

Returns

Type	Description
\Zend_Form_Element \| \Zend_Form_DisplayGroup \| \Zend_Form

filterName(string $value, bool $allowBrackets = false) : string

inherited

Filter a name to only allow valid variable characters

Inherited from: \Zend_Form::filterName()

Parameters

Name	Type	Description
$value	string
$allowBrackets	bool

Returns

Type	Description
string

getAction() : string

inherited

Get form action

Inherited from: \Zend_Form::getAction()

Sets default to '' if not set.

Returns

Type	Description
string

getAttrib(string $key) : mixed

inherited

Retrieve a single form attribute

Inherited from: \Zend_Form::getAttrib()

Parameters

Name	Type	Description
$key	string

Returns

Type	Description
mixed

getAttribs() : array

inherited

Retrieve all form attributes/metadata

Inherited from: \Zend_Form::getAttribs()

Returns

Type	Description
array

getCustomMessages() : array

inherited

Retrieve translated custom error messages Proxies to {@link _getErrorMessages()}.

Inherited from: \Zend_Form::getCustomMessages()

Returns

Type	Description
array

getDecorator(string $name) : false | \Zend_Form_Decorator_Abstract

inherited

Retrieve a registered decorator

Inherited from: \Zend_Form::getDecorator()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
false \| \Zend_Form_Decorator_Abstract

getDecorators() : array

inherited

Retrieve all decorators

Inherited from: \Zend_Form::getDecorators()

Returns

Type	Description
array

getDefaultDisplayGroupClass() : string

inherited

Retrieve default display group class

Inherited from: \Zend_Form::getDefaultDisplayGroupClass()

Returns

Type	Description
string

getDefaultTranslator() : null | \Zend_Translate

staticinherited

Get global default translator object

Inherited from: \Zend_Form::getDefaultTranslator()

Returns

Type	Description
null \| \Zend_Translate

getDescription() : string

inherited

Retrieve form description

Inherited from: \Zend_Form::getDescription()

Returns

Type	Description
string

getDisplayGroup(string $name) : \Zend_Form_DisplayGroup | null

inherited

Return a display group

Inherited from: \Zend_Form::getDisplayGroup()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Form_DisplayGroup \| null

getDisplayGroups() : array

inherited

Return all display groups

Inherited from: \Zend_Form::getDisplayGroups()

Returns

Type	Description
array

getElement(string $name) : \Zend_Form_Element | null

inherited

Retrieve a single element

Inherited from: \Zend_Form::getElement()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Form_Element \| null

getElements() : array

inherited

Retrieve all elements

Inherited from: \Zend_Form::getElements()

Returns

Type	Description
array

getElementsAndSubFormsOrdered() : array

inherited

Returns a one dimensional numerical indexed array with the Elements, SubForms and Elements from DisplayGroups as Values.

Inherited from: \Zend_Form::getElementsAndSubFormsOrdered()

Subitems are inserted based on their order Setting if set, otherwise they are appended, the resulting numerical index may differ from the order value.

Returns

Type	Description
array

Details

Access: protected

getElementsBelongTo() : string | null

inherited

Get name of array elements belong to

Inherited from: \Zend_Form::getElementsBelongTo()

Returns

Type	Description
string \| null

getEnctype() : string

inherited

Get encoding type

Inherited from: \Zend_Form::getEnctype()

Returns

Type	Description
string

getErrorMessages() : array

inherited

Retrieve custom error messages

Inherited from: \Zend_Form::getErrorMessages()

Returns

Type	Description
array

getErrors(string $name = null, $suppressArrayNotation = false) : array

inherited

Get error codes for all elements failing validation

Inherited from: \Zend_Form::getErrors()

Parameters

Name	Type	Description
$name	string
$suppressArrayNotation

Returns

Type	Description
array

getFullyQualifiedName() : string

inherited

Get fully qualified name

Inherited from: \Zend_Form::getFullyQualifiedName()

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

Returns

Type	Description
string

getId() : string

inherited

Get element id

Inherited from: \Zend_Form::getId()

Returns

Type	Description
string

getLegend() : string

inherited

Get form legend

Inherited from: \Zend_Form::getLegend()

Returns

Type	Description
string

getMessages(string $name = null, bool $suppressArrayNotation = false) : array

inherited

Retrieve error messages from elements failing validations

Inherited from: \Zend_Form::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.

Parameters

Name	Type	Description
$name	string
$suppressArrayNotation	bool

Returns

Type	Description
array

getMethod() : string

inherited

Retrieve form method

Inherited from: \Zend_Form::getMethod()

Returns

Type	Description
string

getName() : null | string

inherited

Get name attribute

Inherited from: \Zend_Form::getName()

Returns

Type	Description
null \| string

getOrder() : int | null

inherited

Get form order

Inherited from: \Zend_Form::getOrder()

Returns

Type	Description
int \| null

getPluginLoader(string $type = null) : \Zend_Loader_PluginLoader_Interface

inherited

Retrieve plugin loader for given type

Inherited from: \Zend_Form::getPluginLoader()

$type may be one of: - decorator - element

If a plugin loader does not exist for the given type, defaults are created.

Parameters

Name	Type	Description
$type	string

Returns

Type	Description
\Zend_Loader_PluginLoader_Interface

getSubForm(string $name) : \Zend_Form | null

inherited

Retrieve a form subForm/subform

Inherited from: \Zend_Form::getSubForm()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Form \| null

getSubForms() : array

inherited

Retrieve all form subForms/subforms

Inherited from: \Zend_Form::getSubForms()

Returns

Type	Description
array

getTranslator() : \Zend_Translate | null

inherited

Retrieve translator object

Inherited from: \Zend_Form::getTranslator()

Returns

Type	Description
\Zend_Translate \| null

getUnfilteredValue(string $name) : mixed

inherited

Get unfiltered element value

Inherited from: \Zend_Form::getUnfilteredValue()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
mixed

getUnfilteredValues() : array

inherited

Retrieve all unfiltered element values

Inherited from: \Zend_Form::getUnfilteredValues()

Returns

Type	Description
array

getValidValues(array $data, bool $suppressArrayNotation = false) : array

inherited

Returns only the valid values from the given form input.

Inherited from: \Zend_Form::getValidValues()

For models that can be saved in a partially valid state, for example when following the builder, prototype or state patterns it is particularly interessting to retrieve all the current valid values to persist them.

Parameters

Name	Type	Description
$data	array
$suppressArrayNotation	bool

Returns

Type	Description
array

getValue(string $name) : mixed

inherited

Retrieve value for single element

Inherited from: \Zend_Form::getValue()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
mixed

getValues(bool $suppressArrayNotation = false) : array

inherited

Retrieve all form element values

Inherited from: \Zend_Form::getValues()

Parameters

Name	Type	Description
$suppressArrayNotation	bool

Returns

Type	Description
array

getView() : \Zend_View_Interface | null

inherited

Retrieve view object

Inherited from: \Zend_Form::getView()

If none registered, attempts to pull from ViewRenderer.

Returns

Type	Description
\Zend_View_Interface \| null

hasDefaultTranslator() : boolean

staticinherited

Is there a default translation object set?

Inherited from: \Zend_Form::hasDefaultTranslator()

Returns

Type	Description
boolean

hasErrors() : bool

inherited

Are there errors in the form?

Inherited from: \Zend_Form::hasErrors()

Returns

Type	Description
bool

hasTranslator() : bool

inherited

Does this form have its own specific translator?

Inherited from: \Zend_Form::hasTranslator()

Returns

Type	Description
bool

init() : void

inherited

Initialize form (used by extending classes)

Inherited from: \Zend_Form::init()

isArray() : bool

inherited

Get flag indicating if elements belong to an array

Inherited from: \Zend_Form::isArray()

Returns

Type	Description
bool

isErrors() : bool

inherited

Are there errors in the form?

Inherited from: \Zend_Form::isErrors()

Returns

Type	Description
bool

isValid(array $data) : boolean

inherited

Validate the form

Inherited from: \Zend_Form::isValid()

If $value fails validation, then this method returns false, and getMessages() will return an array of messages that explain why the validation failed.

Parameters

Name	Type	Description
$data	array

Returns

Type	Description
boolean

Throws

Exception	Description
\Zend_Validate_Exception	If validation of $value is impossible

isValidPartial(array $data) : boolean

inherited

Validate a partial form

Inherited from: \Zend_Form::isValidPartial()

Does not check for required flags.

Parameters

Name	Type	Description
$data	array

Returns

Type	Description
boolean

key() : string

inherited

Current element/subform/display group name

Inherited from: \Zend_Form::key()

Returns

Type	Description
string

loadDefaultDecorators() : void

Load the default decorators

loadDefaultDecoratorsIsDisabled() : bool

inherited

Should we load the default decorators?

Inherited from: \Zend_Form::loadDefaultDecoratorsIsDisabled()

Returns

Type	Description
bool

markAsError() : \Zend_Form

inherited

Mark the element as being in a failed validation state

Inherited from: \Zend_Form::markAsError()

Returns

Type	Description
\Zend_Form

next() : void

inherited

Move pointer to next element/subform/display group

Inherited from: \Zend_Form::next()

persistData() : void

inherited

Inherited from: \Zend_Form::persistData()

populate(array $values) : \Zend_Form

inherited

Populate form

Inherited from: \Zend_Form::populate()

Proxies to setDefaults()

Parameters

Name	Type	Description
$values	array

Returns

Type	Description
\Zend_Form

processAjax(array $data) : string

inherited

Process submitted AJAX data

Inherited from: \Zend_Form::processAjax()

Checks if provided $data is valid, via isValidPartial(). If so, it returns JSON-encoded boolean true. If not, it returns JSON-encoded error messages (as returned by getMessages()).

Parameters

Name	Type	Description
$data	array

Returns

Type	Description
string	JSON-encoded boolean true or error messages

removeAttrib(string $key) : bool

inherited

Remove attribute

Inherited from: \Zend_Form::removeAttrib()

Parameters

Name	Type	Description
$key	string

Returns

Type	Description
bool

removeDecorator(string $name) : bool

inherited

Remove a single decorator

Inherited from: \Zend_Form::removeDecorator()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
bool

removeDisplayGroup(string $name) : boolean

inherited

Remove a display group by name

Inherited from: \Zend_Form::removeDisplayGroup()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
boolean

removeElement(string $name) : boolean

inherited

Remove element

Inherited from: \Zend_Form::removeElement()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
boolean

removeFromIteration(string $name) : void

inherited

Remove an element from iteration

Inherited from: \Zend_Form::removeFromIteration()

Parameters

Name	Type	Description
$name	string	Element/group/form name

removeSubForm(string $name) : boolean

inherited

Remove form subForm/subform

Inherited from: \Zend_Form::removeSubForm()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
boolean

render(\Zend_View_Interface $view = null) : string

inherited

Render form

Inherited from: \Zend_Form::render()

Parameters

Name	Type	Description
$view	\Zend_View_Interface

Returns

Type	Description
string

reset() : \Zend_Form

inherited

Reset values of form

Inherited from: \Zend_Form::reset()

Returns

Type	Description
\Zend_Form

rewind() : void

inherited

Move pointer to beginning of element/subform/display group loop

Inherited from: \Zend_Form::rewind()

setAction(string $action) : \Zend_Form

inherited

Set form action

Inherited from: \Zend_Form::setAction()

Parameters

Name	Type	Description
$action	string

Returns

Type	Description
\Zend_Form

setAttrib(string $key, mixed $value) : \Zend_Form

inherited

Set form attribute

Inherited from: \Zend_Form::setAttrib()

Parameters

Name	Type	Description
$key	string
$value	mixed

Returns

Type	Description
\Zend_Form

setAttribs(array $attribs) : \Zend_Form

inherited

Set multiple form attributes at once

Inherited from: \Zend_Form::setAttribs()

Overwrites any previously set attributes.

Parameters

Name	Type	Description
$attribs	array

Returns

Type	Description
\Zend_Form

setConfig(\Zend_Config $config) : \Zend_Form

inherited

Set form state from config object

Inherited from: \Zend_Form::setConfig()

Parameters

Name	Type	Description
$config	\Zend_Config

Returns

Type	Description
\Zend_Form

setDecorators(array $decorators) : \Zend_Form

inherited

Overwrite all decorators

Inherited from: \Zend_Form::setDecorators()

Parameters

Name	Type	Description
$decorators	array

Returns

Type	Description
\Zend_Form

setDefault(string $name, mixed $value) : \Zend_Form

inherited

Set default value for an element

Inherited from: \Zend_Form::setDefault()

Parameters

Name	Type	Description
$name	string
$value	mixed

Returns

Type	Description
\Zend_Form

setDefaultDisplayGroupClass(string $class) : \Zend_Form

inherited

Set default display group class

Inherited from: \Zend_Form::setDefaultDisplayGroupClass()

Parameters

Name	Type	Description
$class	string

Returns

Type	Description
\Zend_Form

setDefaultTranslator(\Zend_Translate | \Zend_Translate_Adapter | null $translator = null) : void

staticinherited

Set global default translator object

Inherited from: \Zend_Form::setDefaultTranslator()

Parameters

Name	Type	Description
$translator	\Zend_Translate \| \Zend_Translate_Adapter \| null

setDefaults(array $defaults) : \Zend_Form

inherited

Set default values for elements

Inherited from: \Zend_Form::setDefaults()

Sets values for all elements specified in the array of $defaults.

Parameters

Name	Type	Description
$defaults	array

Returns

Type	Description
\Zend_Form

setDescription(string $value) : \Zend_Form

inherited

Set form description

Inherited from: \Zend_Form::setDescription()

Parameters

Name	Type	Description
$value	string

Returns

Type	Description
\Zend_Form

setDisableLoadDefaultDecorators(bool $flag) : \Zend_Form

inherited

Set flag to disable loading default decorators

Inherited from: \Zend_Form::setDisableLoadDefaultDecorators()

Parameters

Name	Type	Description
$flag	bool

Returns

Type	Description
\Zend_Form

setDisableTranslator(bool $flag) : \Zend_Form

inherited

Indicate whether or not translation should be disabled

Inherited from: \Zend_Form::setDisableTranslator()

Parameters

Name	Type	Description
$flag	bool

Returns

Type	Description
\Zend_Form

setDisplayGroupDecorators(array $decorators) : \Zend_Form

inherited

Set all display group decorators as specified

Inherited from: \Zend_Form::setDisplayGroupDecorators()

Parameters

Name	Type	Description
$decorators	array

Returns

Type	Description
\Zend_Form

setDisplayGroups(array $groups) : \Zend_Form

inherited

Add multiple display groups (overwrites)

Inherited from: \Zend_Form::setDisplayGroups()

Parameters

Name	Type	Description
$groups	array

Returns

Type	Description
\Zend_Form

setElementDecorators(array $decorators, array | null $elements = null, bool $include = true) : \Zend_Form

inherited

Set all element decorators as specified

Inherited from: \Zend_Form::setElementDecorators()

Parameters

Name	Type	Description
$decorators	array
$elements	array \| null	Specific elements to decorate or exclude from decoration
$include	bool	Whether $elements is an inclusion or exclusion list

Returns

Type	Description
\Zend_Form

setElementFilters(array $filters) : \Zend_Form

inherited

Set all elements' filters

Inherited from: \Zend_Form::setElementFilters()

Parameters

Name	Type	Description
$filters	array

Returns

Type	Description
\Zend_Form

setElements(array $elements) : \Zend_Form

inherited

Set form elements (overwrites existing elements)

Inherited from: \Zend_Form::setElements()

Parameters

Name	Type	Description
$elements	array

Returns

Type	Description
\Zend_Form

setElementsBelongTo(string $array) : \Zend_Form

inherited

Set name of array elements belong to

Inherited from: \Zend_Form::setElementsBelongTo()

Parameters

Name	Type	Description
$array	string

Returns

Type	Description
\Zend_Form

setEnctype(string $value) : \Zend_Form

inherited

Set encoding type

Inherited from: \Zend_Form::setEnctype()

Parameters

Name	Type	Description
$value	string

Returns

Type	Description
\Zend_Form

setErrorMessages(array $messages) : \Zend_Form

inherited

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

Inherited from: \Zend_Form::setErrorMessages()

Parameters

Name	Type	Description
$messages	array

Returns

Type	Description
\Zend_Form

setErrors(array $messages) : \Zend_Form

inherited

Overwrite any previously set error messages and flag as failed validation

Inherited from: \Zend_Form::setErrors()

Parameters

Name	Type	Description
$messages	array

Returns

Type	Description
\Zend_Form

setIsArray(bool $flag) : \Zend_Form

inherited

Set flag indicating elements belong to array

Inherited from: \Zend_Form::setIsArray()

Parameters

Name	Type	Description
$flag	bool	Value of flag

Returns

Type	Description
\Zend_Form

setLegend(string $value) : \Zend_Form

inherited

Set form legend

Inherited from: \Zend_Form::setLegend()

Parameters

Name	Type	Description
$value	string

Returns

Type	Description
\Zend_Form

setMethod(string $method) : \Zend_Form

inherited

Set form method

Inherited from: \Zend_Form::setMethod()

Only values in $_methods() allowed

Parameters

Name	Type	Description
$method	string

Returns

Type	Description
\Zend_Form

Throws

Exception	Description
\Zend_Form_Exception

setName(string $name) : \Zend_Form

inherited

Set form name

Inherited from: \Zend_Form::setName()

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Form

setOptions(array $options) : \Zend_Form

inherited

Set form state from options array

Inherited from: \Zend_Form::setOptions()

Parameters

Name	Type	Description
$options	array

Returns

Type	Description
\Zend_Form

setOrder(int $index) : \Zend_Form

inherited

Set form order

Inherited from: \Zend_Form::setOrder()

Parameters

Name	Type	Description
$index	int

Returns

Type	Description
\Zend_Form

setPluginLoader(\Zend_Loader_PluginLoader_Interface $loader, string $type = null) : \Zend_Form

inherited

Set plugin loaders for use with decorators and elements

Inherited from: \Zend_Form::setPluginLoader()

Parameters

Name	Type	Description
$loader	\Zend_Loader_PluginLoader_Interface
$type	string	'decorator' or 'element'

Returns

Type	Description
\Zend_Form

Throws

Exception	Description
\Zend_Form_Exception	on invalid type

setSubFormDecorators(array $decorators) : \Zend_Form

inherited

Set all subform decorators as specified

Inherited from: \Zend_Form::setSubFormDecorators()

Parameters

Name	Type	Description
$decorators	array

Returns

Type	Description
\Zend_Form

setSubForms(array $subForms) : \Zend_Form

inherited

Set multiple form subForms/subforms (overwrites)

Inherited from: \Zend_Form::setSubForms()

Parameters

Name	Type	Description
$subForms	array

Returns

Type	Description
\Zend_Form

setTranslator(\Zend_Translate | \Zend_Translate_Adapter | null $translator = null) : \Zend_Form

inherited

Set translator object

Inherited from: \Zend_Form::setTranslator()

Parameters

Name	Type	Description
$translator	\Zend_Translate \| \Zend_Translate_Adapter \| null

Returns

Type	Description
\Zend_Form

setView(\Zend_View_Interface $view = null) : \Zend_Dojo_Form_Element_Dijit

Set the view object

Ensures that the view object has the dojo view helper path set.

Parameters

Name	Type	Description
$view	\Zend_View_Interface

Returns

Type	Description
\Zend_Dojo_Form_Element_Dijit

translatorIsDisabled() : bool

inherited

Is translation disabled?

Inherited from: \Zend_Form::translatorIsDisabled()

Returns

Type	Description
bool

valid() : bool

inherited

Determine if current element/subform/display group is valid

Inherited from: \Zend_Form::valid()

Returns

Type	Description
bool

Dojo/Form.php

\Zend_Dojo_Formjump to top

Constants

Properties

Methods

\Zend_Dojo_Form
jump to top