跳到主内容

注册项目表

在应用程序配置页面上,使用注册项表来定义哪些字段显示在注册页面上。添加、删除或重新排序项目以自定义表单。

注册项目表

:::提示 通过Casdoor SDK创建的应用程序会获得默认注册项(ID、用户名、显示名称、密码、确认密码、电子邮件、电话、协议)。你可以根据需要进行调整。 :::

列引用​

列值描述
名称—注册项的名称。
可见True / False在注册页面上显示或隐藏。
必填True / False该字段是否为必填。
提示True / False如果用户将其留空,是否提示用户。
正则表达式—用于客户端验证的可选正则表达式。
标签—对于以文本开头的项目,对该字段使用 HTML;否则替换项目标签。
自定义 CSS—此注册项的CSS。
规则规则项目自定义此项目的规则(请参阅下表)。
操作—向上移动、向下移动或删除。

支持规则的项:ID、Display name、Email、Agreement、Languages。

项目规则描述
IDRandom / Incremental用户ID生成:随机或递增。
显示名称无 / 真实姓名 / 名,姓如何显示显示名称;名、姓分别显示名和姓。
电子邮件正常 / 无需验证正常= 需要邮箱验证;无需验证= 跳过验证。
协议无 / 登录 / 登录(默认为真)使用条款:无、需确认或默认已确认。
语言None / Label在注册页上添加语言选择器。 None = 单独显示选择器;Label = 带文字标签显示。

:::注意 示例:要显示一个无需验证的电子邮件字段,请添加“电子邮件注册”项目,并将其规则设置为无验证。 :::

备注

Tag 注册项会添加一个下拉框,让用户在注册时自己选择标签。它默认隐藏,设为 Visible 才会显示。选项优先取该项自己的 Options,没有设置时取应用的 Tags。用户在这里选择的标签优先于应用的 Default tag;只有用户没有选择时,才会使用默认标签。

注册项表

注册项目表

:::注意 如果组织启用了“使用电子邮件作为用户名”,且注册项中隐藏了用户名字段,则用户的电子邮件将用作其用户名。 :::

字段验证​

在提交前使用正则表达式列来验证客户端输入:

  1. 在注册项上设置正则表达式(例如:用户名、显示名称或自定义字段)。
  2. 输入一个模式(例如:^[a-zA-Z0-9_]+$用于字母数字用户名)。
  3. 当输入不匹配时,用户会看到错误。

适用于标准字段(用户名、显示名称、名、姓、所属单位)和自定义字段。