Laurent-Laville.org

Basic 1

Overview

This example will display a dual multi-select QuickForm element, to manage a simple car list.
Only default options are used.

Screenshot

Demonstration

Dependencies

This example requires mandatory resources :

• PHP >= 4.3.10
• PEAR::HTML_QuickForm >= 3.2.10
• PEAR::HTML_Common >= 1.2.4
• PEAR >= 1.5.4

Explains step by step

Step 1

First, we loads the class definitions for QuickForm and advmultiselect element (lines 17,18), then we creates a HTML_QuickForm object that will contain the object representing elements and all the other necessary information. We only pass the form's name to the constructor, which means that default values will be used for other parameters (line 20).

The dual multi-select is created (line 55) with no headers except global element title 'Cars:' and load with data defined from $car_array (lines 40 thru 50).

Both list are 100 pixels width and display 10 items:

Step 2

The basic render is built with default element template and default class declarations: none means (table border=0 cellpadding=10 cellspacing=0).

Here is the default element template:

{javascript}
<table{class}>
<!-- BEGIN label_2 --><tr><th>{label_2}</th><!-- END label_2 -->
<!-- BEGIN label_3 --><th>&nbsp;</th><th>{label_3}</th></tr><!-- END label_3 -->
<tr>
  <td valign="top">{unselected}</td>
  <td align="center">{add}{remove}</td>
  <td valign="top">{selected}</td>
</tr>
</table>

The swap buttons used defaults that may be retrieve if you don't specify attributes on setButtonAttributes() method.

Step 3

Immediately before the form is displayed (line 84) we attempt to validate it (line 77). Results of car selection are displayed on lines lines 78 to 82.

Source Code