commit 26399298164f1fb6eaa4764b543b876766dacf0a
author Derek Jones <derek.jones@ellislab.com> Wed Apr 08 16:14:17 2009 +0000
committer Derek Jones <derek.jones@ellislab.com> Wed Apr 08 16:14:17 2009 +0000
tree baa727ad02f67946125dd0392463b23c704f376e
parent 57fe41072c9d97d3cba2cd5faef529ac94571bfb

added form_multiselect() to form helper to make it easier to create multiselect fields, and to make it a bit more semantically correct to boot

user_guide/helpers/form_helper.html

diff --git a/user_guide/helpers/form_helper.html b/user_guide/helpers/form_helper.html
index 1958721..6f17a6b 100644
--- a/user_guide/helpers/form_helper.html
+++ b/user_guide/helpers/form_helper.html
@@ -241,6 +241,14 @@
 
 <p>If the array passed as $options is a multidimensional array, form_dropdown() will produce an &lt;optgroup&gt; with the array key as the label.</p>
 
+<h2>form_multiselect()</h2>
+
+<p>Lets you create a standard multiselect field.  The first parameter will contain the name of the field,
+the second parameter will contain an associative array of options, and the third parameter will contain the
+value or values you wish to be selected.  The parameter usage is identical to using <kbd>form_dropdown()</kbd> above,
+except of course that the name of the field will need to use POST array syntax, e.g. <samp>foo[]</samp>.</p>
+
+
 <h2>form_fieldset()</h2>
 
 <p>Lets you generate fieldset/legend fields.</p>