CurrencyType领域
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 4.1,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
CurrencyType领域
的CurrencyType
的子集ChoiceType它允许用户从一个大的列表中进行选择3个字母的ISO 4217货币。
不像ChoiceType
,则不需要指定a选择
选项作为字段类型自动使用大量货币列表。你可以手动指定该选项,但随后应该使用ChoiceType
直接。
呈现为 | 可以是各种标签(看到了吗选择类型字段(选择下拉列表,单选按钮和复选框)) |
选项 | |
覆盖选项 | |
继承的选项 | 从ChoiceType-error_bubbling-扩大-多个-占位符-preferred_choices-修剪从FormType类型,数据-禁用-empty_data-帮助-标签-label_attr-label_format-映射-要求 |
父类型 | ChoiceType |
类 | CurrencyType |
场的选择
choice_translation_locale
类型:字符串
或零
默认的:零
此选项决定是否应将选项值转换为与当前语言环境不同的语言环境。
的值choice_translation_locale
选项可以是零
(重用当前翻译区域)或表示要使用的确切翻译区域的字符串。
覆盖选项
选择
默认的:ob娱乐下载Symfony \组件\ Intl \ Intl: getCurrencyBundle()——> getCurrencyNames ()
选项选项默认为所有货币。
谨慎
如果要覆盖货币类型的内置选项,还必须设置choice_loader
选项零
.
继承的选项
方法继承了这些选项ChoiceType:
error_bubbling
类型:布尔
默认的:假
除非表格是复合
如果真正的
,此字段的任何错误都将传递给父字段或表单。例如,如果设置为真正的
对于普通字段,该字段的任何错误都将附加到主表单,而不是特定的字段。
占位符
类型:字符串
或布尔
这个选项决定了一个特殊的“空”选项(例如:“选择一个选项”)将出现在选择小部件的顶部。此选项仅适用于多个
选项设置为false。
添加一个空值,文本为“Choose an option”:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“州”, ChoiceType::类,“占位符”= >“选择一个选项”]);
确保没有“空”值选项显示:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“州”, ChoiceType::类,“占位符”= >假]);
如果你离开占位符
选项未设置时,则当且仅当要求
选项为false:
1 2 3 4 5 6 7
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……//添加一个空白(无文本)选项$构建器->add (“州”, ChoiceType::类,“要求”= >假]);
preferred_choices
类型:数组
,可调用的
或字符串
默认的:[]
此选项允许您将某些选项移动到列表的顶部,并在它们与其他选项之间使用可视分隔符。如果你有一种语言,你可以在上面列出最流行的语言,比如Bork Bork和Pirate:
12 3 4 5 6 7 8 9 10 11 12
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“语言”, ChoiceType::类,“选择”= > [“英语”= >“en”,“西班牙”= >“西文”,“博克”= >“布偶”,“海盗”= >“加勒比海盗”),“preferred_choices”= > [“布偶”,“加勒比海盗”)));
该选项也可以是回调函数,以提供更大的灵活性。如果你的值是对象,这可能特别有用:
12 3 4 5 6 7 8 9 10 11 12 13 14 15
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“publishAt”, ChoiceType::类,“选择”= > [“现在”= >新\ DateTime (“现在”),“明天”= >新\ DateTime (“+ 1天”),“1周”= >新\ DateTime (“+ 1周”),“一个月”= >新\ DateTime (“+ 1月”),),“preferred_choices”= >函数($价值,$关键){//首选3天内的选项返回$价值< =新\ DateTime (+ 3天的);}));
这将“偏爱”“现在”和“明天”的选择:
最后,如果您的值是对象,您还可以在对象上指定属性路径字符串,该字符串将返回true或false。
类时,首选选项才有意义选择
元素(即。扩大
假)。首选选项和普通选项在视觉上由一组虚线分隔开。-------------------
).这可以在呈现字段时自定义:
- 嫩枝
- PHP
1
{{form_widget(形式。publishAt, {'separator': '====='})}}
1 2 3
< ?=$视图[“形式”]->小部件($形式[“publishAt”]、[“分隔符”= >“= = = = =”])? >
数据
类型:混合
默认的:默认为底层结构的字段。
当你创建一个表单时,每个字段最初都会显示表单域数据的对应属性的值(例如,如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值,你可以在data选项中设置它:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\HiddenType;/ /……$构建器->add (“令牌”, HiddenType::类,“数据”= >“六边形abcdef”]);
谨慎
的数据
选项总是在呈现时覆盖从域数据(对象)获取的值。这意味着当表单编辑一个已经持久化的对象时,对象值也会被覆盖,从而导致在表单提交时失去它的持久化值。
empty_data
类型:混合
- . .该文件应该只包含“开始后”或“结束前”
- 设置为此占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
这个选项决定字段的值返回当提交的值为空(或缺失)时。如果在视图中呈现表单时没有提供初始值,则不设置初始值。
这意味着它可以帮助您处理带有空白字段的表单提交。例如,如果你想要的名字
要显式设置为的字段John Doe
当没有选择值时,你可以这样做:
1 2 3 4
$构建器->add (“名字”,零, (“要求”= >假,“empty_data”= >“John Doe”]);
这仍然会呈现一个空文本框,但在提交John Doe
值将被设置。使用数据
或占位符
选项,在呈现的表单中显示此初始值。
如果表单是复合的,则可以设置empty_data
作为数组、对象或闭包。看到如何为窗体类配置空数据文章中有关于这些选项的详细信息。
请注意
如果你想设置empty_data
整个表单类的选项,请参见如何为窗体类配置空数据篇文章。
该选项的实际默认值取决于其他字段选项:
- 如果
多个
是假
而且扩大
是假
,然后”
(空字符串); - 否则
[]
(空数组)。
empty_data
类型:混合
- . .该文件应该只包含“开始后”或“结束前”
- 设置为此占位符值。它的目的是让我们只包含该文件的一部分。
DEFAULT_PLACEHOLDER
这个选项决定字段的值返回当提交的值为空(或缺失)时。如果在视图中呈现表单时没有提供初始值,则不设置初始值。
这意味着它可以帮助您处理带有空白字段的表单提交。例如,如果你想要的名字
要显式设置为的字段John Doe
当没有选择值时,你可以这样做:
1 2 3 4
$构建器->add (“名字”,零, (“要求”= >假,“empty_data”= >“John Doe”]);
这仍然会呈现一个空文本框,但在提交John Doe
值将被设置。使用数据
或占位符
选项,在呈现的表单中显示此初始值。
如果表单是复合的,则可以设置empty_data
作为数组、对象或闭包。看到如何为窗体类配置空数据文章中有关于这些选项的详细信息。
请注意
如果你想设置empty_data
整个表单类的选项,请参见如何为窗体类配置空数据篇文章。
帮助
类型:字符串
默认的:零
允许您为表单字段定义帮助消息,默认情况下,表单字段呈现在字段下面。
1 2 3
$构建器->add (“zip_code”,零, (“帮助”= >“您信用卡账单地址的邮政编码。”]);
标签
类型:字符串
默认的:从字段名“猜测”标签
设置呈现字段时将使用的标签。设置为false将屏蔽标签。标签也可以直接在模板内设置:
- 嫩枝
- PHP
1
{{form_label(form.name, '你的名字')}}
1 2 3 4
回声$视图[“形式”]->标签($形式[“名字”),“你的名字”);
label_attr
类型:数组
默认的:[]
属性的HTML属性<标识>
元素,它将在呈现字段的标签时使用。它是一个以HTML属性为键的关联数组。这些属性也可以直接在模板中设置:
- 嫩枝
- PHP
1 2 3
{{form_label(form.name, '您的名字',{' label_attr': {'class': 'CUSTOM_LABEL_CLASS'}})}}
1 2 3 4 5
回声$视图[“形式”]->标签($形式[“名字”),“你的名字”, (“label_attr”= > [“类”= >“CUSTOM_LABEL_CLASS”]]);
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
关键字信息。
label格式有两个变量:
-
% id %
-
字段的唯一标识符,由字段的完整路径和字段名组成。
profile_address_street
); -
%的名字%
-
字段名(例如:
街
).
默认值(零
)的结果是“人性化”版本字段名的。
请注意
的label_format
选项在表单主题中求值。确保更新你的模板以防你定制表单主题.
要求
类型:布尔
默认的:真正的
如果为,则HTML5所需属性将被渲染。相应的标签
还会渲染一个要求
类。
这是肤浅的,独立于验证。如果您让Symfony猜测您的字段类型,ob娱乐下载那么这个选项的值将从您的验证信息中猜测出来。
请注意
必选选项还影响如何处理每个字段的空数据。有关详细信息,请参见empty_data选择。