CodeIgniter框架——表单辅助函数总结

时间 2019-11-16

原文原文链接

首先第一步就是载入辅助函数：php

$this->load->helper('form');

函数解析：html

一、form_open()数组

建立一个开始form标签，相对于你的配置文档中的基础URL。容许你添加一些form属性和一些隐藏表单，而且他会基于你的 config.php 文件里设置的编码，自动生成 accept-charset这个属性。函数

范例：post

echo form_open('email/send');

上面的例子会建立一个form提交至你的基础URL加上"email/send" URI片断，像这样：this

<form method="post" accept-charset="utf-8" action="http://example.com/index.php/email/send" />

添加一些属性——能够在第二个参数里传递一个关联数组来达到这一目的，像这样：编码

$attributes = array('class' => 'email', 'id' => 'myform');
echo form_open('email/send', $attributes);

上面的例子会建立一个这样的form标签：spa

<form method="post" accept-charset="utf-8" action="http://example.com/index.php/email/send"  class="email"  id="myform" />

增长隐藏域——隐藏域可使用数组加在第三个参数上，就像这样:code

$hidden = array('username' => 'Joe', 'member_id' => '234');
echo form_open('email/send', '', $hidden);

上面的例子会建立一个这样的form标签和这些隐藏域:orm

<form method="post" accept-charset="utf-8" action="http://example.com/index.php/email/send">
<input type="hidden" name="username" value="Joe" />
<input type="hidden" name="member_id" value="234" />

二、form_open_multipart()

这个函数和上面的form_open()函数彻底同样，不一样之处在于它多了一个multipart属性。若是你要制做一个上传文件的表单，这个属性是必须的。

三、form_input()

以使你建立一个标准输入栏。你能够在第一和第二个参数里输入name和value来建立一个：

echo form_input('username', 'johndoe');

或者你也能够用关联数组来添加你想加入的内容：

$data = array(
              'name'        => 'username',
              'id'          => 'username',
              'value'       => 'johndoe',
              'maxlength'   => '100',
              'size'        => '50',
              'style'       => 'width:50%',
            );
echo form_input($data);
// 将产生:
<input type="text" name="username" id="username" value="johndoe" maxlength="100" size="50" style="width:50%" />

若是你想加入一些额外的内容，例如Javascript，你能够在第三个参数里输入字符串来建立它：

$js = 'onClick="some_function()"';
echo form_input('username', 'johndoe', $js);

四、form_password()

此函数除了是设置type为“password”外和上面的 form_input() 函数彻底同样。

五、form_upload()

此函数与上面的 form_input() 函数几乎彻底相同，惟一的区别是此函数所设置的 type 为 "file"，用来上传文件。

六、form_textarea()

此函数与上面的 form_input() 函数几乎彻底相同，惟一的区别是此函数所生成的是一个"textarea"。说明：上面的范例中所指定的 "maxlength" 和 "size" 属性在这里变成了 "rows" 和 "cols" 。

七、form_dropdown()

建立一个标准的下拉列表字段。第一个参数是字段名，第二个参数是一个包含各个选项的关联数组，第三个参数是你想要设置为默认被选中的值。第三个参数也能够是一个包含多个项目的数组，CI 将为你建立多选下拉列表。例如：

$options = array(
                  'small'  => 'Small Shirt',
                  'med'    => 'Medium Shirt',
                  'large'   => 'Large Shirt',
                  'xlarge' => 'Extra Large Shirt',
                );
$shirts_on_sale = array('small', 'large');
echo form_dropdown('shirts', $options, 'large');

// 将会生成:

<select name="shirts">
<option value="small">Small Shirt</option>
<option value="med">Medium Shirt</option>
<option value="large" selected="selected">Large Shirt</option>
<option value="xlarge">Extra Large Shirt</option>
</select>
echo form_dropdown('shirts', $options, $shirts_on_sale);

// 将会生成:

