form()

October CMS Documentation Docs

form()

以 form_ 为前缀的函数执行处理表单时。 助手程序直接映射到Form PHP 类及其方法。 例如:

___TWIG0___

下面写法相等于上面:

<?= Form::close() ?>

注意: 驼峰命名 中的方法应转换为 蛇形命名.

# form_open()

输出一个标准的 <form> 标签以及用于 CSRF 保护的 _session_key 和 _token 隐藏字段。如果您使用 AJAX 框架, 建议您改用 form_ajax() .

___TWIG0___

属性可以在第一个参数中传递。

___TWIG0___

上面的示例将输出如下:

<form class="form-horizontal">

有一些特殊选项也可以与属性一起使用。

___TWIG0___

该函数支持以下选项:

选项描述
method请求方法。 对应 method FORM 标签属性。 例如: POST, GET, PUT, DELETE
request发布表单时在服务器上执行的处理程序名称。 有关事件处理程序的详细信息,请参阅 处理表单
url指定将表单发布到的 URL。 对应 action FORM 标签属性。
files确定表单是否将提交文件。 接受的值:true 和 false。
model表单模型绑定的模型对象

# form_ajax()

输出一个启用 AJAX 的 FORM 开始标签。 form_ajax() 函数的第一个参数是 AJAX 处理程序名称。处理程序可以在布局或页面 PHP部分 代码中定义,也可以在组件中定义。Y您可以在AJAX框架 文章中找到有关 AJAX 的更多信息。

___TWIG0___

属性可以在第二个参数中传递。

___TWIG0___

上面的示例将输出如下:

<form data-request="onSave" class="form-horizontal">

有一些特殊选项也可以与属性一起使用。

___TWIG0___

___TWIG1___

注意: 当尝试使用 __SELF__ 作为 form_ajax() 的参数来引用组件的别名时,您必须首先在调用本身之外构建您希望使用的字符串。 例子:

___TWIG0___
___TWIG1___

该函数支持以下选项:

选项描述
success要在成功结果上执行的 JavaScript 字符串。
error对失败结果执行的 JavaScript 字符串
confirm在发送请求之前显示的确认消息。
redirect成功后,重定向到 URL。
update要在成功时更新的部件数组,格式如下:{ 'partial': '#element' }。
data要包含在请求中的额外数据,格式如下:{ 'myvar': 'myvalue' }。

# form_close()

输出一个标准的 FORM 结束标签。 此标签通常可用于提供一致性的使用。

___TWIG0___

上面的示例将输出如下:

</form>

# 将属性传递给生成的元素

您可以通过传递要在最终生成的 <form> 元素上呈现的属性名称和值的数组来将其他属性传递给 Form::open() 方法。

<?= Form::open(array('id' => 'example', 'class' => 'something')) ?>
    // ..
<?= Form::close() ?>

上面的示例将输出以下内容:

<form method="POST" action="" accept-charset="UTF-8" id="example" class="something">

</form>