object &HTML_QuickForm::insertElementBefore (
object &$element
, string $nameAfter
)
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() :
<?php
$form->insertElementBefore($form->removeElement('foo', false), 'bar');
?>
Élément à insérer (une instance de HTML_QuickForm_element)
Nom de l'élément par rapport auquel le nouveau sera inséré
Retourne une référence sur l'élément inséré.
| Code erreur | Message d'erreur | Raison | Solution |
|---|---|---|---|
| QUICKFORM_INVALID_ELEMENT_NAME | Several 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_NAME | Element '$elementName' already exists in HTML_QuickForm::insertElementBefore() | Un élément existe avec le même nom que $element mais avec un type différent | Donnez un nom différent à l'élémentà insérer. |
| QUICKFORM_NONEXIST_ELEMENT | Element $nameAfter does not exist in HTML_QuickForm::insertElementBefore() | Tentative d'insertion avant un élément non existant | Vérifiez le nom de l'élément |
Disponible depuis la version 3.2.4.
This function can not be called statically.