重复字段类型
编辑本页警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 2.2,现已不再维护。
读本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。
重复字段类型
这是一个特殊的字段“group”,它创建两个相同的字段,它们的值必须匹配(否则将抛出验证错误)。最常见的使用是当你需要用户重复他们的密码或电子邮件来验证准确性。
呈现为 | 输入文本 字段,但请参见类型选项 |
选项 | |
覆盖选项 | |
继承的选项 | |
父类型 | 形式 |
类 | RepeatedType |
示例使用
1 2 3 4 5 6 7 8
$构建器->add (“密码”,“重复”,数组(“类型”= >“密码”,“invalid_message”= >密码字段必须匹配。,“选项”= >数组(“attr”= >数组(“类”= >“密码字段”)),“要求”= >真正的,“first_options”= >数组(“标签”= >“密码”),“second_options”= >数组(“标签”= >“重复密码”)));
成功提交表单后,输入两个“password”字段的值将成为密码
关键。换句话说,即使实际上呈现了两个字段,表单的最终数据也只是您需要的单个值(通常是字符串)。
最重要的选择是类型
,它可以是任何字段类型,并确定两个底层字段的实际类型。的选项
选项传递给每个单独的字段,在本例中,这意味着密码
类型可以在此数组中传递。
呈现
重复字段类型实际上是两个底层字段,您可以一次性呈现它们,也可以单独呈现它们。要一次性渲染所有内容,可以使用如下代码:
- 嫩枝
- PHP
1
{{form_row(form.password)}}
要单独渲染每个字段,使用如下代码:
- 嫩枝
- PHP
1 2 3
{# .first和.second可能在您的使用中有所不同-请参阅下面的说明#}{{form_row(form.password.first)}}{{form_row(form.password.second)}}
请注意
的名字第一个
而且第二个
是两个子字段的默认名称。但是,这些名称可以通过first_name而且second_name选项。如果您设置了这些选项,那么使用这些值而不是第一个
而且第二个
当渲染。
验证
的关键特征之一重复
字段是内部验证(您不需要做任何设置),它强制两个字段具有匹配的值。如果两个字段不匹配,将向用户显示一个错误。
的invalid_message
用于自定义当两个字段不匹配时将显示的错误。
场的选择
选项
类型:数组
默认的:数组()
这个选项数组将被传递给两个底层字段。换句话说,这些是自定义各个字段类型的选项。例如,如果类型
选项设置为密码
,此数组可能包含选项always_empty
或要求
属性所支持的两个选项密码
字段类型。
first_options
类型:数组
默认的:数组()
2.1
的first_options
选项是Symfony 2.1的新功ob娱乐下载能。
其他选项(将合并到选项
以上)应该通过只有到第一个领域。这对于自定义标签特别有用:
1 2 3 4
$构建器->add (“密码”,“重复”,数组(“first_options”= >数组(“标签”= >“密码”),“second_options”= >数组(“标签”= >“重复密码”)));
second_options
类型:数组
默认的:数组()
2.1
的second_options
选项是Symfony 2.1的新功ob娱乐下载能。
其他选项(将合并到选项
以上)应该通过只有到第二个字段。这对于自定义标签特别有用(参见first_options).
first_name
类型:字符串
默认的:第一个
这是用于第一个字段的实际字段名。属性的键下是可用的,因此这在很大程度上是没有意义的重复
字段本身(例如:密码
).但是,如果您没有指定标签,则该字段名称将用于为您“猜测”标签。
覆盖选项
error_bubbling
默认的:假
继承的选项
方法继承了这些选项形式类型:
invalid_message
类型:字符串
默认的:此值无效
这是验证错误消息,如果输入到该字段的数据没有意义(即验证失败),将使用该消息。
例如,如果用户将无意义的字符串输入到时间字段不能转换为实时的,或者如果用户输入字符串(例如。苹果
)转换为数字字段。
正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考).
invalid_message_parameters
类型:数组
默认的:数组()
当设置invalid_message
选项时,您可能需要在字符串中包含一些变量。这可以通过在该选项中添加占位符并包括该选项中的变量来实现:
1 2 3 4 5
$构建器->add (“some_field”,“some_type”,数组(/ /……“invalid_message”= >'您输入的值无效-它应该包含%num%字母',“invalid_message_parameters”= >数组(“% num %”= >6)));
error_mapping
类型:数组
默认的:空
2.1
的error_mapping
选项是Symfony 2.1的新功ob娱乐下载能。
此选项允许您修改验证错误的目标。
假设您有一个名为matchingCityAndZipCode
这将验证城市和邮政编码是否匹配。不幸的是,您的表单中没有“matchingCityAndZipCode”字段,因此Symfony所能做的就是在表单顶部显示错误。ob娱乐下载
使用自定义错误映射,你可以做得更好:将错误映射到城市字段,这样它就会显示在它上面:
1 2 3 4 5 6 7 8
公共函数setDefaultOptions(OptionsResolverInterface$解析器){$解析器->setDefaults (数组(“error_mapping”= >数组(“matchingCityAndZipCode”= >“城市”,),));}
下面是映射左侧和右侧的规则:
- 左侧包含属性路径。
- 如果冲突是在类的属性或方法上生成的,那么它的路径就是“propertyName”。
- 类的项上生成的违例
数组
或ArrayAccess
对象时,属性路径为(indexName)
. - 您可以通过连接它们来构造嵌套的属性路径,用圆点分隔属性。例如:
地址[工作].matchingCityAndZipCode
- 错误映射的左侧也接受一个点
.
,它指的是字段本身。这意味着添加到字段中的任何错误都会添加到给定的嵌套字段中。 - 右侧仅包含表单中字段的名称。