Codeigniter 3 中文开发手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
目录 搜索
Array Array Helper Benchmarking Benchmarking Class Caching Caching Driver Calendaring Calendaring Class CAPTCHA CAPTCHA Helper Config Config Class Cookie Cookie Helper Database Connecting to your Database Custom Function Calls Database Caching Class Database Configuration Database Forge Class Database Metadata Database Quick Start: Example Code Database Reference Database Utility Class DB Driver Reference Generating Query Results Queries Query Builder Class Query Helper Methods Transactions Date Date Helper Directory Directory Helper Download Download Helper Email Email Class Email Helper Encrypt Encrypt Class Encryption Encryption Library File File Helper File Uploading File Uploading Class Form Form Helper Form Validation Form Validation FTP FTP Class Functions compatibility_functions common_functions HTML HTML Helper HTML Table HTML Table Class Image Manipulation Image Manipulation Class Inflector Inflector Helper Input Input Class Javascript Javascript Class Language Language Class Language Helper Loader Loader Class Migrations Migrations Class Number Number Helper Output Output Class Pagination Pagination Class Path Path Helper Security Security Class Security Helper Session Session Library Shopping Cart Shopping Cart Class Smiley Smiley Helper String String Helper Template Parser Template Parser Class Text Text Helper Trackback Trackback Class Typography Typography Class Typography Helper Unit Testing Unit Testing Class URI URL User Agent XML XML-RPC and XML-RPC Server Zip Encoding Zip Encoding Class XML-RPC and XML-RPC Server Classes XML Helper User Agent Class URL Helper URI Class

©
本文档使用PHP中文网手册发布

文字

表单帮助文件包含有助于使用表单的功能。

  • 加载此助手

  • 转义场值

  • 可用职能

加载此助手

使用以下代码加载此助手：

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

转义场值

您可能需要在表单元素中使用HTML和字符(如引号)。为了安全地完成这个任务，您需要使用公共函数html_escape()...

考虑以下示例：

$string = 'Here is a string containing "quoted" text.';

由于上面的字符串包含一组引号，它将导致表单中断。大html_escape()函数转换HTML特殊字符，以便安全地使用：

注

如果使用此页面中列出的任何表单帮助函数，则表单值将自动转义，因此不需要调用此函数。只有在创建自己的表单元素时才使用它。

可用职能

现有下列职能：

form_open([$action = ''[, $attributes = ''[, $hidden = array()]]])

参数：

$ action（string） - 表单动作/目标URI字符串$ attributes（array） - HTML属性$ hidden（array） - 一个隐藏字段定义数组

返回：

一个HTML表单打开标记

返回类型：

串

  • $ action（string） - 表单动作/目标URI字符串

  • $ attributes（array） - HTML属性

  • $ hidden（array） - 一个隐藏字段的定义数组

返回：HTML表单开始标记
返回类型：字符串
使用从您的配置首选项**构建的基本URL **创建开放表单标记。它可以选择让你添加表单属性和隐藏的输入字段，并且总是添加基于配置文件中charset值的`accept-charset`属性。

使用这个标记而不是硬编码自己的HTML的主要好处是，它允许您的站点在URL更改时更易于移植。

下面是一个简单的例子：

echo form_open（'email / send'）;

上面的示例将创建一个指向基本URL和“Email/Send”URI段的表单，如下所示：

添加属性

可以通过向第二个参数传递关联数组来添加属性，如下所示：

$ attributes = array（'class'=>'email'，'id'=>'myform'）; echo form_open（'email / send'，$ attributes）;

或者，可以将第二个参数指定为字符串：

echo form_open（'email / send'，'class =“email”id =“myform”'）;

上述示例将创建一个类似于此的形式：

添加隐藏输入字段

可以通过向第三个参数传递关联数组来添加隐藏字段，如下所示：

$ hidden = array（'username'=>'Joe'，'member_id'=>'234'）; echo form_open（'email / send'，''，$ hidden）;

