HTML_QuickForm::addElement()

HTML_QuickForm::addElement() – Adds an element into the form

Synopsis

require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::addElement ( mixed $element )

Description

Adds an element into the form. If $element is a string representing an element type, then this method accepts variable number of parameters, their meaning and count depending on element type.

Parameters starting from second will be passed to the element's constructor, consult the docs for the appropriate element to find out which parameters to pass.

Parameter

mixed $element

element object or type of element to add (text, textarea, file...)

Return value

return reference to added element

Throws

Possible PEAR_Error values
Error code Error message Reason Solution
QUICKFORM_UNREGISTERED_ELEMENT Element '$element' does not exist in HTML_QuickForm::_loadElement() Tried to add an element of unknown type Check the type name spelling or use HTML_QuickForm::registerElementType()
QUICKFORM_INVALID_ELEMENT_NAME Element 'elementName' already exists in HTML_QuickForm::addElement() Tried to add an element having a name of an existing element, but of different type Choose a different name for an element

Note

since 1.0

This function can not be called statically.