Docs For Class HTML_QuickForm2

HTML_QuickForm2_Node __construct(
[string
$name = null], [string|array
$attributes = null], [
$data = array()])

Class constructor

Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_Select::__construct(): Class constructor

HTML_QuickForm2_Element_Static::__construct(): Class constructor

HTML_QuickForm2_Element_InputFile::__construct(): Class constructor

HTML_QuickForm2_Element_InputCheckable::__construct()

HTML_QuickForm2_Element_InputCheckbox::__construct()

HTML_QuickForm2::__construct(): Class constructor, form's "id" and "method" attributes can only be set here

HTML_QuickForm2_Container_Repeat::__construct(): Class constructor

HTML_QuickForm2_Element_Date::__construct(): Class constructor

HTML_QuickForm2_Element_Hierselect::__construct(): Class constructor

Parameters:

string	`$name`	—	Element name
string\|array	`$attributes`	—	HTML attributes (either a string or an array)
array	`$data`	—	Element data (label, options used for element setup)

[ Top ]

HTML_QuickForm2_Node addFilter(
callback
$callback, [
$options = array()])

Adds a filter

A filter is simply a PHP callback which will be applied to the element value when getValue() is called.

Return: The element
Throws: HTML_QuickForm2_InvalidArgumentException If callback is incorrect
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_InputFile::addFilter()

Parameters:

callback	`$callback`	—	The PHP callback used for filter
array	`$options`	—	Optional arguments for the callback. The first parameter will always be the element value, then these options will be used as parameters for the callback.

[ Top ]

HTML_QuickForm2_Node addRecursiveFilter(
callback
$callback, [
$options = array()])

Adds a recursive filter

A filter is simply a PHP callback which will be applied to the element value when getValue() is called. If the element value is an array, for example with selects of type 'multiple', the filter is applied to all values recursively. A filter on a container will not be applied on a container value but propagated to all contained elements instead.

If the element is not a container and its value is not an array the behaviour will be identical to filters added via addFilter().

Return: The element
Throws: HTML_QuickForm2_InvalidArgumentException If callback is incorrect
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_InputFile::addRecursiveFilter()

Parameters:

callback	`$callback`	—	The PHP callback used for filter
array	`$options`	—	Optional arguments for the callback. The first parameter will always be the element value, then these options will be used as parameters for the callback.

[ Top ]

HTML_QuickForm2_Rule addRule(
HTML_QuickForm2_Rule|string
$rule, [string|int
$messageOrRunAt = ''], [mixed
$options = null], [int
$runAt = HTML_QuickForm2_Rule::SERVER])

Adds a validation rule

Return: The added rule
Throws: HTML_QuickForm2_NotFoundException if class for a given rule name cannot be found
Throws: HTML_QuickForm2_InvalidArgumentException if $rule is of a wrong type or rule name isn't registered with Factory
Access: public

Parameters:

HTML_QuickForm2_Rule\|string	`$rule`	—	Validation rule or rule type
string\|int	`$messageOrRunAt`	—	If first parameter is rule type, then message to display if validation fails, otherwise constant showing whether to perfom validation client-side and/or server-side
mixed	`$options`	—	Configuration data for the rule
int	`$runAt`	—	Whether to perfom validation server-side and/or client side. Combination of HTML_QuickForm2_Rule::SERVER and HTML_QuickForm2_Rule::CLIENT constants

[ Top ]

void applyFilter(
mixed
&$value, mixed
$key, array
$filter)

Helper function for applying filter callback to a value

Access: protected

Parameters:

mixed	`&$value`	—	Value being filtered
mixed	`$key`	—	Array key (not used, present to be able to use this method as a callback to array_walk_recursive())
array	`$filter`	—	Array containing callback and additional callback parameters

[ Top ]

mixed applyFilters(
mixed
$value)

Applies non-recursive filters on element value

Return: Filtered value
Access: protected

Overridden in child classes as:

HTML_QuickForm2_Element::applyFilters(): Applies recursive and non-recursive filters on element value

