Manuel Pear

HTML_QuickForm::insertElementBefore()

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

Synopsis

  1. <?php
  2. require_once 'HTML/QuickForm.php
  3. ?> 

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() :

  1. <?php
  2. $form->insertElementBefore($form->removeElement('foo', false), 'bar'  
  3. ?> 

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 47-1. Valeurs PEAR_Error possibles

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

Note

Disponible depuis la version 3.2.4.

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


Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique