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


require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::addElement ( mixed $element )


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.


mixed $element

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

Return value

return reference to added element


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


since 1.0

This function can not be called statically.

Class constructor (Previous) Returns the current API version (Next)
Last updated: Sat, 16 Feb 2019 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report.
View this page in:
  • English

User Notes:

There are no user contributed notes for this page.