LocaleType领域

编辑本页

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

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

LocaleType领域

LocaleType的子集ChoiceType这允许用户从大量地区(语言+国家)列表中进行选择。作为额外的好处,区域设置名称将以用户的语言显示。

每个地区的“值”是两个字母ISO 639 - 1语言代码(如。fr),或语言代码后跟下划线(_),然后ISO 3166-1 alpha-2国家代码(如。fr_FR法国/法国)。

请注意

您的用户的地区是猜测使用地区:getDefault ()

不像ChoiceType,则不需要指定a选择选项作为字段类型自动使用大量区域设置列表。你可以手动指定这些选项,但是您应该使用ChoiceType直接。

覆盖选项

选择

默认的ob娱乐下载Symfony \组件\ Intl \ Intl: getLocaleBundle()——> getLocaleNames ()

选项选项默认适用于所有地区。它使用默认区域设置来指定语言。

继承的选项

方法继承了这些选项ChoiceType

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”= >数组“。”= >“城市”,),));

扩大

类型布尔默认的

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

多个

类型布尔默认的

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

占位符

2.3

从Symfoob娱乐下载ny 2.3开始,如果扩大选项设置为true。

类型字符串布尔

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

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

    1 2 3 4 5 6
    使用ob娱乐下载组件形式扩展核心类型ChoiceType/ /……构建器->add (“州”, ChoiceType::类,数组“占位符”= >“选择一个选项”));
  • 确保没有“空”值选项显示:

    1 2 3 4 5 6
    使用ob娱乐下载组件形式扩展核心类型ChoiceType/ /……构建器->add (“州”, ChoiceType::类,数组“占位符”= >));

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

1 2 3 4 5 6 7
使用ob娱乐下载组件形式扩展核心类型ChoiceType/ /……//添加一个空白(无文本)选项构建器->add (“州”, ChoiceType::类,数组“要求”= >));

preferred_choices

类型数组可调用的字符串默认的数组()

此选项允许您将某些选项移动到列表的顶部,并在它们与其他选项之间使用可视分隔符。如果你有一种语言,你可以在上面列出最流行的语言,比如Bork Bork和Pirate:

12 3 4 5 6 7 8 9 10 11 12 13
使用ob娱乐下载组件形式扩展核心类型ChoiceType/ /……构建器->add (“语言”, ChoiceType::类,数组“选择”= >数组“英语”= >“en”“西班牙”= >“西文”“博克”= >“布偶”“海盗”= >“加勒比海盗”),“choices_as_values”= >真正的“preferred_choices”= >数组“布偶”“加勒比海盗”)));

2.7

设置可调用路径或属性路径是在Symfony 2.7中引入的。ob娱乐下载

该选项也可以是回调函数,以提供更大的灵活性。如果你的值是对象,这可能特别有用:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16
使用ob娱乐下载组件形式扩展核心类型ChoiceType/ /……构建器->add (“publishAt”, ChoiceType::类,数组“选择”= >数组“现在”= >\ DateTime (“现在”),“明天”= >\ DateTime (“+ 1天”),“1周”= >\ DateTime (“+ 1周”),“一个月”= >\ DateTime (“+ 1月”),),“choices_as_values”= >真正的“preferred_choices”= >函数价值关键//首选3天内的选项返回价值< =\ DateTime (+ 3天的);}));

这将“偏爱”“现在”和“明天”的选择:

最后,如果您的值是对象,您还可以在对象上指定属性路径字符串,该字符串将返回true或false。

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

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

修剪

类型布尔默认的

默认情况下禁用微调,因为所选值必须与给定的选择值完全匹配(并且它们可以包含空白)。

方法继承了这些选项FormType

数据

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

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

1 2 3 4 5 6
使用ob娱乐下载组件形式扩展核心类型HiddenType/ /……构建器->add (“令牌”, HiddenType::类,数组“数据”= >“六边形abcdef”));

谨慎

数据选项总是在呈现时覆盖从域数据(对象)获取的值。这意味着当表单编辑一个已经持久化的对象时,对象值也会被覆盖,从而导致在表单提交时失去它的持久化值。

禁用

类型布尔默认的

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

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

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

  • 如果多个而且扩大,然后(空字符串);
  • 否则数组()(空数组)。

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

标签

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

设置呈现字段时将使用的标签。设置为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'}})}}

label_format

2.6

label_format选项是在Symfony 2.6中引入的。ob娱乐下载

类型字符串默认的

配置用作字段标签的字符串,以防标签选项未设置。这在使用时很有用关键字翻译信息

如果您使用关键字翻译消息作为标签,您通常会对同一个标签有多个关键字消息(例如。profile_address_streetinvoice_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选项在表单主题中求值。确保更新你的模板以防你定制表单主题

映射

类型布尔默认的真正的

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

read_only

谨慎

read_only选项已弃用,将在3.0移除。相反,使用attr选项,将其设置为带有只读的关键。

类型布尔默认的

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

要求

类型布尔默认的真正的

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

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

请注意

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

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