SubmitType领域
编辑该页面警告:你浏览的文档欧宝官网下载appob娱乐下载Symfony 4.4,不再维护。
读这个页面的更新版本Symfob娱乐下载ony 6.3(当前的稳定版本)。
SubmitType领域
一个提交按钮。
呈现为 | 按钮 提交 标签 |
父类型 | ButtonType |
类 | SubmitType |
提示
选项的完整列表和继承了这种类型定义在你的应用可以运行这个命令:
1 2
#替换“FooType”的表单类型的类名美元php bin /控制台调试:FooType形式
Submit按钮有一个额外的方法那么回事()让你检查这个按钮是否被用于提交表单。这是特别有用,当一种具有多个提交按钮:
1 2 3
如果(美元形式- >get (“保存”)- >那么回事()){/ /……}
继承的选项
attr
类型:数组
默认的:[]
如果你想添加额外的属性的HTML表示按钮,您可以使用attr
选择。这是一个关联数组与HTML属性作为一个关键。这可能是有用的,当你需要为按钮设置一个自定义类:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\SubmitType;/ /……美元构建器- >add (“保存”,SubmitType::类,“attr”= > [“类”= >“保存”)));
标签
类型:字符串
默认的:标签是“猜”字段名称
设置标签将显示在按钮。设置标签也可以直接在模板:
1
{{form_widget(形式。保存,{“标签”:点击我的})}}
1
< ?=美元视图(“形式”]- >小部件(美元形式(“保存”]、[“标签”= >点击我的])? >
label_format
类型:字符串
默认的:零
配置字段的字符串作为标签,以防标签
选择是没有设置,这是有用的在使用关键字翻译的消息。
如果你使用关键字翻译信息标签,你经常有多个关键字信息相同的标签(如。profile_address_street
,invoice_address_street
)。这是因为每个“路径”的标签是建立一个字段。为了避免重复的关键字信息,您可以配置标签格式一个静态值,如:
1 2 3 4 5 6 7 8
/ /……美元profileFormBuilder- >add (“地址”,AddressType::类,“label_format”= >“form.address. %名称%”]);美元invoiceFormBuilder- >add (“发票”,AddressType::类,“label_format”= >“form.address. %名称%”]);
这个选项是遗传的子类型。上面的代码的标签街
两种形式将使用领域form.address.street
关键字信息。
两个变量标签格式是可用的:
-
% id %
-
字段的惟一标识符,包括完整的路径字段和字段名(如。
profile_address_street
); -
%的名字%
-
字段名(如。
街
)。
默认值(零
)的结果“人性化”版本的字段名。
请注意
的label_format
选择是评估形式的主题。如果你一定要更新您的模板定制的形式主题。
label_translation_parameters
类型:数组
默认的:[]
的内容标签选择是在显示之前翻译,所以它可以包含翻译占位符。这个选项定义了用于替换这些占位符的值。
鉴于这种翻译的信息:
1 2
#翻译/ messages.en.yamlform.order.submit_to_company:发送一个以%公司%的
您可以指定占位符的值如下:
1 2 3 4 5 6 7 8 9
使用ob娱乐下载\组件\形式\扩展\核心\类型\SubmitType;/ /……美元构建器- >add (“发送”,SubmitType::类,“标签”= >“form.order.submit_to_company”,“label_translation_parameters”= > [%公司%的= >“ACME公司”。、]]);
的label_translation_parameters
选项按钮合并相同的选项的父母,所以按钮可以重用和/或覆盖的任何父占位符。
attr_translation_parameters
类型:数组
默认的:[]
4.3
的attr_translation_parameters
选项是在Symfony 4.3中引入的。ob娱乐下载
的内容标题
和占位符
中定义的值attr选择是在显示之前翻译,所以它可以包含翻译占位符。这个选项定义了用于替换这些占位符的值。
鉴于这种翻译的信息:
1 2 3
#翻译/ messages.en.yamlform.order.id.placeholder:“输入惟一标识符以%公司%的form.order.id.title:这将在通信参考%公司%的
您可以指定占位符的值如下:
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
选择如果你想将这些属性添加到表单类型小部件元素。
4.3
的row_attr
选项是在Symfony 4.3中引入的。ob娱乐下载
validation_groups
类型:数组
默认的:零
表单包含多个提交按钮时,您可以更改验证组根据按钮用来提交表单。想象一个注册表单向导按钮去前面或下一步:
1 2 3 4 5 6 7 8 9 10 11
使用ob娱乐下载\组件\形式\扩展\核心\类型\SubmitType;/ /……美元形式=美元这- >createFormBuilder (美元用户)- >add (“previousStep”,SubmitType::类,“validation_groups”= >假,)- >add (nextStep的,SubmitType::类,“validation_groups”= > [“注册”),)- >getForm ();
特殊的假
确保没有验证点击上一步按钮时执行。当点击第二个按钮,所有约束的“登记”进行验证。
另请参阅
你可以阅读更多关于这个如何选择基于验证组提交的数据。
表单变量
变量 | 类型 | 使用 |
---|---|---|
点击 | 布尔 |
是否单击按钮时。 |