字段类型

编辑本页

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

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

字段类型

百分比Type呈现输入文本字段,专门处理百分比数据。如果您的百分比数据存储为十进制(例如。.95),您可以开箱即用地使用此字段。如果您将数据存储为数字(例如:95),则应设置类型选项整数

这个字段增加了一个百分号。输入框后。

选项

类型

类型:字符串默认的:分数

这将控制数据如何存储在对象上。例如,对应于“55%”的百分比可能存储为5555在你的物体上。这两个“类型”处理以下两种情况:

  • 分数如果您的数据存储为十进制(例如。55),使用此类型。数据将乘以One hundred.在显示给用户之前(例如:55)。提交的数据将被One hundred.,以便存储十进制值(55);
  • 整数如果您的数据存储为整数(例如55),则使用此选项。原始值(55)显示给用户并存储在对象上。注意,这只适用于整数值。

精度

类型:整数默认的:0

默认情况下,输入数字是四舍五入的。要允许出现更多的小数点后数位,请使用此选项。

继承的选项

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

要求

类型:布尔默认的:真正的

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

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

标签

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

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

1
{{form_label(form.name, '你的名字')}}

read_only

2.1

read_only选项在2.1中被更改为渲染为只读的HTML属性。在此之前,它呈现为禁用属性。使用禁用选项,如果您需要旧的行为。

类型:布尔默认的:

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

禁用

2.1

禁用选项是2.1版的新功能

类型:布尔默认的:

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

error_bubbling

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

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

2.1

error_mapping选项是Symfony 2.1的新功ob娱乐下载能。

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)));

映射

类型:布尔

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

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