字段类型

编辑本页

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

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

字段类型

时区类型的子集ChoiceType这允许用户从所有可能的时区中进行选择。

每个时区的“值”是完整的时区名称,例如美国/芝加哥欧洲/伊斯坦布尔

不像选择类型,您不需要指定选择choice_list选项作为字段类型自动使用大量区域设置列表。你可以手动指定这些选项中的任何一个,但然后应该使用选择直接输入。

呈现为 可以是各种标签(看到了吗选择字段类型
覆盖选项
继承的选项
父类型 选择
TimezoneType

覆盖选项

choice_list

默认的TimezoneChoiceList

Timezone类型将choice_list默认为返回的所有时区DateTimeZone时区:listIdentifiers (),按大洲划分。

继承的选项

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

多个

类型布尔默认的

如果为真,用户将能够选择多个选项(而不是只选择一个选项)。的值扩大选项,如果为真,将呈现一个选择标签或复选框,如果为假,将呈现一个选择标签或单选按钮。返回值将是一个数组。

扩大

类型布尔默认的

如果设置为true,则将呈现单选按钮或复选框(取决于多个值)。如果为false,将呈现一个select元素。

preferred_choices

类型数组默认的数组()

如果指定了此选项,则所有选项的子集将被移动到选择菜单的顶部。下面将“Baz”选项移动到顶部,并在它和其他选项之间使用可视分隔符:

1 2 3 4
构建器->add (“foo_choices”“选择”数组“选择”= >数组“foo”= >“Foo”“酒吧”= >“酒吧”“记者”= >“记者”),“preferred_choices”= >数组“记者”)));

注意,首选选项仅在呈现为对象时才有意义选择元素(即。扩大是假的)。首选选项和普通选项在视觉上由一组虚线分隔开。-------------------).这可以在呈现字段时自定义:

  • 嫩枝
  • PHP
1
{{form_widget(形式。Foo_choices, {'separator': '====='})}}

empty_value

类型字符串布尔

这个选项决定了一个特殊的“空”选项(例如:“选择一个选项”)将出现在选择小部件的顶部。此选项仅适用于扩大而且多个选项设置为false。

  • 添加一个空值,文本为“Choose an option”:

    1 2 3
    构建器->add (“州”“选择”数组“empty_value”= >“选择一个选项”));
  • 确保没有“空”值选项显示:

    1 2 3
    构建器->add (“州”“选择”数组“empty_value”= >));

如果你离开empty_value选项未设置时,则当且仅当要求选项为false:

1 2 3 4
//添加一个空白(无文本)选项构建器->add (“州”“选择”数组“要求”= >));

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

要求

类型布尔默认的真正的

如果为,则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
  • 错误映射的左侧也接受一个点,它指的是字段本身。这意味着添加到字段中的任何错误都会添加到给定的嵌套字段中。
  • 右侧仅包含表单中字段的名称。

映射

类型布尔

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

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