MoneyType领域
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 3.4,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
MoneyType领域
呈现一个输入文本字段,专门处理提交的“钱”数据。
此字段类型允许您指定一种货币,其符号将呈现在文本字段旁边。还有其他几个选项用于定制如何处理数据的输入和输出。
场的选择
货币
类型:字符串
默认的:欧元
指定指定货币的货币。这决定了文本框应该显示的货币符号。根据货币的不同,货币符号可以显示在输入文本字段的前面或后面。
这可以是任何3个字母ISO 4217代码.您还可以将其设置为false以隐藏货币符号。
除数
类型:整数
默认的:1
如果在将初始值呈现给用户之前需要将其除以一个数字,则可以使用除数
选择。例如,如果您将价格存储为整数,以避免舍入误差,可以自动转换以美分为单位的值:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\MoneyType;/ /……$构建器->add (“价格”, MoneyType::类,“因子”= >One hundred.]);
在本例中,如果价格
字段设置为9900
,则值99
会呈现给用户。当用户提交值时99
,它将乘以One hundred.
而且9900
最终会在你的对象上重新设置。
分组
类型:布尔
默认的:假
该值在内部用作NumberFormatter:: GROUPING_USED
值时使用PHP的NumberFormatter
类。它的文档欧宝官网下载app是不存在的,但是如果您将其设置为真正的
,数字将以逗号或句号(取决于您的语言环境)分组:12345.123
将显示为12345年.123
.
继承的选项
方法继承了这些选项FormType:
数据
类型:混合
默认的:默认为底层结构的字段。
当你创建一个表单时,每个字段最初都会显示表单域数据的对应属性的值(例如,如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值,你可以在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
整个表单类的选项,请参见如何为窗体类配置空数据篇文章。
error_bubbling
类型:布尔
默认的:假
除非表格是复合
如果真正的
,此字段的任何错误都将传递给父字段或表单。例如,如果设置为真正的
对于普通字段,该字段的任何错误都将附加到主表单,而不是特定的字段。
error_mapping
类型:数组
默认的:[]
此选项允许您修改验证错误的目标。
假设您有一个名为matchingCityAndZipCode ()
这将验证城市和邮政编码是否匹配。不幸的是,没有matchingCityAndZipCode
字段,所以Symfony所能做的就是在表单的顶部显示错误。ob娱乐下载
使用自定义错误映射,你可以做得更好:将错误映射到城市字段,这样它就会显示在它上面:
1 2 3 4 5 6 7 8
公共函数configureOptions(OptionsResolver$解析器){$解析器->setDefaults ([“error_mapping”= > [“matchingCityAndZipCode”= >“城市”,],]);}
下面是映射左侧和右侧的规则:
- 左侧包含属性路径;
- 如果在类的属性或方法上生成违规,则其路径为
propertyName
; - 类的项上生成的违例
数组
或ArrayAccess
对象时,属性路径为(indexName)
; - 您可以通过连接它们来构造嵌套的属性路径,用圆点分隔属性。例如:
地址[工作].matchingCityAndZipCode
; - 右侧包含表单中字段的名称。
默认情况下,任何未映射的属性的错误都会冒泡到父表单。你可以用点(.
),将所有未映射属性的错误映射到特定字段。例如,将所有这些错误映射到城市
字段中,使用:
1 2 3 4 5
$解析器->setDefaults ([“error_mapping”= > [“。”= >“城市”,],]);
invalid_message
类型:字符串
默认的:此值无效
这是验证错误消息,如果输入到该字段的数据没有意义(即验证失败),将使用该消息。
例如,如果用户将无意义的字符串输入到TimeType字段不能转换为实时的,或者如果用户输入字符串(例如。苹果
)转换为数字字段。
正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考).
invalid_message_parameters
类型:数组
默认的:[]
当设置invalid_message
选项时,您可能需要在字符串中包含一些变量。这可以通过在该选项中添加占位符并包括该选项中的变量来实现:
1 2 3 4 5
$构建器->add (“someField”, SomeFormType::类,/ /……“invalid_message”= >'您输入的值无效,它应该包含%num%字母',“invalid_message_parameters”= > [“% num %”= >6)));
标签
类型:字符串
默认的:从字段名“猜测”标签
设置呈现字段时将使用的标签。设置为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选择。
表单变量
变量 | 类型 | 使用 |
---|---|---|
money_pattern | 字符串 |
用于显示货币(包括货币)的格式。 |