您可以通过向第二个参数传递任何Falsy值来跳过第二个参数。

上面的示例将创建一个类似于此的表单：

form_open_multipart([$action = ''[, $attributes = array()[, $hidden = array()]]])

参数：

$ action（string） - 表单动作/目标URI字符串$ attributes（array） - HTML属性$ hidden（array） - 一个隐藏字段定义数组

返回：

HTML多部分表单打开标记

返回类型：

串

  • $ action（string） - 表单动作/目标URI字符串

  • $ attributes（array） - HTML属性

  • $ hidden（array） - 一个隐藏字段的定义数组

返回：HTML多部分表单打开标记
返回类型：字符串
这个函数与上面的``form_open（）`]（about：blank＃form_open）完全相同，除了它增加了一个_multipart_属性，如果你想使用表单来上传文件，这是必须的。

form_hidden($name[, $value = ''])

参数：

$ name（字符串） - 字段名称$ value（字符串） - 字段值

返回：

HTML隐藏输入字段标记

返回类型：

串

  • $ name（字符串） - 字段名称

  • $ value（字符串） - 字段值

返回：HTML隐藏的输入字段标记
返回类型：字符串
让您生成隐藏的输入字段。您可以提交一个名称/值字符串来创建一个字段：

form_hidden（'username'，'johndoe'）; //会产生：

...或者可以提交一个关联数组来创建多个字段：

$ data = array（'name'=>'John Doe'，'email'=>'email protected'，'url'=>' http://example.com '）; echo form_hidden（$ data）; / *会产生： * /

还可以将关联数组传递给Value字段：

$ data = array（'name'=>'John Doe'，'email'=>'email protected'，'url'=>' http://example.com '）; echo form_hidden（'my_array'，$ data）; / *会生成： * /

如果要创建具有额外属性的隐藏输入字段：

$ data = array（'type'=>'hidden'，'name'=>'email'，'id'=>'hiddenemail'，'value'=>'email protected'，'class'=>'hiddenemail' ）; echo form_input（$ data）; / *会产生： * /

form_input([$data = ''[, $value = ''[, $extra = '']]])

参数：

$ data（array） - 字段属性数据$ value（字符串） - 字段值$ extra（混合） - 要作为数组或字符串添加到标记的额外属性

返回：

HTML文本输入字段标记

返回类型：

串

  • $ data（array） - 字段属性数据

  • $ value（字符串） - 字段值

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

返回：HTML文本输入字段标记
返回类型：字符串
让您生成标准文本输入字段。您可以最小化地传递第一个和第二个参数中的字段名称和值：

echo form_input（'username'，'johndoe'）;

也可以传递一个关联数组，该数组包含您希望窗体包含的任何数据：

$data = array( 'name' => 'username', 'id' => 'username', 'value' => 'johndoe', 'maxlength' => '100', 'size' => '50', 'style' => 'width:50%' ); echo form_input($data); /* Would produce: */

如果希望表单包含一些附加数据，如JavaScript，则可以将其作为字符串传递到第三个参数中：

$ js ='onClick =“some_function（）”'; echo form_input（'username'，'johndoe'，$ js）;

也可以将其作为数组传递：

$ js = array（'onClick'=>'some_function（）;'）; echo form_input（'username'，'johndoe'，$ js）;

form_password([$data = ''[, $value = ''[, $extra = '']]])

参数：

$ data（array） - 字段属性数据$ value（字符串） - 字段值$ extra（混合） - 要作为数组或字符串添加到标记的额外属性

返回：

一个HTML密码输入字段标签

返回类型：

串

  • $ data（array） - 字段属性数据

  • $ value（字符串） - 字段值

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

返回：HTML密码输入字段标记
返回类型：字符串
除了使用“password”输入类型外，这个函数在所有方面都与[`form_input（）`]（about：blank＃form_input）函数完全相同。

form_upload([$data = ''[, $value = ''[, $extra = '']]])

参数：

$ data（array） - 字段属性数据$ value（字符串） - 字段值$ extra（混合） - 要作为数组或字符串添加到标记的额外属性

返回：

一个HTML文件上传输入字段标记

返回类型：

串

  • $ data（array） - 字段属性数据

  • $ value（字符串） - 字段值

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

返回：HTML文件上传输入字段标记
返回类型：字符串
这个函数在所有方面都与上面的[`form_input（）`]（about：blank＃form_input）函数相同，除了它使用“file”输入类型，允许它用于上传文件。

form_textarea([$data = ''[, $value = ''[, $extra = '']]])

参数：

$ data（array） - 字段属性数据$ value（字符串） - 字段值$ extra（混合） - 要作为数组或字符串添加到标记的额外属性

返回：

一个HTML textarea标签

返回类型：

串

  • $ data（array） - 字段属性数据

  • $ value（字符串） - 字段值

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

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.

注

取而代之的是的最大长度和尺寸在上面的例子中的属性，你反而会指定行和COLS。

form_dropdown([$name = ''[, $options = array()[, $selected = array()[, $extra = '']]]])

参数：

$ name（字符串） - 字段名称$ options（array） - 要列出的选项的关联数组$ extra（array） - 用选定属性标记的字段列表$ extra（mixed） - 要添加到标记为数组或字符串

返回：

HTML下拉选择字段标记

返回类型：

串

  • $ name（字符串） - 字段名称

  • $ options（array） - 要列出的选项的关联数组

  • $ selected（array） - 用选定属性标记的字段列表

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

Returns: An HTML dropdown select field tag
Return type: string
让您创建一个标准的下拉字段。第一个参数将包含字段的名称，第二个参数将包含选项的关联数组，第三个参数将包含您希望选择的值。您还可以通过第三个参数传递多个项目的数组，CodeIgniter将为您创建一个多选项。

例子：

''''''''小号衬衫'，'med'=>'中型衬衫'，'大号'=>'大号衬衫'，'xlarge'=>'超大号衬衫'，）; $ shirts_on_sale = array（'small'，'large'）; echo form_dropdown（'shirts'，$ options，'large'）; / *会产生：

如果您希望打开的

第三个参数包含一个布尔值true/false，以确定是否应该选中该框。

与此助手中的其他表单函数类似，您还可以将属性数组传递给该函数：

$ data = array（'name'=>'newsletter'，'id'=>'newsletter'，'value'=>'accept'，'checked'=> TRUE，'style'=>'margin：10px'） ; echo form_checkbox（$ data）; //会产生：

与其他函数一样，如果希望标记包含JavaScript之类的其他数据，则可以在第四个参数中将其作为字符串传递：

$ js ='onClick =“some_function（）”'; echo form_checkbox（'newsletter'，'accept'，TRUE，$ js）;

也可以将其作为数组传递：

$ js = array（'onClick'=>'some_function（）;'）; echo form_checkbox（'newsletter'，'accept'，TRUE，$ js）;

form_radio([$data = ''[, $value = ''[, $checked = FALSE[, $extra = '']]]])

参数：

$ data（字符串） - 字段值$ checked（bool） - 是否将单选按钮标记为检查$ extra（混合） - 要作为数组添加到标记的额外属性或一个文字字符串

返回：

一个HTML无线电输入标签

返回类型：

串

  • $ data（array） - 字段属性数据

  • $ value（字符串） - 字段值

  • $ checked（bool） - 是否将单选按钮标记为正在检查

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

Returns: An HTML radio input tag
Return type: string
除了使用“radio”输入类型之外，这个函数在所有方面与[`form_checkbox（）`]（about：blank＃form_checkbox）函数完全相同。

form_label([$label_text = ''[, $id = ''[, $attributes = array()]]])

参数：

$ label_text（string） - 放入

返回：

一个HTML字段标签标签

返回类型：

串

  • $ label_text（string） - 放在

  • $ id（字符串） - 我们为其制作标签的表单元素的ID

  • $ attributes（mixed） - HTML属性

Returns: An HTML field label tag
Return type: string
让你生成一个

echo form_label（'你的名字是什么'，'用户名'）; //会产生：

与其他函数类似，如果您喜欢设置其他属性，则可以在第三个参数中提交关联数组。

例子：

$ attributes = array（'class'=>'mycustomclass'，'style'=>'color：＃000;'）; 回声form_label（'你是什么名字'，'用户名'，$属性）; //会产生：

form_submit([$data = ''[, $value = ''[, $extra = '']]])

参数：

$ data（string） - 按钮名称$ value（字符串） - 按钮值$ extra（混合） - 要作为数组或字符串添加到标签的额外属性

返回：

HTML输入提交标记

返回类型：

串

  • $ data（字符串） - 按钮名称

  • $ value（字符串） - 按钮值

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

Returns: An HTML input submit tag
Return type: string
让你生成一个标准的提交按钮。简单的例子：

echo form_submit（'mysubmit'，'Submit Post！'）; //会产生：

与其他函数类似，如果您喜欢设置自己的属性，可以在第一个参数中提交关联数组。第三个参数允许您向表单中添加额外的数据，比如JavaScript。

form_reset([$data = ''[, $value = ''[, $extra = '']]])

参数：

$ data（string） - 按钮名称$ value（字符串） - 按钮值$ extra（混合） - 要作为数组或字符串添加到标签的额外属性

返回：

一个HTML输入重置按钮标签

返回类型：

串

  • $ data（字符串） - 按钮名称

  • $ value（字符串） - 按钮值

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

返回：HTML输入重置按钮标记
Return type: string
让您生成一个标准的重置按钮。使用与`form_submit（）`相同。

form_button([$data = ''[, $content = ''[, $extra = '']]])

参数：

$ data（字符串） - 按钮名称$ content（字符串） - 按钮标签$ extra（混合） - 要作为数组或字符串添加到标签的额外属性

返回：

一个HTML按钮标签

返回类型：

串

  • $ data（字符串） - 按钮名称

  • $ content（string） - 按钮标签

  • $ extra（mixed） - 要作为数组或字符串添加到标记的额外属性

Returns: An HTML button tag
Return type: string
让你生成一个标准的按钮元素。您可以最低限度地传递第一个和第二个参数中的按钮名称和内容：

echo form_button（'name'，'content'）; //将产生：

也可以传递一个关联数组，该数组包含您希望窗体包含的任何数据：

$ data = array（'name'=>'button'，'id'=>'button'，'value'=>'true'，'type'=>'reset'，'content'=>'Reset'） ; echo form_button（$ data）; //产生：

如果希望表单包含一些附加数据，如JavaScript，则可以将其作为字符串传递到第三个参数中：

$ js ='onClick =“some_function（）”'; echo form_button（'mybutton'，'Click Me'，$ js）;

form_close([$extra = ''])

参数：

$ extra（string） - 任何要在结束标记之后追加的东西

返回：

一个HTML表单结束标记

返回类型：

串

  • $extra(string) – Anything to append after the closing tag,as isReturns: An HTML form closing tag Return type: string Produces a closing 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 = '

'; echo form_close($string); // Would produce:
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） - 默认值

  • $ html_escape（bool） - 是否关闭HTML值的转义

Returns: Field value
Return type: string
允许您设置输入表单或textarea的值。您必须通过函数的第一个参数提供字段名称。第二个（可选）参数允许您为表单设置默认值。第三个（可选）参数允许您关闭HTML转义值，以防需要将此函数与ie [`form_input（）`]（about：blank＃form_input）结合使用并避免双重转义。

例子：

”size =“50”/>

当首次加载时，上述表单将显示“0”。

注

如果您已经加载了表单验证库并设置了与此助手一起使用的字段名的验证规则，然后将调用转发给表单验证库自己的set_value()方法。否则，此函数将在$_POST字段值。

set_select($field[, $value = ''[, $default = FALSE]])

参数：

$ field（string） - 字段名称$ value（字符串） - 检查$ default（string）的值 - 值是否也是默认值

返回：

'selected'属性或一个空字符串

返回类型：

串

  • $ field（string） - 字段名称

  • $ value（string） - 要检查的值

  • $ default（string） - 该值是否也是默认值

Returns: ‘selected’ attribute or an empty string
Return type: string
如果您使用

set_checkbox($field[, $value = ''[, $default = FALSE]])

参数：

$ field（string） - 字段名称$ value（字符串） - 检查$ default（string）的值 - 值是否也是默认值

返回：

'checked'属性或一个空字符串

返回类型：

串

  • $ field（string） - 字段名称

  • $ value（string） - 要检查的值

  • $ default（string） - 该值是否也是默认值

Returns: ‘checked’ attribute or an empty string
Return type: string
允许您以提交状态显示复选框。

第一个参数必须包含复选框的名称，第二个参数必须包含其值，第三个（可选）参数允许您将项目设置为默认值（使用布尔值TRUE / FALSE）。

例子：

/> />

set_radio($field[, $value = ''[, $default = FALSE]])

参数：

$ field（string） - 字段名称$ value（字符串） - 检查$ default（string）的值 - 值是否也是默认值

返回：

'checked'属性或一个空字符串

返回类型：

串

  • $ field（string） - 字段名称

  • $ value（string） - 要检查的值

  • $ default（string） - 该值是否也是默认值

Returns: ‘checked’ attribute or an empty string
Return type: string
允许您以提交状态显示单选按钮。这个函数与上面的``set_checkbox（）`]（about：blank＃set_checkbox）函数相同。

