ButtonType领域

编辑本页

警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 5.2,现已不再维护。

本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。

ButtonType领域

一个简单的,没有反应的按钮。

提示

这个表单类型定义和继承的完整选项列表可以在你的应用程序中运行这个命令:

1 2
将'FooType'替换为你的表单类型的类名php bin/console debug:form FooType . php

继承的选项

属性中定义了以下选项基类型类。的基类型类的父类按钮类型和FormType,但它不是表单类型树的一部分(即它不能单独用作表单类型)。

attr

类型数组默认的[]

如果希望向按钮的HTML表示形式添加额外属性,可以使用attr选择。它是一个以HTML属性为键的关联数组。当你需要为按钮设置自定义类时,这可能很有用:

1 2 3 4 5 6
使用欧宝娱乐app下载地址组件形式扩展核心类型ButtonType/ /……构建器->add (“保存”, ButtonType::类,“attr”= > [“类”= >“保存”)));

禁用

类型布尔默认的

如果您不希望用户能够单击按钮,您可以将禁用选项设置为true。使用此按钮将无法提交表单,即使绕过浏览器并手动发送请求(例如使用cURL)也不行。

标签

类型字符串默认的:从字段名“猜测”标签

设置将显示在按钮上的标签。标签也可以直接在模板内设置:

  • 嫩枝
  • PHP
1
{{form_widget(形式。save, {'label': '点击我'})}}

label_html

类型布尔默认的

5.1

label_html选项在Symfony 5.1中引入。欧宝娱乐app下载地址

的内容默认为标签选项在模板中呈现之前进行转义。将此选项设置为真正的不转义它们,这在标签包含HTML元素时很有用。

translation_domain

类型字符串默认的消息

这是翻译域,将用于为此按钮呈现的任何标签或选项。

label_translation_parameters

类型数组默认的[]

的内容标签选项在显示之前进行转换,因此它可以包含翻译占位符.此选项定义用于替换这些占位符的值。

考虑到以下翻译信息:

1 2
#翻译/ messages.en.yamlform.order.submit_to_company:'向%company%发送订单'

可以按照如下方式指定占位符值:

1 2 3 4 5 6 7 8 9
使用欧宝娱乐app下载地址组件形式扩展核心类型ButtonType/ /……构建器->add (“发送”, ButtonType::类,“标签”= >“form.order.submit_to_company”“label_translation_parameters”= > [%公司%的= >“ACME公司”。,],]);

label_translation_parameters按钮的选项与其父选项合并,因此按钮可以重用和/或覆盖任何父占位符。

attr_translation_parameters

类型数组默认的[]

的内容标题而且占位符定义在attr选项在显示之前进行转换,因此它可以包含翻译占位符.此选项定义用于替换这些占位符的值。

考虑到以下翻译信息:

1 2 3
#翻译/ messages.en.yamlform.order.id.placeholder:'输入订单的唯一标识符%company%'form.order.id.title:'这将是与%company%通信时的引用'

可以按照如下方式指定占位符值:

1 2 3 4 5 6 7 8 9
构建器->add (“id”, (“attr”= > [“占位符”= >“form.order.id.placeholder”“标题”= >“form.order.id.title”),“attr_translation_parameters”= > [%公司%的= >“ACME公司”。,],]);

attr_translation_parameters子字段的选项与父字段的相同选项合并,因此子字段可以重用和/或覆盖任何父字段占位符。

row_attr

类型数组默认的[]

元素中添加的HTML属性的关联数组,用于呈现表单类型行

1 2 3
构建器->add (“身体”, TextareaType::类,“row_attr”= > [“类”= >“文本编辑器”“id”= >“……”)));

另请参阅

使用attr属性中添加这些属性表单类型小部件元素。

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。