<select name="shirts" multiple="multiple">
<option value="small" selected="selected">Small Shirt</option>
<option value="med">Medium Shirt</option>
<option value="large" selected="selected">Large Shirt</option>
<option value="xlarge">Extra Large Shirt</option>
</select>

若是你但愿 <select> 开始标签包含一些额外的属性，例如 id 属性以及JavaScript，你能够将一个字符串做为第四个参数传递过去:

$js = 'id="shirts" onChange="some_function();"';
echo form_dropdown('shirts', $options, 'large', $js);

若是$options参数是一个多维数组，form_dropdown() 函数将使用数组的键做为 label值生成一个 <optgroup> 标签。

八、form_multiselect()

该函数能够生成标准的复选列表。第一个参数给出表单项的名称；第二个参数用一个关联数组给出该表单项的所有可选项列表；第三个参数规定哪几项是默认已选取的。这些参数的用法跟上面的form_dropdown()彻底同样。固然，因为是复选的，在处理传值的时候，咱们要使用数组的语法。数组语法的例子：foo[]。

九、form_fieldset()

帮助你生成fieldset/legend标签。

echo form_fieldset('Address Information');
echo "<p>fieldset content here</p>\n";
echo form_fieldset_close(); 

// 生成
<fieldset> 
<legend>Address Information</legend> 
<p>form content here</p> 
</fieldset>

与其它函数相似，在第二个参数你能够传递一个关联数组来添加你本身想要的自定义的属性。

$attributes = array('id' => 'address_info', 'class' => 'address_info');
echo form_fieldset('Address Information', $attributes);
echo "<p>fieldset content here</p>\n";
echo form_fieldset_close(); 

// 生成
<fieldset id="address_info" class="address_info"> 
<legend>Address Information</legend> 
<p>form content here</p> 
</fieldset>

十、form_fieldset_close()

生成一个结束的fieldset标签。惟一的优点是，使用该函数，你能够传递数据，这些数据会附加在这个标签的后面。例如：

$string = "</div></div>";
echo fieldset_close($string);

// 会生成：
</fieldset>
</div></div>

十一、form_checkbox()

做用是生成一个复选框。简单范例以下:

echo form_checkbox('newsletter', 'accept', TRUE);
// 将会生成:
<input type="checkbox" name="newsletter" value="accept" checked="checked" />

第三个参数为 TRUE/FALSE 布尔值，决定复选框是否被默认选中。

与其它表单辅助函数类似的是，你能够把包含了属性值的数组做为参数传递给本函数:

$data = array(
    'name'        => 'newsletter',
    'id'          => 'newsletter',
    'value'       => 'accept',
    'checked'     => TRUE,
    'style'       => 'margin:10px',
    );
echo form_checkbox($data);
// 将会生成:
<input type="checkbox" name="newsletter" id="newsletter" value="accept" checked="checked" style="margin:10px" />

与其它函数类似的，若是你但愿此标签包含额外的数据，例如JavaScript，你能够将一个字符串做为第四个参数传递过去:

$js = 'onClick="some_function()"';
echo form_checkbox('newsletter', 'accept', TRUE, $js)

十二、form_radio()

此函数与上面的 form_checkbox() 函数几乎彻底相同，惟一的区别是此函数生成的是 "radio" 单选框。

1三、form_submit()

帮助你生成一个标准的submit按钮。示例以下：

echo form_submit('mysubmit', 'Submit Post!');
// 会生成：
<input type="submit" name="mysubmit" value="Submit Post!" />

与其它函数相似，第一个参数你能够传递一个关联数组来设置你所须要的属性。第三个参数容许你添加一些额外的内容到生成的HTML代码里。

1四、form_label()

帮助你生成一个label.示例以下：

echo form_label('你的名字是？','username');
// 会生成: 
<label for="username">你的名字是？</label>

与其它函数相似，你能够在第三个参数传入一个关联数组来增长一些额外的属性值。