例子：

/> />

注

如果您使用的是表单验证类，则必须始终为您的字段指定规则，即使为空，以便set_*()功能开始工作。这是因为如果定义了表单验证对象，则set_*()传递给类的方法，而不是泛型助手函数。

form_error([$field = ''[, $prefix = ''[, $suffix = '']]])

参数：

$ field（string） - 字段名称$ prefix（字符串） - 打开标记时出错$ suffix（string） - 标记结束时出错

返回：

HTML格式的表单验证错误消息（s）

返回类型：

串

  • $ field（string） - 字段名称

  • $ prefix（string） - 打开标签时出错

  • $ suffix（string） - 错误结束标记

返回：HTML格式的表单验证错误消息（s）
Return type: string
从[Form Validation Library]（../ libraries / form_validation）返回验证错误消息，与指定的字段名称关联。您可以选择指定打开和关闭标签以放置错误消息。

例子：

//假设'username'字段值不正确：echo form_error（'myfield'，'

'，''）; //将产生：
与“用户名”字段相关联的错误消息。

validation_errors([$prefix = ''[, $suffix = '']])

参数：

$ prefix（string） - 打开标记$ suffix（string）时出错 - 关闭标记时出错

返回：

HTML格式的表单验证错误消息（s）

返回类型：

串

  • $ prefix（string） - 打开标签时出错

  • $ suffix（string） - 错误结束标记

返回：HTML格式的表单验证错误消息（s）
Return type: string
与[`form_error（）`]（about：blank＃form_error）函数类似，返回由[Form Validation Library]（../ libraries / form_validation）生成的所有验证错误消息，每个消息周围都有可选的开始和结束标记消息。

例子：

echo validation_errors（''，''）; / *会产生，例如：“email”字段不包含有效的电子邮件地址！ “password”字段doesn' t匹配“repeat_password”字段！ * /

form_prep($str)

参数：

$ str（string） - 要转义的值

返回：

转义价值

返回类型：

串

  • $ str（string） - 要转义的值

返回：转义值
Return type: string
允许您安全地在表单元素中使用HTML和字符（如引号），而不会破坏表单。

注

如果您使用此页面中列出的任何表单帮助函数，则表单值将自动准备，因此不需要调用此函数。只有在创建自己的表单元素时才使用它。

注

这个函数是不推荐的，它只是一个别名。公共函数html_escape()-请用这个代替。

上一篇： 下一篇：