占位符

类型：字符串|数组

如果小部件选项设置为选择，则该字段将表示为一系列的选择盒子。当占位符值为字符串时，它将被用作空白值在所有选择框中:

1 2 3 4 5

使用ob娱乐下载＼组件＼形式＼扩展＼核心＼类型＼WeekType；＄构建器->add (“startWeek”, WeekType：：类,“占位符”= >“选择一个值”]);

或者，你可以使用一个数组为年和周字段配置不同的占位符值:

1 2 3 4 5 6 7 8

使用ob娱乐下载＼组件＼形式＼扩展＼核心＼类型＼WeekType；＄构建器->add (“startDateTime”, WeekType：：类,“占位符”= > [“年”= >“年”，“周”= >“周”，]，]);

html5

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

如果设置为真正的(默认值)，它将使用HTML5类型(日期，时间或datetime-local)来呈现字段。当设置为假，它将使用文本类型。

当您想要使用自定义JavaScript datepicker(通常需要文本类型而不是HTML5类型)时，这很有用。

输入

类型：字符串默认的：数组

的格式输入数据-即日期存储在基础对象上的格式。有效值为:

• 字符串(如。“2011 - w17”）
• 数组(如。(2011年,17)）

从表单返回的值也将被规范化为这种格式。

小部件

类型：字符串默认的：选择

该字段应呈现的基本方式。可以是以下之一:

• 选择:呈现两个选择输入;
• 文本:呈现类型的两个字段输入文本(年、周);
• single_text:呈现一个类型的输入周．

年

类型：数组默认的:从当年的前十年到当年的后十年

年份字段类型可用的年份列表。时，此选项才相关小部件选项设置为选择．

周

类型：数组默认的: 1 ~ 53

星期字段类型可用的星期列表。时，此选项才相关小部件选项设置为选择．

复合

类型：布尔默认的：假

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

empty_data

类型：混合

该选项的实际默认值取决于其他字段选项:

• 如果小部件是single_text,然后”(空字符串);
• 否则［］(空数组)。

这个选项决定字段的值返回当提交的值为空(或缺失)时。如果在视图中呈现表单时没有提供初始值，则不设置初始值。

这意味着它可以帮助您处理带有空白字段的表单提交。例如，如果你想要的名字要显式设置为的字段John Doe当没有选择值时，你可以这样做:

1 2 3 4

＄构建器->add (“名字”，零, (“要求”= >假，“empty_data”= >“John Doe”]);

这仍然会呈现一个空文本框，但在提交John Doe值将被设置。使用数据或占位符选项，在呈现的表单中显示此初始值。

如果表单是复合的，则可以设置empty_data作为数组、对象或闭包。看到如何为窗体类配置空数据文章中有关于这些选项的详细信息。

error_bubbling

默认的：假

invalid_message

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

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

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

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

attr

类型：数组默认的：［］

属性，可以向HTML字段表示形式添加额外属性attr选择。它是一个以HTML属性为键的关联数组。当你需要为某个小部件设置自定义类时，这可能很有用:

1 2 3

＄构建器->add (“身体”, TextareaType：：类,“attr”= > [“类”= >“tinymce”)));

数据

类型：混合默认的:默认为底层结构的字段。

当你创建一个表单时，每个字段最初都会显示表单域数据的对应属性的值(例如，如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值，你可以在data选项中设置它:

1 2 3 4 5 6

使用ob娱乐下载＼组件＼形式＼扩展＼核心＼类型＼HiddenType；/ /……＄构建器->add (“令牌”, HiddenType：：类,“数据”= >“六边形abcdef”]);

禁用

类型：布尔默认的：假

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

帮助

类型：字符串或TranslatableInterface默认的:零

允许您为表单字段定义帮助消息，默认情况下呈现在字段下面:

12 3 4 5 6 7 8 9 10 11 12 13

使用ob娱乐下载＼组件＼翻译＼TranslatableMessage；＄构建器->add (“zipCode”，零, (“帮助”= >“您信用卡账单地址的邮政编码。”,)/ /……->add (“状态”，零, (“帮助”= >新TranslatableMessage (“order.status”, (“% order_id %”= >＄订单->getId ()),“存储”)，]);

help_attr

类型：数组默认的：［］

为用于显示表单字段的帮助消息的元素设置HTML属性。它的值是一个以HTML属性名作为键的关联数组。这些属性也可以在模板中设置:

1 2 3

{{form_help (form.name,“你的名字”,{help_attr:{‘类’:‘CUSTOM_LABEL_CLASS}})}}

help_html

类型：布尔默认的：假

的内容默认为帮助选项在模板中呈现之前进行转义。将此选项设置为真正的不转义它们，这在帮助包含HTML元素时很有用。

inherit_data

类型：布尔默认的：假

此选项决定表单是否从其父表单继承数据。如果您有一组跨多个表单重复的字段，这可能很有用。看到如何使用"inherit_data"减少代码重复．

invalid_message_parameters

类型：数组默认的：［］

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

1 2 3 4 5

＄构建器->add (“someField”, SomeFormType：：类,/ /……“invalid_message”= >'您输入的值无效，它应该包含%num%字母'，“invalid_message_parameters”= > [“% num %”= >6)));

映射

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

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

row_attr

类型：数组默认的：［］

元素中添加的HTML属性的关联数组，用于呈现表单类型行：

1 2 3

＄构建器->add (“身体”, TextareaType：：类,“row_attr”= > [“类”= >“文本编辑器”，“id”= >'...')));