Parameters:

mixed $value — Element value

[ Top ]

HTML_QuickForm2_Rule createRule(
string
$type, [string
$message = ''], [mixed
$options = null])

Creates a validation rule

This method is mostly useful when when chaining several rules together via HTML_QuickForm2_Rule::and_() and HTML_QuickForm2_Rule::or_() methods:

 $first->addRule('nonempty', 'Fill in either first or second field')

     ->or_($second->createRule('nonempty'));

Return: The created rule
Throws: HTML_QuickForm2_NotFoundException If class for the rule can't be found and/or loaded from file
Throws: HTML_QuickForm2_InvalidArgumentException If rule type is unknown
Access: public

Parameters:

string	`$type`	—	Rule type
string	`$message`	—	Message to display if validation fails
mixed	`$options`	—	Configuration data for the rule

[ Top ]

string generateId(
string
$elementName)

Generates an id for the element

Called when an element is created without explicitly given id

Return: The generated element id
Access: protected

Parameters:

string $elementName — Element name

[ Top ]

HTML_QuickForm2_Container|null getContainer(
)

Returns the element containing current

Access: public

[ Top ]

array getData(
)

Returns the element options

Access: public

[ Top ]

array getDataSources(
)

Returns the data sources for this element

Access: protected

Overridden in child classes as:

HTML_QuickForm2::getDataSources(): Returns the list of data sources attached to the form

HTML_QuickForm2_Container_Repeat::getDataSources(): Returns the data sources for this element

[ Top ]

string getError(
)

Returns the error message for the element

Access: public

[ Top ]

string getId(
)

Returns the element's id

Access: public

[ Top ]

array getJavascriptTriggers(
)

Returns IDs of form fields that should trigger "live" Javascript validation

Rules added to this element with parameter HTML_QuickForm2_Rule::ONBLUR_CLIENT will be run by after these form elements change or lose focus

Abstract:
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element::getJavascriptTriggers()

HTML_QuickForm2_Element_DualSelect::getJavascriptTriggers()

HTML_QuickForm2_Element_Static::getJavascriptTriggers()

HTML_QuickForm2_Container::getJavascriptTriggers()

[ Top ]

string getJavascriptValue(
[bool
$inContainer = false])

Returns Javascript code for getting the element's value

Abstract:
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element::getJavascriptValue(): Returns Javascript code for getting the element's value

HTML_QuickForm2_Element_DualSelect::getJavascriptValue(): Returns Javascript code for getting the element's value

HTML_QuickForm2_Element_Static::getJavascriptValue()

HTML_QuickForm2_Container::getJavascriptValue(): Returns Javascript code for getting the element's value

Parameters:

bool $inContainer — Whether it should return a parameter for qf.form.getContainerValue()

[ Top ]

string|array getLabel(
)

Returns the element's label(s)

Access: public

[ Top ]

string getName(
)

Returns the element's name

Access: public

Overridden in child classes as:

HTML_QuickForm2_Container_Group::getName()

HTML_QuickForm2_Container_Fieldset::getName()

[ Top ]

mixed getRawValue(
)

Returns the element's value without filters applied

Abstract:
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_Select::getRawValue(): Returns the value of the <select> element

HTML_QuickForm2_Element_Static::getRawValue(): Static elements have no value

HTML_QuickForm2_Element_Input::getRawValue()

HTML_QuickForm2_Element_InputFile::getRawValue(): Returns the information on uploaded file

HTML_QuickForm2_Element_InputButton::getRawValue(): Button elements cannot have any submit values

HTML_QuickForm2_Element_InputCheckable::getRawValue()

HTML_QuickForm2_Element_InputSubmit::getRawValue(): Returns the element's value

HTML_QuickForm2_Element_InputReset::getRawValue(): Reset elements cannot have any submit values

HTML_QuickForm2_Element_InputImage::getRawValue(): Returns the element's value

HTML_QuickForm2_Element_Button::getRawValue(): Returns the element's value

