The Form helper file contains functions that assist in working with form elements.
openForm
Open form tag.
form_helper::openForm('users/action'); // <form action="http://www.example.com/users/action" method="post">
openMultiForm
Open multitype form tag.
form_helper::openMultiForm('users/action'); // <form action="http://www.example.com/users/action" method="post" enctype="multipart/form-data">
closeForm
Close form tag.
form_helper::closeForm(); // </form>
text
Text input tag.
form_helper::text('first_name'); // <input type="text" name="first_name" value="" />
form_helper::text('first_name', 'John', array('style' => 'border:1px solid red')); // <input type="text" name="first_name" value="John" style="border:1px solid red" />
hidden
Hidden input tag.
form_helper::hidden('first_name'); // <input type="hidden" name="first_name" value="" />
form_helper::hidden('first_name', 'John'); // <input type="hidden" name="first_name" value="John" />
number
Number input tag.
form_helper::hidden('age'); // <input type="number" name="age" value="" />
form_helper::hidden('age', 50); // <input type="number" name="age" value="50" />
password
Password input tag.
form_helper::password('pass'); // <input type="password" name="pass" value="" />
form_helper::password('pass', 'sample', array('style' => 'border:1px solid red')); // <input type="password" name="pass" value="sample" style="border:1px solid red" />
upload
Upload input tag.
form_helper::upload('my_file'); // <input type="file" name="my_file" value="" />
form_helper::upload('my_file', '', array('id' => 'my_file')); // <input type="file" name="my_file" id="my_file" />
submit
Submit input tag.
form_helper::submit('continue'); // <input type="submit" name="continue" value="" />
form_helper::submit('continue', 'Next', array('style' => 'border:1px solid red')); // <input type="submit" name="continue" value="Next" style="border:1px solid red" />
checkbox
Checkbox tag.
form_helper::checkbox('color[]', 'Blue', true); // <input type="checkbox" checked="checked" name="color[]" value="Blue" />
form_helper::checkbox('color[]', 'Red'); // <input type="checkbox" name="color[]" value="Red" />
form_helper::checkbox('color[]', 'Black', false, array('id' => 'my_color')); // <input type="checkbox" name="color[]" value="Red" id="my_color" />
radio
Radio tag.
form_helper::radio('color', 'Blue', true); // <input type="radio" checked="checked" name="color" value="Blue" />
form_helper::radio('color', 'Red'); // <input type="radio" name="color" value="Red" />
form_helper::radio('color', 'Black', false, array('id' => 'my_color')); // <input type="radio" name="color" value="Red" id="my_color" />
select
Select tag.
form_helper::select('color', array('red' => 'Red', 'blue' => 'Blue', 'black' => 'Black'), 'black', array('id' => 'my_color'));
// <select id="my_color" name="color"><option value="red">Red</option><option value="blue">Blue</option><option value="black" selected="selected">Black</option></select>
textarea
Text area tag.
form_helper::textarea('about'); // <input type="text" name="about" value="" />
form_helper::textarea('about', 'About me', array('style' => 'border:1px solid red')); // <input type="text" name="about" value="About me" style="border:1px solid red" />
label
Label tag.
form_helper::label('color', 'Color'); // <label for="color">Color</label>
captcha
Display captcha element.
form_helper::captcha('my_captcha'); // display default system captcha
getTotalErrors
Get total number of errors if form validation was being performed.
form_helper::getTotalErrors();
error
Get field error message if any.
form_helper::error('first_name');
errors
Get form errors if any.
form_helper::errors();
setValue
Permits you to set the value of an input form or text area after it was submitted.
form_helper::text('first_name', form_helper::setValue('first_name', 'John')); // John is the default value
setSelect
Permits you to set the value of a select tag.
form_helper::select('color', array('red' => 'Red', 'black' => 'Black'), form_helper::setSelect('color', 'black'), array('id' => 'my_color')); // Black is the default value
setRadio
Permits you to set the value of a radio tags.
form_helper::radio('color', 'Red', form_helper::setRadio('color', 'red', 'black')); // tag value is 'red' but default value is 'black'
setCheckbox
Permits you to set the value of a checkbox tag.
form_helper::checkbox('color[red]', 'Red', form_helper::setCheckbox('color', 'red', array('black', 'blue'))); // 'red' is the tag value, 'black' and 'blue' are default checked values