HTML_QuickForm::addElement()

HTML_QuickForm::addElement() -- Ajoute un élément dans un formulaire

Synopsis

require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::addElement (mixed $element)

Description

Ajoute un élément dans un formulaire. Si le paramètre $element est une chaîne de caractères représentant un type d'élément, alors cette méthode accepte un nombre variable de paramètres, leurs significations et leurs nombres dépendent du type de l'élément.

Les paramères, à partir du deuxième, sont passés au constructeur d'élément, consultez la documentation pour les éléments appropriés pour trouver les paramètres à passer.

Paramètres

mixed $element

Objet élément ou type d'élément à ajouter (texte, textarea, fichier...)

Valeur retournée

Retourne une référence à l'élément ajouté.

Valeurs renvoyées

Tableau 42-1. Valeurs PEAR_Error possibles

Code erreurMessage d'erreurRaisonSolution
QUICKFORM_UNREGISTERED_ELEMENTElement '$element' does not exist in HTML_QuickForm::_loadElement()Tentative d'ajout d'un élément de type inconnuVérifiez l'orthographe du nom du type ou utilisez HTML_QuickForm::registerElementType()
QUICKFORM_INVALID_ELEMENT_NAMEElement 'elementName' already exists in HTML_QuickForm::addElement()Tentative d'ajout d'un élément dont le nom correspond au nom d'un élément existant mais dont le type est différentChoisissez un nom différent pour l'élément

Note

Disponible depuis la version 1.0.

Cette fonction ne peut pas être appelée de façon statique.