Usare HTML_QuickForm in pratica

A parte andare a dare un’occhiata al manuale, ho cercato qualcosa di interessante in rete e ho trovato un utile tutorial che ho gia segnalato qui .
Quindi da questo tutorial traggo lo spunto per scrivere questi appunti sull’impiego pratico di QuickForm.

Creare una form e aggiungere gli elementi

Il procedimento per creare una form è quello di istanziare un oggetto QuickForm e aggiungerevi degli elementi.

// include la classe PEAR necessaria
require_once 'HTML/QuickForm.php';

// e definisco un oggetto HTML_QuickForm 
$or_form = new HTML_QuickForm('formRegistrazione');

// aggiungo gli elementi 

$or_form->addElement('text', 'txtNome', 'Nome:', array('size' => 40, 
'maxlength' => 50));
$or_form->addElement('textarea', 'txtIndirizzo', 'Indirizzo:', 
  array('rows' => 3, 'cols' => 30));
$or_form->addElement('select', 'txtNazione', 'Nazione:', 
  array ("" => "Seleziona una nazione", "it" => "Italia",
         "uk" => "United Kingdom", "de" => "Germania"));
$or_form->addElement('text', 'txtEmail', 'Indirizzo e-mail:', 
  array( 'size' => 40, 'maxlength' => 255));

Quali sono i parametri da fornire per ogni elemento

addElement richiede come primo parametro il tipo di elemento che si vuole inserire
-) documentazione di addElement
-) tipi di elemento

gli altri parametri sono indicati nella documentazione dei singoli metodi.
Ad esempio se si vuole inserire un elemento tipo ‘button’, nella pagina dei tipi di elemento si fa click sul relativo link ‘HTML_QuickForm_button’ e si approda alla pagina di documentazione dell’elemento.

Facendo click sulla documentazione relativa al costruttore dell’elemento, si ottiene la lista di parametri da passare al metodo addElement (ma anche a createElement).