HiddenType领域
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 5.0,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
HiddenType领域
隐藏类型表示隐藏的输入字段。
呈现为 | 输入 隐藏的 场 |
覆盖选项 | |
继承的选项 | |
父类型 | FormType |
类 | HiddenType |
提示
这个表单类型定义和继承的完整选项列表可以在你的应用程序中运行这个命令:
1 2
将'FooType'替换为你的表单类型的类名$php bin/console debug:form FooType . php
继承的选项
方法继承了这些选项FormType:
attr
类型:数组
默认的:[]
属性,可以向HTML字段表示形式添加额外属性attr
选择。它是一个以HTML属性为键的关联数组。当你需要为某个小部件设置自定义类时,这可能很有用:
1 2 3
$构建器->add (“身体”, TextareaType::类,“attr”= > [“类”= >“tinymce”)));
另请参阅
使用row_attr
属性中添加这些属性表单类型行元素。
数据
类型:混合
默认的:默认为底层结构的字段。
当你创建一个表单时,每个字段最初都会显示表单域数据的对应属性的值(例如,如果你将一个对象绑定到表单)。如果你想覆盖表单或单个字段的初始值,你可以在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_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”= > [“。”= >“城市”,],]);
property_path
类型:PropertyPathInterface | |空字符串
默认的:零
默认情况下(当此选项的值为零
)表单字段读取和写入表单域对象中具有相同名称的属性。的property_path
选项允许您定义字段读取和写入的属性。此选项的值可以是任何值有效的PropertyAccess语法.