commit 707d0e0f1e0ea922fbe38d8b43f1fb4e2ea001e5
author Derek Allard <derek.allard@ellislab.com> Tue Mar 18 11:50:00 2008 +0000
committer Derek Allard <derek.allard@ellislab.com> Tue Mar 18 11:50:00 2008 +0000
tree 7c82f6932d6bc2c4e079d7bedb67e9299607eaf4
parent d888c3551189526e1b63cf09206dd40aad5bff5b

added form_button to form helper

user_guide/helpers/form_helper.html

diff --git a/user_guide/helpers/form_helper.html b/user_guide/helpers/form_helper.html
index 95041e5..fa33e6a 100644
--- a/user_guide/helpers/form_helper.html
+++ b/user_guide/helpers/form_helper.html
@@ -288,12 +288,12 @@
 <p>Similar to the other form functions in this helper, you can also pass an array of attributes to the function:</p>

 

 <code>$data = array(<br />

-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'name'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> 'newsletter',<br />

-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'id'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> 'newsletter',<br />

-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'value'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> 'accept',<br />

-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'checked'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> TRUE,<br />

-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'style'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; => 'margin:10px',<br />

-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;);<br />

+&nbsp;&nbsp;&nbsp;&nbsp;'name'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> 'newsletter',<br />

+&nbsp;&nbsp;&nbsp;&nbsp;'id'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> 'newsletter',<br />

+&nbsp;&nbsp;&nbsp;&nbsp;'value'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> 'accept',<br />

+&nbsp;&nbsp;&nbsp;&nbsp;'checked'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;=> TRUE,<br />

+&nbsp;&nbsp;&nbsp;&nbsp;'style'&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; => 'margin:10px',<br />

+&nbsp;&nbsp;&nbsp;&nbsp;);<br />

 <br />

 echo form_checkbox($data);<br />

 <br />

@@ -331,8 +331,8 @@
 &lt;label id=&quot;username&quot;&gt;What is your Name&lt;/label&gt;</code>

 <p>Similar to other functions, you can submit an associative array in the third parameter if you prefer to set additional attributes.    </p>

 <p><code>$attributes = array(<br />

-    	 'class' =&gt; 'mycustomclass',<br />

-    	 'style' =&gt; 'color: #000;',<br />

+&nbsp;&nbsp;&nbsp;&nbsp;'class' =&gt; 'mycustomclass',<br />

+&nbsp;&nbsp;&nbsp;&nbsp;'style' =&gt; 'color: #000;',<br />

 );<br />

     echo form_label('What is your Name', 'username', $attributes);<br />

         <br />

@@ -342,6 +342,39 @@
 

 <p>Lets you generate a standard reset button. Use is identical to <dfn>form_submit()</dfn>.</p>

 

+<h2>form_button()</h2>

+

+<p>Lets you generate a standard button element. You can minimally pass the button name and content in the first and second parameter:</p>

+<code>

+echo form_button(’name’,’content’);<br />

+<br />

+// Would produce<br />

+&lt;button name="name" type="submit"&gt;Content&lt;/button&gt;

+</code>

+

+Or you can pass an associative array containing any data you wish your form to contain:

+<code>

+$data = array(<br />

+&nbsp;&nbsp;&nbsp;&nbsp;‘name’ => ‘button’,<br />

+&nbsp;&nbsp;&nbsp;&nbsp;‘id’ => ‘button’,<br />

+&nbsp;&nbsp;&nbsp;&nbsp;‘value’ => ‘true’,<br />

+&nbsp;&nbsp;&nbsp;&nbsp;‘type’ => ‘reset’,<br />

+&nbsp;&nbsp;&nbsp;&nbsp;‘content’ => ‘Reset’<br />

+);<br />

+<br />

+echo form_button($data);<br />

+<br />

+// Would produce:<br />

+&lt;button name="button" id="button" value="true" type="reset"&gt;Reset&lt;/button&gt;

+</code>

+

+If you would like your form to contain some additional data, like JavaScript, you can pass it as a string in the third parameter:

+<code>

+$js = ‘onClick="some_function()"’;<br /><br />

+echo form_button(’mybutton’, ‘Click Me’, $js);

+</code>

+

+

 <h2>form_close()</h2>

 

 <p>Produces a closing &lt;/form> tag.  The only advantage to using this function is it permits you to pass data to it