HTML_QuickForm::insertElementBefore()

HTML_QuickForm::insertElementBefore() -- Insert un nouvel élément avant un autre élément

Synopsis

require_once 'HTML/QuickForm.php';

object &HTML_QuickForm::insertElementBefore (object &$element, string $nameAfter)

Description

Insert un nouvel élément avant un autre élément.

Il n'est pas possible de vérifier si l'élément $element a déjà été ajouté au formulaire, toutefois, si vous voulez déplacer l'élément existant du formulaire à une nouvelle position, vous devez utiliser la méthode removeElement() :
$form->insertElementBefore($form->removeElement('foo', false), 'bar');

Paramètres

object &$element

Élément à insérer (une instance de HTML_QuickForm_element)

chaîne de caractères $nameAfter

Nom de l'élément par rapport auquel le nouveau sera inséré

Valeur retournée

Retourne une référence sur l'élément inséré.

Valeurs renvoyées

Tableau 42-1. Valeurs PEAR_Error possibles

Code erreurMessage d'erreurRaisonSolution
QUICKFORM_INVALID_ELEMENT_NAMESeveral elements named $nameAfter exist in HTML_QuickForm::insertElementBefore()Plusieurs éléments nommés $nameAfter (e.g.: radios) existent dans le formulaire. La méthode ne gère pas ce cas.Insérer avant d'autres éléments. Ajoutez un élément avec un nom unique.
QUICKFORM_INVALID_ELEMENT_NAMEElement '$elementName' already exists in HTML_QuickForm::insertElementBefore()Un élément existe avec le même nom que $element mais avec un type différentDonnez un nom différent à l'élémentà insérer.
QUICKFORM_NONEXIST_ELEMENTElement $nameAfter does not exist in HTML_QuickForm::insertElementBefore()Tentative d'insertion avant un élément non existantVérifiez le nom de l'élément

Note

Disponible depuis la version 3.2.4.

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