EntityType领域
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 3.3,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
EntityType领域
一个特殊的ChoiceType
字段,用于从Doctrine实体加载选项。例如,如果你有一个类别
实体,您可以使用此字段显示选择
场的全部,或部分类别
对象。
呈现为 | 可以是各种标签(看到了吗选择类型字段(选择下拉列表,单选按钮和复选框)) |
选项 | |
覆盖选项 | |
继承的选项 | 从ChoiceType: -choice_attr-choice_translation_domain-扩大-group_by-多个-占位符-preferred_choices-translation_domain从FormType: -数据-禁用-empty_data-error_bubbling-error_mapping-标签-label_attr-label_format-映射-要求 |
父类型 | ChoiceType |
类 | EntityType |
基本用法
的实体
Type只有一个必选选项:实体应该在选择字段中列出:
12 3 4 5 6 7 8 9 10 11 12 13 14
使用ob娱乐下载\桥\学说\形式\类型\EntityType;/ /……$构建器->add (“用户”, EntityType::类,数组(//从该实体查询选项“类”= >“AppBundle:用户”,//使用该用户。使用rname property as the visible option string“choice_label”= >“用户名”,//用于渲染选择框、复选框或单选// 'multiple' => true,// 'expanded' => true,));
这将创建一个选择
下拉菜单包含所有的用户
数据库中的对象。若要显示单选按钮或复选框,请更改多个而且扩大选项。
使用实体的自定义查询
如果你想创建一个自定义查询,以便在获取实体时使用(例如,你只想返回一些实体,或者需要对它们排序),请使用query_builder选择:
12 3 4 5 6 7 8 9 10 11 12
使用学说\ORM\EntityRepository;使用ob娱乐下载\桥\学说\形式\类型\EntityType;/ /……$构建器->add (“用户”, EntityType::类,数组(“类”= >“AppBundle:用户”,“query_builder”= >函数(EntityRepository$呃){返回$呃->createQueryBuilder (“u”)->orderBy (“u.username”,“ASC”);},“choice_label”= >“用户名”));
使用选择
如果您已经有了希望包含在choice元素中的实体的确切集合,只需将它们通过选择
关键。
例如,如果你有一个美元集团
变量(可能作为表单选项传递到表单中)和getuser ()
的集合。用户
实体,然后您可以提供选择
选项直接:
1 2 3 4 5 6 7
使用ob娱乐下载\桥\学说\形式\类型\EntityType;/ /……$构建器->add (“用户”, EntityType::类,数组(“类”= >“AppBundle:用户”,“选择”= >$集团->getuser ()));
选择标签、复选框或单选按钮
该字段可以呈现为几个不同的HTML字段之一,这取决于扩大
而且多个
选项:
元素类型 | 扩大 | 多个 |
---|---|---|
选择标记 | 假 |
假 |
选择标签(使用多个 属性) |
假 |
真正的 |
单选按钮 | 真正的 |
假 |
复选框 | 真正的 |
真正的 |
场的选择
choice_label
类型:字符串
,可调用的
或PropertyPath
这是用于在HTML元素中以文本形式显示实体的属性:
1 2 3 4 5 6 7
使用ob娱乐下载\桥\学说\形式\类型\EntityType;/ /……$构建器->add (“类别”, EntityType::类,数组(“类”= >“AppBundle:类别”,“choice_label”= >“displayName的”));
如果为空,则实体对象将被转换为字符串,因此必须有__toString ()
方法。你也可以通过一个回调函数来进行更多的控制:
1 2 3 4 5 6 7 8 9
使用ob娱乐下载\桥\学说\形式\类型\EntityType;/ /……$构建器->add (“类别”, EntityType::类,数组(“类”= >“AppBundle:类别”,“choice_label”= >函数($类别){返回$类别->getDisplayName ();}));
针对列表中的每个实体调用该方法,并将其传递给函数。要了解更多细节,请参阅mainchoice_label欧宝官网下载app文档。
请注意
在传递字符串时,choice_label
Option是一个属性路径。因此,您可以使用PropertyAccessor组件
例如,如果translations属性实际上是一个对象的关联数组,每个对象都有一个name属性,那么你可以这样做:
1 2 3 4 5 6 7
使用ob娱乐下载\桥\学说\形式\类型\EntityType;/ /……$构建器->add (“类型”, EntityType::类,数组(“类”= >“MyBundle:流派”,“choice_label”= >“翻译(en) . name”));
query_builder
类型:学说\ ORM \ QueryBuilder
或者一个可调用的
默认的:零
允许您为您的选择创建自定义查询。看到EntityType领域举个例子。
该选项的值可以是aQueryBuilder
对象,一个可调用的或零
(这将加载所有实体)。在使用可调用对象时,将传递EntityRepository
作为实体的唯一参数,并应返回QueryBuilder
.返回零
将导致加载所有实体。
谨慎
类中使用的实体从
的条款query_builder选项将始终针对您使用表单的属性指定的类进行验证类选择。如果您返回另一个实体,而不是在从
子句(例如,如果从连接的表中返回一个实体),则会破坏验证。
覆盖选项
choice_name
类型:可调用的
或字符串
默认的:零
控制选择的内部字段名。你通常不关心这个,但在一些高级情况下,你可能会关心。例如,这个“name”成为模板中选择视图的索引。
这可以是一个可调用路径或属性路径。看到choice_label类似用法。如果零
时,则使用递增整数作为名称。
在EntityType
,默认为id
实体的,如果它可以读取。否则,它将退回到使用自动递增的整数。
choice_value
类型:可调用的
或字符串
默认的:零
为每个选项返回字符串“value”,在所有选项中必须是唯一的。这用于价值
属性,并在POST/PUT请求中提交。您通常不需要担心这一点,但在处理API请求时可能很方便(因为您可以配置将在API请求中发送的值)。
这可以是一个可调用路径或属性路径。如果零
,则使用递增的整数作为值。
如果传递一个可调用对象,它将接收一个参数:选择本身。当使用EntityType领域,参数将是每个选项或的实体对象零
在某些情况下,你需要处理:
1 2 3
“choice_value”= >函数(MyOptionEntity$实体= null){返回$实体?$实体->getId ():”;},
谨慎
在Syob娱乐下载mfony 2.7中,有一个小的向后兼容性中断价值
options属性。这不是问题,除非您依赖于JavaScript中的选项值。看到问题# 14825获取详细信息。
在EntityType
时,此选项将被覆盖以使用id
默认情况下。当id
使用时,Doctrine仅查询实际提交的id的对象。
继承的选项
方法继承了这些选项ChoiceType:
choice_attr
类型:数组
,可调用的
或字符串
默认的:数组()
使用它可以为每个选项添加额外的HTML属性。这可以是一个属性数组(如果每个选项的属性都相同),一个可调用对象或一个属性路径(就像choice_label).
的键值选择
Array必须用作键:
12 3 4 5 6 7 8 9 10 11 12 13 14
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“参加”, ChoiceType::类,数组(“选择”= >数组(“是的”= >真正的,“不”= >假,“也许”= >零),“choice_attr”= >函数($瓦尔,$关键,$指数){//添加一个类,如attending_yes, attending_no等返回[“类”= >“attending_”.strtolower ($关键));}));
choice_translation_domain
类型:字符串
,布尔
或零
此选项决定是否应该翻译所选值以及在哪个翻译域中翻译。
的值choice_translation_domain
选项可以是真正的
(重用当前翻译域),假
(禁用翻译),零
(使用父翻译域或默认域)或表示要使用的确切翻译域的字符串。
group_by
类型:数组
,可调用的
或字符串
默认的:零
您可以简单地通过传递多维数组来“分组”选择中的选项选择
.看到分组选项部分。
的group_by
Option是分组选择的另一种方式,它给了你更多的灵活性。
举个例子:
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“publishAt”, ChoiceType::类,数组(“选择”= >数组(“现在”= >新\ DateTime (“现在”),“明天”= >新\ DateTime (“+ 1天”),“1周”= >新\ DateTime (“+ 1周”),“一个月”= >新\ DateTime (“+ 1月”)),“group_by”= >函数($瓦尔,$关键,$指数){如果($瓦尔< =新\ DateTime (+ 3天的)) {返回“很快”;}其他的{返回“后来”;}},));
这将3天以内的日期分组为“Soon”,其他所有日期分组为“Later”:
如果你回来零
,该选项将不会被分组。您还可以传递一个字符串“属性路径”,它将被调用来获取组。看到choice_label属性路径的详细信息。
多个
类型:布尔
默认的:假
如果为真,用户将能够选择多个选项(而不是只选择一个选项)。的值扩大
选项,如果为真,将呈现一个选择标签或复选框,如果为假,将呈现一个选择标签或单选按钮。返回值将是一个数组。
请注意
如果您正在使用Doctrine实体的集合,那么阅读文档将会很有帮助欧宝官网下载appCollectionType领域也此外,还有一个完整的例子如何嵌入一个集合的形式篇文章。
占位符
类型:字符串
或布尔
这个选项决定了一个特殊的“空”选项(例如:“选择一个选项”)将出现在选择小部件的顶部。此选项仅适用于多个
选项设置为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
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“语言”, ChoiceType::类,数组(“选择”= >数组(“英语”= >“en”,“西班牙”= >“西文”,“博克”= >“布偶”,“海盗”= >“加勒比海盗”),“preferred_choices”= >数组(“布偶”,“加勒比海盗”)));
该选项也可以是回调函数,以提供更大的灵活性。如果你的值是对象,这可能特别有用:
12 3 4 5 6 7 8 9 10 11 12 13 14 15
使用ob娱乐下载\组件\形式\扩展\核心\类型\ChoiceType;/ /……$构建器->add (“publishAt”, ChoiceType::类,数组(“选择”= >数组(“现在”= >新\ DateTime (“现在”),“明天”= >新\ DateTime (“+ 1天”),“1周”= >新\ DateTime (“+ 1周”),“一个月”= >新\ DateTime (“+ 1月”)),“preferred_choices”= >函数($瓦尔,$关键){//首选3天内的选项返回$瓦尔< =新\ DateTime (+ 3天的);}));
这将“偏爱”“现在”和“明天”的选择:
最后,如果您的值是对象,您还可以在对象上指定属性路径字符串,该字符串将返回true或false。
类时,首选选项才有意义选择
元素(即。扩大
假)。首选选项和普通选项在视觉上由一组虚线分隔开。-------------------
).这可以在呈现字段时自定义:
- 嫩枝
- PHP
1
{{form_widget(形式。publishAt, {'separator': '====='})}}
请注意
该选项需要一个实体对象数组(这实际上与ChoiceType
字段,它需要首选的“值”数组)。
translation_domain
类型:字符串
默认的:消息
以防choice_translation_domain设置为真正的
或零
,这将配置将用于此字段呈现的任何标签或选项的确切翻译域
方法继承了这些选项形式类型:
数据
类型:混合
默认的:默认为底层结构的字段。
当你创建一个表单时,每个字段最初都会显示表单域数据的对应属性的值(例如,如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值,你可以在data选项中设置它:
1 2 3 4 5 6
使用ob娱乐下载\组件\形式\扩展\核心\类型\HiddenType;/ /……$构建器->add (“令牌”, HiddenType::类,数组(“数据”= >“六边形abcdef”));
谨慎
的数据
选项总是在呈现时覆盖从域数据(对象)获取的值。这意味着当表单编辑一个已经持久化的对象时,对象值也会被覆盖,从而导致在表单提交时失去它的持久化值。
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
这个选项决定字段的值返回当提交的值为空(或缺失)时。如果在视图中呈现表单时没有提供初始值,则不设置初始值。
这意味着它可以帮助您处理带有空白字段的表单提交。例如,如果你想要的名字
要显式设置为的字段John Doe
当没有选择值时,你可以这样做:
1 2 3 4
$构建器->add (“名字”,零,数组(“要求”= >假,“empty_data”= >“John Doe”));
这仍然会呈现一个空文本框,但在提交John Doe
值将被设置。使用数据
或占位符
选项,在呈现的表单中显示此初始值。
如果表单是复合的,则可以设置empty_data
作为数组、对象或闭包。看到如何为窗体类配置空数据文章中有关于这些选项的详细信息。
请注意
如果你想设置empty_data
整个表单类的选项,请参见如何为窗体类配置空数据篇文章。
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”= >数组(“。”= >“城市”,),));
标签
类型:字符串
默认的:从字段名“猜测”标签
设置呈现字段时将使用的标签。设置为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
类型:字符串
默认的:零
配置用作字段标签的字符串,以防标签
选项未设置。这在使用时很有用关键字翻译信息.
如果您使用关键字翻译消息作为标签,您通常会对同一个标签有多个关键字消息(例如。profile_address_street
,invoice_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
选项在表单主题中求值。确保更新你的模板以防你定制表单主题.
要求
类型:布尔
默认的:真正的
如果为,则HTML5所需属性将被渲染。相应的标签
还会渲染一个要求
类。
这是肤浅的,独立于验证。如果您让Symfony猜测您的字段类型,ob娱乐下载那么这个选项的值将从您的验证信息中猜测出来。
请注意
必选选项还影响如何处理每个字段的空数据。有关详细信息,请参见empty_data选择。