HTML_QuickForm2_Element_Textarea::getRawValue()

HTML_QuickForm2_Container::getRawValue(): Returns the container's value without filters applied

[ Top ]

string getType(
)

Returns the element's type

Abstract:
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_Select::getType()

HTML_QuickForm2_Element_Static::getType()

HTML_QuickForm2_Element_Script::getType()

HTML_QuickForm2_Element_Input::getType()

HTML_QuickForm2_Element_Button::getType()

HTML_QuickForm2_Element_Textarea::getType()

HTML_QuickForm2::getType()

HTML_QuickForm2_Container_Repeat::getType(): Returns the element's type

HTML_QuickForm2_Container_Group::getType()

HTML_QuickForm2_Element_Date::getType()

HTML_QuickForm2_Element_Hierselect::getType()

HTML_QuickForm2_Container_Fieldset::getType()

[ Top ]

mixed getValue(
)

Returns the element's value, possibly with filters applied

Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_InputFile::getValue(): Alias of getRawValue(), InputFile elements do not allow filters

HTML_QuickForm2_Container::getValue(): Returns the container's value, possibly with filters applied

[ Top ]

boolean isRequired(
)

Checks whether an element is required

Access: public

[ Top ]

void onAttributeChange(
string
$name, [string
$value = null])

Intercepts setting 'name' and 'id' attributes

These attributes should always be present and thus trying to remove them will result in an exception. Changing their values is delegated to setName() and setId() methods, respectively

Throws: HTML_QuickForm2_InvalidArgumentException if trying to remove a required attribute
Access: protected

Overridden in child classes as:

HTML_QuickForm2_Element_DualSelect::onAttributeChange()

HTML_QuickForm2_Element_Static::onAttributeChange(): Intercepts setting 'name' and 'id' attributes

HTML_QuickForm2_Element_Input::onAttributeChange()

HTML_QuickForm2_Element_InputCheckable::onAttributeChange()

HTML_QuickForm2_Controller_DefaultAction::onAttributeChange(): Disallow changing the 'id' attribute

HTML_QuickForm2::onAttributeChange()

Parameters:

string	`$name`	—	Attribute name
string	`$value`	—	Attribute value, null if attribute is being removed

[ Top ]

bool persistentFreeze(
[bool
$persistent = null])

Changes the element's persistent freeze behaviour

If persistent freeze is on, the element's value will be kept (and submitted) in a hidden field when the element is frozen.

Return: Old value of "persistent freeze" flag
Access: public

Overridden in child classes as:

HTML_QuickForm2_Container::persistentFreeze()

Parameters:

bool $persistent — New value for "persistent freeze". If omitted, the method will not set anything, just return the current value of the flag.

[ Top ]

HTML_QuickForm2_Rule removeRule(
HTML_QuickForm2_Rule
$rule)

Removes a validation rule

The method will *not* throw an Exception if the rule wasn't added to the element.

Return: Removed rule
Access: public

Parameters:

HTML_QuickForm2_Rule $rule — Validation rule to remove

[ Top ]

HTML_QuickForm2_Renderer render(
HTML_QuickForm2_Renderer
$renderer)

Renders the element using the given renderer

Abstract:
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element::render(): Renders the element using the given renderer

HTML_QuickForm2_Element_DualSelect::render()

HTML_QuickForm2_Element_Script::render(): Renders the element as the "hidden" one

HTML_QuickForm2_Element_InputHidden::render()

HTML_QuickForm2_Controller_DefaultAction::render(): This element is rendered using renderHidden() method

HTML_QuickForm2_Container::render(): Renders the container using the given renderer

HTML_QuickForm2::render(): Renders the form using the given renderer

HTML_QuickForm2_Container_Repeat::render(): Renders the container using the given renderer

HTML_QuickForm2_Container_Group::render(): Renders the group using the given renderer

HTML_QuickForm2_Element_Hierselect::render(): Renders the hierselect using the given renderer

Parameters:

HTML_QuickForm2_Renderer $renderer —

[ Top ]

