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

:::提示 通过Casdoor SDK创建的应用程序会获得默认注册项(ID、用户名、显示名称、密码、确认密码、电子邮件、电话、协议)。 你可以根据需要进行调整。 :::
列引用
| 列 | 值 | 描述 |
|---|---|---|
| 名称 | — | 注册项的名称。 |
| 可见 | True / False | 在注册页面上显示或隐藏。 |
| 必填 | True / False | 该字段是否为必填。 |
| 提示 | True / False | 如果用户将其留空,是否提示用户。 |
| 正则表达式 | — | 用于客户端验证的可选正则表达式。 |
| 标签 | — | 对于以文本开头的项目,对该字段使用 HTML;否则替换项目标签。 |
| 自定义 CSS | — | 此注册项的CSS。 |
| 规则 | 规则项目 | 自定义此项目的规则(请参阅下表)。 |
| 操作 | — | 向上移动、向下移动或删除。 |
Items that support rules: ID, Display name, Email, Agreement, Languages.
| 项目 | 规则 | 描述 |
|---|---|---|
| ID | Random / Incremental | 用户ID生成:随机或递增。 |
| 显示名称 | 无 / 真实姓名 / 名,姓 | 如何显示显示名称;名、姓分别显示名和姓。 |
| 电子邮件 | 正常 / 无需验证 | 正常= 需要邮箱验证;无需验证= 跳过验证。 |
| 协议 | 无 / 登录 / 登录(默认为真) | 使用条款:无、需确认或默认已确认。 |
| Languages | None / Label | Adds a language selector to the sign-up page. None = show the selector on its own; Label = show it with a text label. |
:::注意 示例:要显示一个无需验证的电子邮件字段,请添加“电子邮件注册”项目,并将其规则设置为无验证。 :::
The Tag signup item adds a drop-down that lets the user pick their own tag during registration. It is hidden by default; make it Visible to show it. The options come from the item's own Options if set, otherwise from the application's Tags. A tag the user selects here takes priority over the application's Default tag, which is only applied when the user does not choose one.


:::注意 如果组织启用了“使用电子邮件作为用户名”,且注册项中隐藏了用户名字段,则用户的电子邮件将用作其用户名。 :::
字段验证
在提交前使用正则表达式列来验证客户端输入:
- 在注册项上设置正则表达式(例如:用户名、显示名称或自定义字段)。
- 输入一个模式(例如:
^[a-zA-Z0-9_]+$用于字母数字用户名)。 - 当输入不匹配时,用户会看到错误。
适用于标准字段(用户名、显示名称、名、姓、所属单位)和自定义字段。