字段类型

编辑本页

警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.6,现已不再维护。

本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。

字段类型

呈现一个输入文本字段,专门处理提交的“钱”数据。

此字段类型允许您指定一种货币,其符号将呈现在文本字段旁边。还有其他几个选项用于定制如何处理数据的输入和输出。

场的选择

货币

类型字符串默认的欧元

指定指定货币的货币。这决定了文本框应该显示的货币符号。根据货币的不同,货币符号可以显示在输入文本字段的前面或后面。

这可以是任何3个字母ISO 4217代码.您还可以将其设置为false以隐藏货币符号。

除数

类型整数默认的1

如果由于某种原因,需要在将初始值呈现给用户之前将其除以一个数字,则可以使用除数选择。例如:

1 2 3
构建器->add (“价格”“钱”数组“因子”= >One hundred.));

在本例中,如果价格字段设置为9900,则值99会呈现给用户。当用户提交值时99,它将乘以One hundred.而且9900最终会在你的对象上重新设置。

分组

类型整数默认的

该值在内部用作NumberFormatter:: GROUPING_USED值时使用PHP的NumberFormatter类。它的文档欧宝官网下载app是不存在的,但是如果您将其设置为真正的,数字将以逗号或句号(取决于您的语言环境)分组:12345.123将显示为12345年.123

精度

类型整数默认的2

出于某种原因,如果您需要一些精度而不是小数点后2位,您可以修改这个值。您可能不需要这样做,除非,例如,您想四舍五入到最近的美元(将精度设置为0).

覆盖选项

复合

类型布尔默认的

此选项指定类型是否包含子类型。此选项是针对内置类型进行内部管理的,因此不需要显式地配置它。

继承的选项

方法继承了这些选项形式类型:

数据

类型混合默认的:默认为基础对象的字段(如果有的话)

创建表单时,每个字段最初显示表单域对象的相应属性的值(如果对象绑定到表单)。如果你想覆盖表单的初始值或只是一个单独的字段,你可以在data选项中设置它:

1 2 3
构建器->add (“令牌”“隐藏”数组“数据”= >“六边形abcdef”));

请注意

表单字段的默认值直接取自底层数据结构(例如,实体或数组)。的数据选项将覆盖此默认值。

禁用

类型布尔默认的

如果不希望用户修改字段的值,可以将禁用选项设置为true。任何提交的值都将被忽略。

empty_data

类型混合

..该文件应该只包含“开始后”或“结束前”
设置为此占位符值。它的目的是让我们只包含该文件的一部分。

DEFAULT_PLACEHOLDER

此选项决定了当提交的值为空时字段将返回什么值。

但是您可以根据自己的需要定制它。例如,如果你想要性别要显式设置的选择字段当没有选择值时,你可以这样做:

1 2 3 4 5 6 7 8 9
构建器->add (“性别”“选择”数组“选择”= >数组“米”= >“男”“f”= >“女”),“要求”= >“占位符”= >“选择性别”“empty_data”= >));

请注意

如果你想设置empty_data整个表单类的选项,请参阅烹饪书文章如何为窗体类配置空数据

:目的:DEFAULT_PLACEHOLDER

默认值为(空字符串)。

empty_data

类型混合

..该文件应该只包含“开始后”或“结束前”
设置为此占位符值。它的目的是让我们只包含该文件的一部分。

DEFAULT_PLACEHOLDER

此选项决定了当提交的值为空时字段将返回什么值。

但是您可以根据自己的需要定制它。例如,如果你想要性别要显式设置的选择字段当没有选择值时,你可以这样做:

1 2 3 4 5 6 7 8 9
构建器->add (“性别”“选择”数组“选择”= >数组“米”= >“男”“f”= >“女”),“要求”= >“占位符”= >“选择性别”“empty_data”= >));

请注意

如果你想设置empty_data整个表单类的选项,请参阅烹饪书文章如何为窗体类配置空数据

:开始追赶:DEFAULT_PLACEHOLDER

error_bubbling

类型布尔默认的除非表格是复合

如果真正的,此字段的任何错误都将传递给父字段或表单。例如,如果设置为真正的对于普通字段,该字段的任何错误都将附加到主表单,而不是特定的字段。

error_mapping

类型数组默认的数组()

此选项允许您修改验证错误的目标。

假设您有一个名为matchingCityAndZipCode这将验证城市和邮政编码是否匹配。不幸的是,您的表单中没有“matchingCityAndZipCode”字段,因此Symfony所能做的就是在表单顶部显示错误。ob娱乐下载

使用自定义错误映射,你可以做得更好:将错误映射到城市字段,这样它就会显示在它上面:

1 2 3 4 5 6 7 8
公共函数setDefaultOptions(OptionsResolverInterface解析器解析器->setDefaults (数组“error_mapping”= >数组“matchingCityAndZipCode”= >“城市”,),));}

下面是映射左侧和右侧的规则:

  • 左侧包含属性路径;
  • 如果违反是在类的属性或方法上生成的,则其路径简单propertyName
  • 类的项上生成的违例数组ArrayAccess对象时,属性路径为(indexName)
  • 您可以通过连接它们来构造嵌套的属性路径,用圆点分隔属性。例如:地址[工作].matchingCityAndZipCode
  • 错误映射的左侧也接受一个点,它指的是字段本身。这意味着添加到字段中的任何错误都会添加到给定的嵌套字段中;
  • 右侧仅包含表单中字段的名称。

invalid_message

类型字符串默认的此值无效

这是验证错误消息,如果输入到该字段的数据没有意义(即验证失败),将使用该消息。

例如,如果用户将无意义的字符串输入到时间字段不能转换为实时的,或者如果用户输入字符串(例如。苹果)转换为数字字段。

正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考).

invalid_message_parameters

类型数组默认的数组()

当设置invalid_message选项时,您可能需要在字符串中包含一些变量。这可以通过在该选项中添加占位符并包括该选项中的变量来实现:

1 2 3 4 5
构建器->add (“some_field”“some_type”数组/ /……“invalid_message”= >'您输入的值无效,它应该包含%num%字母'“invalid_message_parameters”= >数组“% num %”= >6)));

标签

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

设置呈现字段时将使用的标签。设置为false将屏蔽标签。标签也可以直接在模板内设置:

  • 嫩枝
  • PHP
1
{{form_label(form.name, '你的名字')}}

label_attr

类型数组默认的数组()

属性的HTML属性<标识>元素,它将在呈现字段的标签时使用。它是一个以HTML属性为键的关联数组。这些属性也可以直接在模板中设置:

  • 嫩枝
  • PHP
1 2 3
{{form_label(form.name, '您的名字',{' label_attr': {'class': 'CUSTOM_LABEL_CLASS'}})}}

映射

类型布尔默认的真正的

如果希望在读取或写入对象时忽略该字段,则可以设置映射选项

read_only

类型布尔默认的

如果此选项为true,则该字段将使用只读的属性,使字段不可编辑。

要求

类型布尔默认的真正的

如果为,则HTML5所需属性将被渲染。相应的标签还会渲染一个要求类。

这是肤浅的,独立于验证。如果您让Symfony猜测您的字段类型,ob娱乐下载那么这个选项的值将从您的验证信息中猜测出来。

请注意

必选选项还影响如何处理每个字段的空数据。有关详细信息,请参见empty_data选择。

表单变量

变量 类型 使用
money_pattern 字符串 用于显示货币(包括货币)的格式。
此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。