void renderClientRules(
HTML_QuickForm2_JavascriptBuilder
$builder)

Adds element's client-side validation rules to a builder object

Access: protected

Parameters:

HTML_QuickForm2_JavascriptBuilder $builder —

[ Top ]

void setContainer(
[HTML_QuickForm2_Container
$container = null])

Adds the link to the element containing current

Throws: HTML_QuickForm2_InvalidArgumentException If trying to set a child of an element as its container
Access: protected

Overridden in child classes as:

HTML_QuickForm2::setContainer()

Parameters:

HTML_QuickForm2_Container $container — Element containing the current one, null if the link should really be removed (if removing from container)

[ Top ]

HTML_QuickForm2_Node setError(
[string
$error = null])

Sets the error message to the element

Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_InputHidden::setError(): Disallows setting an error message on hidden elements

Parameters:

string $error —

[ Top ]

HTML_QuickForm2_Node setId(
[string
$id = null])

Sets the element's id

Please note that elements should always have an id in QuickForm2 and therefore it will not be possible to remove the element's id or set it to an empty value. If id is not explicitly given, it will be autogenerated.

Throws: HTML_QuickForm2_InvalidArgumentException if id contains invalid characters (i.e. spaces)
Access: public

Overridden in child classes as:

HTML_QuickForm2::setId()

Parameters:

string $id — Element's id, will be autogenerated if not given

[ Top ]

HTML_QuickForm2_Node setLabel(
string|array
$label)

Sets the element's label(s)

Access: public

Parameters:

string|array $label — Label for the element (may be an array of labels)

[ Top ]

HTML_QuickForm2_Node setName(
string
$name)

Sets the element's name

Abstract:
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element::setName()

HTML_QuickForm2_Element_Static::setName(): Sets the element's name

HTML_QuickForm2_Container::setName()

HTML_QuickForm2_Container_Group::setName()

HTML_QuickForm2_Element_Hierselect::setName(): Sets the element's name

HTML_QuickForm2_Container_Fieldset::setName()

Parameters:

string $name —

[ Top ]

HTML_QuickForm2_Node setValue(
mixed
$value)

Sets the element's value

Abstract:
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_Select::setValue()

HTML_QuickForm2_Element_Static::setValue(): Static element's content can also be set via this method

HTML_QuickForm2_Element_Input::setValue()

HTML_QuickForm2_Element_InputFile::setValue(): File upload's value cannot be set here

HTML_QuickForm2_Element_InputButton::setValue(): Button elements cannot have any submit values

HTML_QuickForm2_Element_InputCheckable::setValue()

HTML_QuickForm2_Element_InputSubmit::setValue(): Submit's value cannot be set via this method

HTML_QuickForm2_Element_InputReset::setValue(): Reset elements cannot have any submit values

HTML_QuickForm2_Element_InputImage::setValue(): Image button's value cannot be set via this method

HTML_QuickForm2_Element_Button::setValue(): Button's value cannot be set via this method

HTML_QuickForm2_Element_Textarea::setValue()

HTML_QuickForm2::setValue()

HTML_QuickForm2_Container_Repeat::setValue(): Sets the element's value (not implemented)

HTML_QuickForm2_Container_Group::setValue()

HTML_QuickForm2_Element_Date::setValue(): Tries to convert the given value to a usable date before setting the element value

HTML_QuickForm2_Element_Hierselect::setValue(): Sets the element's value

HTML_QuickForm2_Container_Fieldset::setValue()

Parameters:

mixed $value —

[ Top ]

void storeId(
string
$id)

Stores the explicitly given id to prevent duplicate id generation

Access: protected

Parameters:

string $id — Element id

[ Top ]

bool toggleFrozen(
[bool
$freeze = null])

Changes the element's frozen status

Return: Old value of element's frozen status
Access: public

Overridden in child classes as:

HTML_QuickForm2_Element_Static::toggleFrozen(): Static element can not be frozen

HTML_QuickForm2_Element_InputFile::toggleFrozen(): File upload elements cannot be frozen

