?
This document uses PHP Chinese website manual Release
表單幫助文件包含有助于使用表單的功能。
加載此助手
轉(zhuǎn)義場(chǎng)值
可用職能
使用以下代碼加載此助手:
$this->load->helper('form');
您可能需要在表單元素中使用HTML和字符(如引號(hào))。為了安全地完成這個(gè)任務(wù),您需要使用公共函數(shù)html_escape()
...
考慮以下示例:
$string = 'Here is a string containing "quoted" text.';<input type="text" name="myfield" value="<?php echo $string; ?>" />
由于上面的字符串包含一組引號(hào),它將導(dǎo)致表單中斷。大html_escape()
函數(shù)轉(zhuǎn)換HTML特殊字符,以便安全地使用:
<input type="text" name="myfield" value="<?php echo html_escape($string); ?>" />
注
如果使用此頁(yè)面中列出的任何表單幫助函數(shù),則表單值將自動(dòng)轉(zhuǎn)義,因此不需要調(diào)用此函數(shù)。只有在創(chuàng)建自己的表單元素時(shí)才使用它。
現(xiàn)有下列職能:
form_open([$action = ''[, $attributes = ''[, $hidden = array()]]])
參數(shù): | $ action(string) - 表單動(dòng)作/目標(biāo)URI字符串$ attributes(array) - HTML屬性$ hidden(array) - 一個(gè)隱藏字段定義數(shù)組 |
---|---|
返回: | 一個(gè)HTML表單打開(kāi)標(biāo)記 |
返回類型: | 串 |
$ action(string) - 表單動(dòng)作/目標(biāo)URI字符串
$ attributes(array) - HTML屬性
$ hidden(array) - 一個(gè)隱藏字段的定義數(shù)組
返回:HTML表單開(kāi)始標(biāo)記
返回類型:字符串
使用從您的配置首選項(xiàng)**構(gòu)建的基本URL **創(chuàng)建開(kāi)放表單標(biāo)記。它可以選擇讓你添加表單屬性和隱藏的輸入字段,并且總是添加基于配置文件中charset值的`accept-charset`屬性。
使用這個(gè)標(biāo)記而不是硬編碼自己的HTML的主要好處是,它允許您的站點(diǎn)在URL更改時(shí)更易于移植。
下面是一個(gè)簡(jiǎn)單的例子:
echo form_open('email / send');
上面的示例將創(chuàng)建一個(gè)指向基本URL和“Email/Send”URI段的表單,如下所示:
<form method="post" accept-charset="utf-8" action="http://example.com/index.php/email/send">
添加屬性
可以通過(guò)向第二個(gè)參數(shù)傳遞關(guān)聯(lián)數(shù)組來(lái)添加屬性,如下所示:
$ attributes = array('class'=>'email','id'=>'myform'); echo form_open('email / send',$ attributes);
或者,可以將第二個(gè)參數(shù)指定為字符串:
echo form_open('email / send','class =“email”id =“myform”');
上述示例將創(chuàng)建一個(gè)類似于此的形式:
<form method="post" accept-charset="utf-8" action="http://example.com/index.php/email/send" class="email" id="myform">
添加隱藏輸入字段
可以通過(guò)向第三個(gè)參數(shù)傳遞關(guān)聯(lián)數(shù)組來(lái)添加隱藏字段,如下所示:
$ hidden = array('username'=>'Joe','member_id'=>'234'); echo form_open('email / send','',$ hidden);
您可以通過(guò)向第二個(gè)參數(shù)傳遞任何Falsy值來(lái)跳過(guò)第二個(gè)參數(shù)。
上面的示例將創(chuàng)建一個(gè)類似于此的表單:
<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([$action = ''[, $attributes = array()[, $hidden = array()]]])
參數(shù): | $ action(string) - 表單動(dòng)作/目標(biāo)URI字符串$ attributes(array) - HTML屬性$ hidden(array) - 一個(gè)隱藏字段定義數(shù)組 |
---|---|
返回: | HTML多部分表單打開(kāi)標(biāo)記 |
返回類型: | 串 |
$ action(string) - 表單動(dòng)作/目標(biāo)URI字符串
$ attributes(array) - HTML屬性
$ hidden(array) - 一個(gè)隱藏字段的定義數(shù)組
返回:HTML多部分表單打開(kāi)標(biāo)記
返回類型:字符串
這個(gè)函數(shù)與上面的``form_open()`](about:blank#form_open)完全相同,除了它增加了一個(gè)_multipart_屬性,如果你想使用表單來(lái)上傳文件,這是必須的。
form_hidden($name[, $value = ''])
參數(shù): | $ name(字符串) - 字段名稱$ value(字符串) - 字段值 |
---|---|
返回: | HTML隱藏輸入字段標(biāo)記 |
返回類型: | 串 |
$ name(字符串) - 字段名稱
$ value(字符串) - 字段值
返回:HTML隱藏的輸入字段標(biāo)記
返回類型:字符串
讓您生成隱藏的輸入字段。您可以提交一個(gè)名稱/值字符串來(lái)創(chuàng)建一個(gè)字段:
form_hidden('username','johndoe'); //會(huì)產(chǎn)生:<input type =“hidden”name =“username”value =“johndoe”/>
...或者可以提交一個(gè)關(guān)聯(lián)數(shù)組來(lái)創(chuàng)建多個(gè)字段:
$ data = array('name'=>'John Doe','email'=>'email protected','url'=>' http://example.com '); echo form_hidden($ data); / *會(huì)產(chǎn)生:<input type =“hidden”name =“name”value =“John Doe”/> <input type =“hidden”name =“email”value =“[email protected]”/> <input type =“hidden”name =“url”value =“http://example.com”/> * /
還可以將關(guān)聯(lián)數(shù)組傳遞給Value字段:
$ data = array('name'=>'John Doe','email'=>'email protected','url'=>' http://example.com '); echo form_hidden('my_array',$ data); / *會(huì)生成:<input type =“hidden”name =“my \ _array [name]”value =“John Doe”/> <input type =“hidden”name =“my \ _array [email]”value =“ [email protected]“/> <input type =”hidden“name =”my \ _array [url]“value =”http://example.com“/> * /
如果要?jiǎng)?chuàng)建具有額外屬性的隱藏輸入字段:
$ data = array('type'=>'hidden','name'=>'email','id'=>'hiddenemail','value'=>'email protected','class'=>'hiddenemail' ); echo form_input($ data); / *會(huì)產(chǎn)生:<input type =“hidden”name =“email”value =“[email protected]”id =“hiddenemail”class =“hiddenemail”/> * /
form_input([$data = ''[, $value = ''[, $extra = '']]])
參數(shù): | $ data(array) - 字段屬性數(shù)據(jù)$ value(字符串) - 字段值$ extra(混合) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性 |
---|---|
返回: | HTML文本輸入字段標(biāo)記 |
返回類型: | 串 |
$ data(array) - 字段屬性數(shù)據(jù)
$ value(字符串) - 字段值
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
返回:HTML文本輸入字段標(biāo)記
返回類型:字符串
讓您生成標(biāo)準(zhǔn)文本輸入字段。您可以最小化地傳遞第一個(gè)和第二個(gè)參數(shù)中的字段名稱和值:
echo form_input('username','johndoe');
也可以傳遞一個(gè)關(guān)聯(lián)數(shù)組,該數(shù)組包含您希望窗體包含的任何數(shù)據(jù):
$data = array( 'name' => 'username', 'id' => 'username', 'value' => 'johndoe', 'maxlength' => '100', 'size' => '50', 'style' => 'width:50%' ); echo form_input($data); /* Would produce: <input type="text" name="username" value="johndoe" id="username" maxlength="100" size="50" style="width:50%" /> */
如果希望表單包含一些附加數(shù)據(jù),如JavaScript,則可以將其作為字符串傳遞到第三個(gè)參數(shù)中:
$ js ='onClick =“some_function()”'; echo form_input('username','johndoe',$ js);
也可以將其作為數(shù)組傳遞:
$ js = array('onClick'=>'some_function();'); echo form_input('username','johndoe',$ js);
form_password([$data = ''[, $value = ''[, $extra = '']]])
參數(shù): | $ data(array) - 字段屬性數(shù)據(jù)$ value(字符串) - 字段值$ extra(混合) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性 |
---|---|
返回: | 一個(gè)HTML密碼輸入字段標(biāo)簽 |
返回類型: | 串 |
$ data(array) - 字段屬性數(shù)據(jù)
$ value(字符串) - 字段值
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
返回:HTML密碼輸入字段標(biāo)記
返回類型:字符串
除了使用“password”輸入類型外,這個(gè)函數(shù)在所有方面都與[`form_input()`](about:blank#form_input)函數(shù)完全相同。
form_upload([$data = ''[, $value = ''[, $extra = '']]])
參數(shù): | $ data(array) - 字段屬性數(shù)據(jù)$ value(字符串) - 字段值$ extra(混合) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性 |
---|---|
返回: | 一個(gè)HTML文件上傳輸入字段標(biāo)記 |
返回類型: | 串 |
$ data(array) - 字段屬性數(shù)據(jù)
$ value(字符串) - 字段值
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
返回:HTML文件上傳輸入字段標(biāo)記
返回類型:字符串
這個(gè)函數(shù)在所有方面都與上面的[`form_input()`](about:blank#form_input)函數(shù)相同,除了它使用“file”輸入類型,允許它用于上傳文件。
form_textarea([$data = ''[, $value = ''[, $extra = '']]])
參數(shù): | $ data(array) - 字段屬性數(shù)據(jù)$ value(字符串) - 字段值$ extra(混合) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性 |
---|---|
返回: | 一個(gè)HTML textarea標(biāo)簽 |
返回類型: | 串 |
$ data(array) - 字段屬性數(shù)據(jù)
$ value(字符串) - 字段值
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
Returns: An HTML textarea tag
Return type: string
This function is identical in all respects to the [`form_input()`](about:blank#form_input) function above except that it generates a “textarea” type.
注
取而代之的是的最大長(zhǎng)度和尺寸在上面的例子中的屬性,你反而會(huì)指定行和COLS。
form_dropdown([$name = ''[, $options = array()[, $selected = array()[, $extra = '']]]])
參數(shù): | $ name(字符串) - 字段名稱$ options(array) - 要列出的選項(xiàng)的關(guān)聯(lián)數(shù)組$ extra(array) - 用選定屬性標(biāo)記的字段列表$ extra(mixed) - 要添加到標(biāo)記為數(shù)組或字符串 |
---|---|
返回: | HTML下拉選擇字段標(biāo)記 |
返回類型: | 串 |
$ name(字符串) - 字段名稱
$ options(array) - 要列出的選項(xiàng)的關(guān)聯(lián)數(shù)組
$ selected(array) - 用選定屬性標(biāo)記的字段列表
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
Returns: An HTML dropdown select field tag
Return type: string
讓您創(chuàng)建一個(gè)標(biāo)準(zhǔn)的下拉字段。第一個(gè)參數(shù)將包含字段的名稱,第二個(gè)參數(shù)將包含選項(xiàng)的關(guān)聯(lián)數(shù)組,第三個(gè)參數(shù)將包含您希望選擇的值。您還可以通過(guò)第三個(gè)參數(shù)傳遞多個(gè)項(xiàng)目的數(shù)組,CodeIgniter將為您創(chuàng)建一個(gè)多選項(xiàng)。
例子:
''''''''小號(hào)襯衫','med'=>'中型襯衫','大號(hào)'=>'大號(hào)襯衫','xlarge'=>'超大號(hào)襯衫',); $ shirts_on_sale = array('small','large'); echo form_dropdown('shirts',$ options,'large'); / *會(huì)產(chǎn)生:<select name =“shirts”> <option value =“small”> Small Shirt </ option> <option value =“med”> Medium Shirt </ option> <option value =“l(fā)arge”selected = “selected”> Large Shirt </ option> <option value =“xlarge”>超大襯衫</ option> </ select> * / echo form_dropdown('shirts',$ options,$ shirts_on_sale); / *會(huì)產(chǎn)生:<select name =“shirts”multiple =“multiple”> <option value =“small”selected =“selected”>小襯衫</ option> <option value =“med”> Medium Shirt </ option > <選項(xiàng)值=“大”選中=“選定”>大襯衫</ option> <選項(xiàng)值=“xlarge”>超大襯衫</ option> </ select> * /
如果您希望打開(kāi)的<select>包含其他數(shù)據(jù)(如id屬性或JavaScript),則可以將它作為字符串傳遞給第四個(gè)參數(shù):
$ js ='id =“shirts”onChange =“some_function();”'; echo form_dropdown('shirts',$ options,'large',$ js);
也可以將其作為數(shù)組傳遞:
$ js = array('id'=>'shirts','onChange'=>'some_function();'); echo form_dropdown('shirts',$ options,'large',$ js);
如果數(shù)組作為$options
是多維數(shù)組,那么form_dropdown()
會(huì)產(chǎn)生一個(gè)<optgroup>以數(shù)組鍵作為標(biāo)簽。
form_multiselect([$name = ''[, $options = array()[, $selected = array()[, $extra = '']]]])
參數(shù): | $ name(字符串) - 字段名稱$ options(array) - 要列出的選項(xiàng)的關(guān)聯(lián)數(shù)組$ extra(array) - 用選定屬性標(biāo)記的字段列表$ extra(mixed) - 要添加到標(biāo)記為數(shù)組或字符串 |
---|---|
返回: | HTML下拉式多選字段標(biāo)簽 |
返回類型: | 串 |
$ name(字符串) - 字段名稱
$ options(array) - 要列出的選項(xiàng)的關(guān)聯(lián)數(shù)組
$ selected(array) - 用選定屬性標(biāo)記的字段列表
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
Returns: An HTML dropdown multiselect field tag
Return type: string
讓您創(chuàng)建一個(gè)標(biāo)準(zhǔn)的多選字段。第一個(gè)參數(shù)將包含字段的名稱,第二個(gè)參數(shù)將包含選項(xiàng)的關(guān)聯(lián)數(shù)組,第三個(gè)參數(shù)將包含您希望選擇的一個(gè)或多個(gè)值。
參數(shù)用法與form_dropdown()
上面的使用方法相同,當(dāng)然除了字段的名稱需要使用POST數(shù)組語(yǔ)法,例如foo []。
form_fieldset([$legend_text = ''[, $attributes = array()]])
參數(shù): | $ legend_text(string) - 放入<legend>標(biāo)簽的文本$ attributes(array) - 要在<fieldset>標(biāo)簽上設(shè)置的屬性 |
---|---|
返回: | HTML字段集開(kāi)始標(biāo)記 |
返回類型: | 串 |
$ legend_text(string) - 放入<legend>標(biāo)簽的文本
$ attributes(array) - 要在<fieldset>標(biāo)簽上設(shè)置的屬性
Returns: An HTML fieldset opening tag
Return type: string
讓您生成fieldset / legend字段。
例子:
echo form_fieldset('地址信息'); 回聲“<p>此處的字段集內(nèi)容</ p> \ n”; echo form_fieldset_close(); / *生成:<fieldset> <legend>地址信息</ legend> <p>在此處填寫內(nèi)容</ p> </ fieldset> * /
與其他函數(shù)類似,如果您希望設(shè)置其他屬性,則可以在第二個(gè)參數(shù)中提交關(guān)聯(lián)數(shù)組:
$ attributes = array('id'=>'address_info','class'=>'address_info'); echo form_fieldset('Address Information',$ attributes); 回聲“<p>此處的字段集內(nèi)容</ p> \ n”; echo form_fieldset_close(); / *產(chǎn)生:<fieldset id =“地址\ _info”class =“地址\ _info”> <legend>地址信息</ legend> <p>在這里表示內(nèi)容</ p> </ fieldset> * /
form_fieldset_close([$extra = ''])
參數(shù): | $ extra(string) - 任何要在結(jié)束標(biāo)記之后追加的東西 |
---|---|
返回: | HTML字段集關(guān)閉標(biāo)記 |
返回類型: | 串 |
$額外(字符串) -任何給結(jié)束標(biāo)記之后追加,如 返回:HTML字段集結(jié)束標(biāo)記返回類型:字符串產(chǎn)生一個(gè)結(jié)束</字段集>標(biāo)記。使用此功能的唯一好處是它允許您將數(shù)據(jù)傳遞給它,并將其添加到標(biāo)簽下方。例如$ string ='</ div> </ div>'; echo form_fieldset_close($ string); //產(chǎn)生:</ fieldset> </ div> </ div> form_checkbox([$data = ''[, $value = ''[, $checked = FALSE[, $extra = '']]]])
參數(shù):$ data(array) - 字段屬性數(shù)據(jù)$ value(字符串) - 字段值$ checked(bool) - 是否將復(fù)選框標(biāo)記為選中$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的附加屬性stringReturns:HTML復(fù)選框輸入tagReturn類型:string
$ data(array) - 字段屬性數(shù)據(jù)
$ value(字符串) - 字段值
$ checked(bool) - 是否將復(fù)選框標(biāo)記為被選中
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
Returns: An HTML checkbox input tag
Return type: string
讓你生成一個(gè)復(fù)選框字段。簡(jiǎn)單的例子:
echo form_checkbox('newsletter','accept',TRUE); //會(huì)產(chǎn)生:<input type =“checkbox”name =“newsletter”value =“accept”checked =“checked”/>
第三個(gè)參數(shù)包含一個(gè)布爾值true/false,以確定是否應(yīng)該選中該框。
與此助手中的其他表單函數(shù)類似,您還可以將屬性數(shù)組傳遞給該函數(shù):
$ data = array('name'=>'newsletter','id'=>'newsletter','value'=>'accept','checked'=> TRUE,'style'=>'margin:10px') ; echo form_checkbox($ data); //會(huì)產(chǎn)生:<input type =“checkbox”name =“newsletter”id =“newsletter”value =“accept”checked =“checked”style =“margin:10px”/>
與其他函數(shù)一樣,如果希望標(biāo)記包含JavaScript之類的其他數(shù)據(jù),則可以在第四個(gè)參數(shù)中將其作為字符串傳遞:
$ js ='onClick =“some_function()”'; echo form_checkbox('newsletter','accept',TRUE,$ js);
也可以將其作為數(shù)組傳遞:
$ js = array('onClick'=>'some_function();'); echo form_checkbox('newsletter','accept',TRUE,$ js);
form_radio([$data = ''[, $value = ''[, $checked = FALSE[, $extra = '']]]])
參數(shù): | $ data(字符串) - 字段值$ checked(bool) - 是否將單選按鈕標(biāo)記為檢查$ extra(混合) - 要作為數(shù)組添加到標(biāo)記的額外屬性或一個(gè)文字字符串 |
---|---|
返回: | 一個(gè)HTML無(wú)線電輸入標(biāo)簽 |
返回類型: | 串 |
$ data(array) - 字段屬性數(shù)據(jù)
$ value(字符串) - 字段值
$ checked(bool) - 是否將單選按鈕標(biāo)記為正在檢查
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
Returns: An HTML radio input tag
Return type: string
除了使用“radio”輸入類型之外,這個(gè)函數(shù)在所有方面與[`form_checkbox()`](about:blank#form_checkbox)函數(shù)完全相同。
form_label([$label_text = ''[, $id = ''[, $attributes = array()]]])
參數(shù): | $ label_text(string) - 放入<label>標(biāo)簽的文本$ id(string) - 我們?yōu)? attributes(混合)制作標(biāo)簽的表單元素的ID - HTML屬性 |
---|---|
返回: | 一個(gè)HTML字段標(biāo)簽標(biāo)簽 |
返回類型: | 串 |
$ label_text(string) - 放在<label>標(biāo)簽中的文本
$ id(字符串) - 我們?yōu)槠渲谱鳂?biāo)簽的表單元素的ID
$ attributes(mixed) - HTML屬性
Returns: An HTML field label tag
Return type: string
讓你生成一個(gè)<label>。簡(jiǎn)單的例子:
echo form_label('你的名字是什么','用戶名'); //會(huì)產(chǎn)生:<label for =“username”>什么是您的名字</ label>
與其他函數(shù)類似,如果您喜歡設(shè)置其他屬性,則可以在第三個(gè)參數(shù)中提交關(guān)聯(lián)數(shù)組。
例子:
$ attributes = array('class'=>'mycustomclass','style'=>'color:#000;'); 回聲form_label('你是什么名字','用戶名',$屬性); //會(huì)產(chǎn)生:<label for =“username”class =“mycustomclass”style =“color:#000;”>什么是您的名字</ label>
form_submit([$data = ''[, $value = ''[, $extra = '']]])
參數(shù): | $ data(string) - 按鈕名稱$ value(字符串) - 按鈕值$ extra(混合) - 要作為數(shù)組或字符串添加到標(biāo)簽的額外屬性 |
---|---|
返回: | HTML輸入提交標(biāo)記 |
返回類型: | 串 |
$ data(字符串) - 按鈕名稱
$ value(字符串) - 按鈕值
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
Returns: An HTML input submit tag
Return type: string
讓你生成一個(gè)標(biāo)準(zhǔn)的提交按鈕。簡(jiǎn)單的例子:
echo form_submit('mysubmit','Submit Post!'); //會(huì)產(chǎn)生:<input type =“submit”name =“mysubmit”value =“提交帖子!” />
與其他函數(shù)類似,如果您喜歡設(shè)置自己的屬性,可以在第一個(gè)參數(shù)中提交關(guān)聯(lián)數(shù)組。第三個(gè)參數(shù)允許您向表單中添加額外的數(shù)據(jù),比如JavaScript。
form_reset([$data = ''[, $value = ''[, $extra = '']]])
參數(shù): | $ data(string) - 按鈕名稱$ value(字符串) - 按鈕值$ extra(混合) - 要作為數(shù)組或字符串添加到標(biāo)簽的額外屬性 |
---|---|
返回: | 一個(gè)HTML輸入重置按鈕標(biāo)簽 |
返回類型: | 串 |
$ data(字符串) - 按鈕名稱
$ value(字符串) - 按鈕值
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
返回:HTML輸入重置按鈕標(biāo)記
Return type: string
讓您生成一個(gè)標(biāo)準(zhǔn)的重置按鈕。使用與`form_submit()`相同。
form_button([$data = ''[, $content = ''[, $extra = '']]])
參數(shù): | $ data(字符串) - 按鈕名稱$ content(字符串) - 按鈕標(biāo)簽$ extra(混合) - 要作為數(shù)組或字符串添加到標(biāo)簽的額外屬性 |
---|---|
返回: | 一個(gè)HTML按鈕標(biāo)簽 |
返回類型: | 串 |
$ data(字符串) - 按鈕名稱
$ content(string) - 按鈕標(biāo)簽
$ extra(mixed) - 要作為數(shù)組或字符串添加到標(biāo)記的額外屬性
Returns: An HTML button tag
Return type: string
讓你生成一個(gè)標(biāo)準(zhǔn)的按鈕元素。您可以最低限度地傳遞第一個(gè)和第二個(gè)參數(shù)中的按鈕名稱和內(nèi)容:
echo form_button('name','content'); //將產(chǎn)生:<button name =“name”type =“button”> Content </ button>
也可以傳遞一個(gè)關(guān)聯(lián)數(shù)組,該數(shù)組包含您希望窗體包含的任何數(shù)據(jù):
$ data = array('name'=>'button','id'=>'button','value'=>'true','type'=>'reset','content'=>'Reset') ; echo form_button($ data); //產(chǎn)生:<button name =“button”id =“button”value =“true”type =“reset”> Reset </ button>
如果希望表單包含一些附加數(shù)據(jù),如JavaScript,則可以將其作為字符串傳遞到第三個(gè)參數(shù)中:
$ js ='onClick =“some_function()”'; echo form_button('mybutton','Click Me',$ js);
form_close([$extra = ''])
參數(shù): | $ extra(string) - 任何要在結(jié)束標(biāo)記之后追加的東西 |
---|---|
返回: | 一個(gè)HTML表單結(jié)束標(biāo)記 |
返回類型: | 串 |
$extra (string) – Anything to append after the closing tag, as is Returns: An HTML form closing tag Return type: string Produces a closing </form> tag. The only advantage to using this function is it permits you to pass data to it which will be added below the tag. For example: $string = '</div></div>'; echo form_close($string); // Would produce: </form> </div></div> set_value($field[, $default = ''[, $html_escape = TRUE]])
Parameters:$field (string) – Field name $default (string) – Default value $html_escape (bool) – Whether to turn off HTML escaping of the valueReturns:Field valueReturn type:string
$ field(string) - 字段名稱
$ default(string) - 默認(rèn)值
$ html_escape(bool) - 是否關(guān)閉HTML值的轉(zhuǎn)義
Returns: Field value
Return type: string
允許您設(shè)置輸入表單或textarea的值。您必須通過(guò)函數(shù)的第一個(gè)參數(shù)提供字段名稱。第二個(gè)(可選)參數(shù)允許您為表單設(shè)置默認(rèn)值。第三個(gè)(可選)參數(shù)允許您關(guān)閉HTML轉(zhuǎn)義值,以防需要將此函數(shù)與ie [`form_input()`](about:blank#form_input)結(jié)合使用并避免雙重轉(zhuǎn)義。
例子:
<input type =“text”name =“quantity”value =“<?php echo set \ _value('quantity','0');?>”size =“50”/>
當(dāng)首次加載時(shí),上述表單將顯示“0”。
注
如果您已經(jīng)加載了表單驗(yàn)證庫(kù)并設(shè)置了與此助手一起使用的字段名的驗(yàn)證規(guī)則,然后將調(diào)用轉(zhuǎn)發(fā)給表單驗(yàn)證庫(kù)自己的set_value()
方法。否則,此函數(shù)將在$_POST
字段值。
set_select($field[, $value = ''[, $default = FALSE]])
參數(shù): | $ field(string) - 字段名稱$ value(字符串) - 檢查$ default(string)的值 - 值是否也是默認(rèn)值 |
---|---|
返回: | 'selected'屬性或一個(gè)空字符串 |
返回類型: | 串 |
$ field(string) - 字段名稱
$ value(string) - 要檢查的值
$ default(string) - 該值是否也是默認(rèn)值
Returns: ‘selected’ attribute or an empty string
Return type: string
如果您使用<select>菜單,則此功能允許您顯示所選的菜單項(xiàng)。
第一個(gè)參數(shù)必須包含選擇菜單的名稱,第二個(gè)參數(shù)必須包含每個(gè)項(xiàng)目的值,第三個(gè)(可選)參數(shù)允許您將項(xiàng)目設(shè)置為默認(rèn)值(使用布爾值TRUE / FALSE)。
例子:
<select name =“myselect”> <option value =“one”<?php echo set \ _select('myselect','one',TRUE); ?>>一個(gè)</ option> <option value =“two”<?php echo set \ _select('myselect','two'); ?>>兩個(gè)</ option> <option value =“three”<?php echo set \ _select('myselect','three'); ?>>三</ option> </ select>
set_checkbox($field[, $value = ''[, $default = FALSE]])
參數(shù): | $ field(string) - 字段名稱$ value(字符串) - 檢查$ default(string)的值 - 值是否也是默認(rèn)值 |
---|---|
返回: | 'checked'屬性或一個(gè)空字符串 |
返回類型: | 串 |
$ field(string) - 字段名稱
$ value(string) - 要檢查的值
$ default(string) - 該值是否也是默認(rèn)值
Returns: ‘checked’ attribute or an empty string
Return type: string
允許您以提交狀態(tài)顯示復(fù)選框。
第一個(gè)參數(shù)必須包含復(fù)選框的名稱,第二個(gè)參數(shù)必須包含其值,第三個(gè)(可選)參數(shù)允許您將項(xiàng)目設(shè)置為默認(rèn)值(使用布爾值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'); ?> />
set_radio($field[, $value = ''[, $default = FALSE]])
參數(shù): | $ field(string) - 字段名稱$ value(字符串) - 檢查$ default(string)的值 - 值是否也是默認(rèn)值 |
---|---|
返回: | 'checked'屬性或一個(gè)空字符串 |
返回類型: | 串 |
$ field(string) - 字段名稱
$ value(string) - 要檢查的值
$ default(string) - 該值是否也是默認(rèn)值
Returns: ‘checked’ attribute or an empty string
Return type: string
允許您以提交狀態(tài)顯示單選按鈕。這個(gè)函數(shù)與上面的``set_checkbox()`](about:blank#set_checkbox)函數(shù)相同。
例子:
<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'); ?> />
注
如果您使用的是表單驗(yàn)證類,則必須始終為您的字段指定規(guī)則,即使為空,以便set_*()
功能開(kāi)始工作。這是因?yàn)槿绻x了表單驗(yàn)證對(duì)象,則set_*()
傳遞給類的方法,而不是泛型助手函數(shù)。
form_error([$field = ''[, $prefix = ''[, $suffix = '']]])
參數(shù): | $ field(string) - 字段名稱$ prefix(字符串) - 打開(kāi)標(biāo)記時(shí)出錯(cuò)$ suffix(string) - 標(biāo)記結(jié)束時(shí)出錯(cuò) |
---|---|
返回: | HTML格式的表單驗(yàn)證錯(cuò)誤消息(s) |
返回類型: | 串 |
$ field(string) - 字段名稱
$ prefix(string) - 打開(kāi)標(biāo)簽時(shí)出錯(cuò)
$ suffix(string) - 錯(cuò)誤結(jié)束標(biāo)記
返回:HTML格式的表單驗(yàn)證錯(cuò)誤消息(s)
Return type: string
從[Form Validation Library](../ libraries / form_validation)返回驗(yàn)證錯(cuò)誤消息,與指定的字段名稱關(guān)聯(lián)。您可以選擇指定打開(kāi)和關(guān)閉標(biāo)簽以放置錯(cuò)誤消息。
例子:
//假設(shè)'username'字段值不正確:echo form_error('myfield','<div class =“error”>','</ div>'); //將產(chǎn)生:<div class =“error”>與“用戶名”字段相關(guān)聯(lián)的錯(cuò)誤消息。</ div>
validation_errors([$prefix = ''[, $suffix = '']])
參數(shù): | $ prefix(string) - 打開(kāi)標(biāo)記$ suffix(string)時(shí)出錯(cuò) - 關(guān)閉標(biāo)記時(shí)出錯(cuò) |
---|---|
返回: | HTML格式的表單驗(yàn)證錯(cuò)誤消息(s) |
返回類型: | 串 |
$ prefix(string) - 打開(kāi)標(biāo)簽時(shí)出錯(cuò)
$ suffix(string) - 錯(cuò)誤結(jié)束標(biāo)記
返回:HTML格式的表單驗(yàn)證錯(cuò)誤消息(s)
Return type: string
與[`form_error()`](about:blank#form_error)函數(shù)類似,返回由[Form Validation Library](../ libraries / form_validation)生成的所有驗(yàn)證錯(cuò)誤消息,每個(gè)消息周圍都有可選的開(kāi)始和結(jié)束標(biāo)記消息。
例子:
echo validation_errors('<span class =“error”>','</ span>'); / *會(huì)產(chǎn)生,例如:<span class =“error”>“email”字段不包含有效的電子郵件地址!</ span> <span class =“error”>“password”字段doesn' t匹配“repeat_password”字段!</ span> * /
form_prep($str)
參數(shù): | $ str(string) - 要轉(zhuǎn)義的值 |
---|---|
返回: | 轉(zhuǎn)義價(jià)值 |
返回類型: | 串 |
$ str(string) - 要轉(zhuǎn)義的值
返回:轉(zhuǎn)義值
Return type: string
允許您安全地在表單元素中使用HTML和字符(如引號(hào)),而不會(huì)破壞表單。
注
如果您使用此頁(yè)面中列出的任何表單幫助函數(shù),則表單值將自動(dòng)準(zhǔn)備,因此不需要調(diào)用此函數(shù)。只有在創(chuàng)建自己的表單元素時(shí)才使用它。
注
這個(gè)函數(shù)是不推薦的,它只是一個(gè)別名。公共函數(shù)html_escape()
-請(qǐng)用這個(gè)代替。