RepeatedType领域

编辑本页

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

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

RepeatedType领域

这是一个特殊的字段“group”,它创建两个相同的字段,它们的值必须匹配(否则将抛出验证错误)。最常见的使用是当你需要用户重复他们的密码或电子邮件来验证准确性。

呈现为 输入文本字段,但请参见类型选项
父类型 FormType
RepeatedType

提示

这个表单类型定义和继承的完整选项列表可以在你的应用程序中运行这个命令:

1 2
将'FooType'替换为你的表单类型的类名php bin/console debug:form FooType . php

示例使用

12 3 4 5 6 7 8 9 10 11 12
使用ob娱乐下载组件形式扩展核心类型PasswordType使用ob娱乐下载组件形式扩展核心类型RepeatedType/ /……构建器->add (“密码”, RepeatedType::类,“类型”= > PasswordType::类,“invalid_message”= >密码字段必须匹配。“选项”= > [“attr”= > [“类”= >“密码字段”]],“要求”= >真正的“first_options”= > [“标签”= >“密码”),“second_options”= > [“标签”= >“重复密码”)));

成功提交表单后,输入两个“password”字段的值将成为密码关键。换句话说,即使实际上呈现了两个字段,表单的最终数据也只是您需要的单个值(通常是字符串)。

最重要的选择是类型,它可以是任何字段类型,并确定两个底层字段的实际类型。的选项选项传递给每个单独的字段,在本例中,这意味着PasswordType可以在此数组中传递。

呈现

重复字段类型实际上是两个底层字段,您可以一次性呈现它们,也可以单独呈现它们。要一次性渲染所有内容,可以使用如下代码:

1
{{form_row(form.password)}}

要单独渲染每个字段,使用如下代码:

1 2 3
{# .first和.second可能在您的使用中有所不同-请参阅下面的说明#}{{form_row(form.password.first)}}{{form_row(form.password.second)}}

请注意

的名字第一个而且第二个是两个子字段的默认名称。但是,这些名称可以通过first_name而且second_name选项。如果您设置了这些选项,那么使用这些值而不是第一个而且第二个当渲染。

验证

的关键特征之一重复字段是内部验证(您不需要做任何设置),它强制两个字段具有匹配的值。如果两个字段不匹配,将向用户显示一个错误。

invalid_message用于自定义当两个字段不匹配时将显示的错误。

请注意

映射选项总是真正的,以使类型正常工作。

场的选择

first_name

类型字符串默认的第一个

这是用于第一个字段的实际字段名。属性的键下是可用的,因此这在很大程度上是没有意义的RepeatedType字段本身(例如:密码).但是,如果您没有指定标签,则该字段名称将用于为您“猜测”标签。

first_options

类型数组默认的[]

其他选项(将合并到选项下面)应该通过只有到第一个领域。这对于自定义标签特别有用:

1 2 3 4 5 6 7
使用ob娱乐下载组件形式扩展核心类型RepeatedType/ /……构建器->add (“密码”, RepeatedType::类,“first_options”= > [“标签”= >“密码”),“second_options”= > [“标签”= >“重复密码”)));

选项

类型数组默认的[]

这个选项数组将被传递给两个底层字段。换句话说,这些是自定义各个字段类型的选项。例如,如果类型选项设置为密码,此数组可能包含选项always_empty要求属性所支持的两个选项PasswordType字段。

second_name

类型字符串默认的第二个

first_name,但对于第二个字段。

second_options

类型数组默认的[]

其他选项(将合并到选项以上)应该通过只有到第二个字段。这对于自定义标签特别有用(参见first_options).

类型

类型字符串默认的ob娱乐下载\组件\形式\扩展\核心\类型\ TextType

两个底层字段将是该字段类型。例如,传递PasswordType::类将呈现两个密码字段。

覆盖选项

error_bubbling

默认的

继承的选项

方法继承了这些选项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”]);

谨慎

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

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

帮助

类型字符串默认的:零

允许您为表单字段定义帮助消息,默认情况下呈现在字段下面:

1 2 3
构建器->add (“zipCode”, (“帮助”= >“您信用卡账单地址的邮政编码。”]);

help_attr

类型数组默认的[]

为用于显示表单字段的帮助消息的元素设置HTML属性。它的值是一个以HTML属性名作为键的关联数组。这些属性也可以在模板中设置:

1 2 3
{{form_help (form.name,“你的名字”,{help_attr:{‘类’:‘CUSTOM_LABEL_CLASS}})}}

help_html

类型布尔默认的

的内容默认为帮助选项在模板中呈现之前进行转义。将此选项设置为真正的不转义它们,这在帮助包含HTML元素时很有用。

invalid_message

类型字符串默认的此值无效

这是验证错误消息,如果输入到该字段的数据没有意义(即验证失败),将使用该消息。

例如,如果用户将无意义的字符串输入到TimeType字段不能转换为实时的,或者如果用户输入字符串(例如。苹果)转换为数字字段。

正常(业务逻辑)验证(例如在设置字段的最小长度时)应该使用验证消息和验证规则(参考).

invalid_message_parameters

类型数组默认的[]

当设置invalid_message选项时,您可能需要在字符串中包含一些变量。这可以通过在该选项中添加占位符并包括该选项中的变量来实现:

1 2 3 4 5
构建器->add (“someField”, SomeFormType::类,/ /……“invalid_message”= >'您输入的值无效,它应该包含%num%字母'“invalid_message_parameters”= > [“% num %”= >6)));

映射

类型布尔默认的真正的

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

row_attr

类型数组默认的[]

元素中添加的HTML属性的关联数组,用于呈现表单类型行

1 2 3
构建器->add (“身体”, TextareaType::类,“row_attr”= > [“类”= >“文本编辑器”“id”= >'...')));

另请参阅

使用attr属性中添加这些属性表单类型小部件元素。

4.3

row_attr选项是在Symfony 4.3中引入的。ob娱乐下载

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