Class: MF_Widget_tie

MF_Widget
   |
   --MF_Widget_tie

[line 95]
Tied select widget. Ties the values of one select widget to the actions of another, allowing the option list to change dynamically based on previous choices made in the form.

1     <?php
2     
3      $tied = new MF_Widget_select ('tied');
4      $widget = new MF_Widget_tie ('name');
5      $widget->tie = 'tied';
6     
7      $tied->extra = 'onchange="changeOptions (this.form, \'name\', \'tied\'); reLoad ()"';
8     
9      // now optional -- called automatically by display()
10     echo $widget->includeJS ();
11    
12     $list = array (
13         'one' => array (
14             'a' => 'A',
15             'b' => 'B',
16         ),
17         'two' => array (
18             'c' => 'C',
19             'd' => 'D',
20         ),
21     )
22    
23     foreach ($list as $item => $list) {
24         $tied->setValues ($item, ucfirst ($item));
25         $widget->ties[$item] = $list;
26     }
27    
28     $widget->validation ('is "foo"');
29     $widget->setValue ('foo');
30     $widget->error_message = 'Oops!  This widget is being unruly!';
31    
32     ?>

Alternately, via INI settings:

1     [tied]
2     
3      type = select
4      setValues = "eval: assoscify (range ('a', 'g'))"
5      extra = "onchange=`changeOptions (this.form, 'name', 'tied'); reLoad ()`"
6     
7      [name]
8     
9      type = tie
10     setValues = "eval: array ('a' => assocify (array ('a','b','c')), etc.)"
11     tie = tied

Note that the eval options would presumably be replaced with a call to an external function in real-life scenarios.

Tags:

$extra =  ''

[line 103]

A way to pass extra parameters to the HTML form tag, for example 'enctype="multipart/formdata"'.

Tags:

$formname =  false

[line 130]

The name of the form. Note: If this is not the first form on the page, then a form name is required (must also set the $name property of the MailForm object).

Tags:

$jsFile =  false

[line 140]

The path to the tie.js JavaScript file, which contains the JavaScript components to this widget. This is determined automatically in the constructor.

Tags:

$tie =  false

[line 120]

The name of the field to be "tied" to.

Tags:

$ties = array ()

[line 151]

This is the list of values to display for each value of the widget this widget is tied to. Ordinary select widgets simply have a $values associative array, but the tie widget has this which is a $values array for each value of the other widget.

Tags:

$type =  'tie'

[line 112]

This is the short name for this widget. The short name is the class name minus the 'MF_Widget_' prefix.

Tags:

---

constructor MF_Widget_tie [line 160]

---

method display [line 212]

---

method includeJS [line 193]

---

method setValues [line 177]