$attributes = array(
'class' => 'mycustomclass',
'style' => 'color: #000;',
);
echo form_label('你的名字是？', 'username', $attributes);
// 会生成: 
<label for="username" class="mycustomclass" style="color: #000;">你的名字是？</label>

1五、form_reset()

做用是生成一个标准的 reset 按钮。此函数用法与 form_submit() 彻底相同。

1六、form_button()

做用是生成一个标准的按钮。你至少要给出两个参数，它们分别是按钮的名称和内容:

echo form_button('name','content');
// 将会生成
<button name="name" type="button">Content</button>

或者你也能够将一个包含有任何你想要的数据的关联数组做为参数传递过去:

$data = array(
    'name' => 'button',
    'id' => 'button',
    'value' => 'true',
    'type' => 'reset',
    'content' => 'Reset'
);
echo form_button($data);
// 将会生成:
<button name="button" id="button" value="true" type="reset">Reset</button>

若是你但愿表单包含一些额外的数据，例如JavaScript，你能够将一个字符串做为第三个参数传递过去:

$js = 'onClick="some_function()"';
echo form_button('mybutton', 'Click Me', $js);

1七、form_close()

做用是生成一个关闭 </form> 标签。使用此函数的惟一好处是，你能够将这个标签以后要添加的数据也传递过去。例如：

$string = "</div></div>";
echo form_close($string);
// 将会生成:
</form>
</div></div>

1八、form_prep()

容许你放心地在表单元素中使用HTML字符(例如引号)，没必要担忧破坏表单。考虑一下下面这个范例:

$string = 'Here is a string containing "quoted" text.';
<input type="text" name="myform" value="<var<$string</var<" />

由于上面的字符串中包含了引号，于是致使表单被破坏。form_prep()函数会转换HTML，所以能够放心使用:

<input type="text" name="myform" value="<var<<?php echo form_prep($string); ?></var<" />

说明: 若是你使用的是表单辅助函数中的任何一个，数据都会自动的进行预处理，因此没有必要调用本函数。只有当你手动建立表单元素时，你才须要本函数。

1九、set_value()

容许你设置 input 或者 textarea 字段的值。你必须在第一个参数中指定字段名称。第二个参数是可选的，容许你给字段设置一个默认值。例如:

<input type="text" name="quantity" value="<dfn><?php echo set_value('quantity', '0'); ?></dfn>" size="50" />

当上面的表单元素第一次加载时将会显示"0"。

20、set_select()

若是你使用 <select> 下拉菜单，此函数容许你显示选中的菜单项。第一个参数必须包含下拉菜单的名称，第二个参数必须包含每一个菜单项的值。，第三个参数是可选的，做用是设置菜单项为默认选中状态(使用TRUE/FALSE布尔值)。

范例:

<select name="myselect">
<option value="one" <?php echo set_select('myselect', 'one', TRUE); ?> >One</option>
<option value="two" <?php echo set_select('myselect', 'two'); ?> >Two</option>
<option value="three" <?php echo set_select('myselect', 'three'); ?> >Three</option>
</select>

2一、set_checkbox()

容许你显示一个处于提交状态的复选框。第一个参数必须包含此复选框的名称，第二个参数必须包含它的值，第三个参数是可选的，做用是设置复选框为默认选中状态(使用TRUE/FALSE布尔值)。

例如:

<input type="checkbox" name="mycheck" value="1" <?php echo set_checkbox('mycheck', '1'); ?> />
<input type="checkbox" name="mycheck" value="2" <?php echo set_checkbox('mycheck', '2'); ?> />

2二、set_radio()

容许你显示那些处于提交状态的单选框。这个函数与前面的 set_checkbox() 是相同的。

<input type="radio" name="myradio" value="1" <?php echo set_radio('myradio', '1', TRUE); ?> />
<input type="radio" name="myradio" value="2" <?php echo set_radio('myradio', '2'); ?> />

范例：