HTML_QuickForm2_Element_InputButton::toggleFrozen(): Buttons can not be frozen

HTML_QuickForm2_Element_InputSubmit::toggleFrozen(): Submit buttons can not be frozen

HTML_QuickForm2_Element_InputReset::toggleFrozen(): Reset buttons can not be frozen

HTML_QuickForm2_Element_InputHidden::toggleFrozen(): Hidden elements can not be frozen

HTML_QuickForm2_Element_InputImage::toggleFrozen(): Image buttons can not be frozen

HTML_QuickForm2_Element_Button::toggleFrozen(): Buttons can not be frozen

HTML_QuickForm2_Container::toggleFrozen()

Parameters:

bool $freeze — Whether the element should be frozen or editable. If omitted, the method will not change the frozen status, just return its current value

[ Top ]

void updateValue(
)

Called when the element needs to update its value from form's data sources

Abstract:
Access: protected

Overridden in child classes as:

HTML_QuickForm2_Element::updateValue(): Called when the element needs to update its value from form's data sources

HTML_QuickForm2_Element_Select::updateValue()

HTML_QuickForm2_Element_Static::updateValue(): Called when the element needs to update its value from form's data sources

HTML_QuickForm2_Element_InputFile::updateValue()

HTML_QuickForm2_Element_InputCheckbox::updateValue()

HTML_QuickForm2_Element_InputSubmit::updateValue()

HTML_QuickForm2_Element_InputImage::updateValue()

HTML_QuickForm2_Element_Button::updateValue()

HTML_QuickForm2_Container::updateValue(): Called when the element needs to update its value from form's data sources

HTML_QuickForm2_Container_Repeat::updateValue(): Called when the element needs to update its value from form's data sources

HTML_QuickForm2_Element_Date::updateValue(): Called when the element needs to update its value from form's data sources

HTML_QuickForm2_Element_Hierselect::updateValue(): Called when the element needs to update its value from form's data sources

[ Top ]

boolean validate(
)

Performs the server-side validation

Return: Whether the element is valid
Access: protected

Overridden in child classes as:

HTML_QuickForm2_Element_InputFile::validate(): Performs the server-side validation

HTML_QuickForm2_Container::validate(): Performs the server-side validation

HTML_QuickForm2::validate(): Performs the server-side validation

HTML_QuickForm2_Container_Repeat::validate(): Performs the server-side validation

[ Top ]

Class: HTML_QuickForm2_Node

Class Overview

Author(s):

Version:

Variables

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Class Variables

$container = null

$data = array()

$error = null

$filters = array()

$frozen = false

$ids = array()

$persistent = false

$recursiveFilters = array()

$rules = array()

$watchedAttributes = array('id', 'name')

Method Detail

__construct (Constructor) [line 201]

Parameters:

addFilter [line 723]

Parameters:

addRecursiveFilter [line 754]

Parameters:

addRule [line 548]

Parameters:

applyFilter [line 774]

Parameters:

applyFilters [line 788]

Parameters:

createRule [line 609]

Parameters:

generateId [line 224]

Parameters:

getContainer [line 506]

getData [line 295]

getDataSources [line 516]

getError [line 684]

getId [line 335]

getJavascriptTriggers [line 707]

getJavascriptValue [line 697]

Parameters:

getLabel [line 405]

getName [line 314]

getRawValue [line 377]

getType [line 306]

getValue [line 384]

isRequired [line 620]

onAttributeChange [line 173]

Parameters:

persistentFreeze [line 459]

Parameters:

removeRule [line 578]

Parameters:

render [line 802]

Parameters:

renderClientRules [line 635]

Parameters:

setContainer [line 479]

Parameters:

setError [line 673]

Parameters:

setId [line 354]

Parameters:

setLabel [line 421]

Parameters:

setName [line 327]

Parameters:

setValue [line 397]

Parameters:

storeId [line 275]

Parameters:

toggleFrozen [line 437]

Parameters:

updateValue [line 528]

validate [line 653]