InitialPage 初始密码
基于 uniboot-ui 的 修改初始密码 整页:背景与 LoginPage、ForgetPage 一致(默认蓝色渐变 + 装饰纹理),左上角展示品牌 Logo,中部 554px 宽白色圆角卡片,顶部信息提示、标题、新密码与确认新密码表单、规则提示与通栏提交按钮,校验规则与 uniboot-web-template 中 usePassword 默认一致。
基础用法
通过 authCode 传入初始密码链接中的校验码(通常由业务从路由解析);onSubmit 中调用修改初始密码接口;finish 事件在校验通过后、onSubmit 调用前触发(与 LoginPage 的 finish 时机一致),便于与自定义逻辑组合。
示例将提交模拟为延时。
You have signed in to BlinkQ. For account security, please change your initial password immediately after first login or password reset.
Change Initial Password
Password length: 8–16 characters
Must include at least two of letters, numbers, and special symbols
Allowed special characters: ~!@#$%^&_
InitialPage 属性
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| fullPage | 是否使用整页布局(含与 LoginPage 一致的背景层) | boolean | true |
| backgroundImage | 背景图 URL | string | '' |
| backgroundColor | 背景色(无背景图时作为底色,并叠加默认纹理) | string | #2F54EB |
| showLanguageSwitch | 是否展示右上角语言切换 | boolean | true |
| getLanguages | 获取语言列表(优先级高于 languages) | function | — |
| languages | 语言列表 | object | [] |
| defaultLanguage | 默认语言 value | string | '' |
| onLanguageChange | 语言切换回调 | function | — |
| pageTitle | 卡片内主标题 | string | 修改初始密码 |
| subTitle | 顶部信息提示;不传则按 productTitle 生成默认文案 | string | '' |
| productTitle | 默认信息提示中的产品名 | string | 系统 |
| logo | 左上角品牌 Logo 图片地址 | string | 内置默认 Logo |
| showBrand | 是否展示左上角品牌区(仅 fullPage 时生效) | boolean | true |
| showBack | 是否展示左上角返回按钮 | boolean | true |
| onBack | 返回按钮回调 | function | — |
| newPasswordLabel | 新密码标签 | string | 新密码 |
| confirmPasswordLabel | 确认密码标签 | string | 确认新密码 |
| passwordPlaceholder | 密码输入框占位符 | string | 请输入密码 |
| submitText | 提交按钮文案 | string | 提交 |
| passwordTips | 卡片内规则提示段落 | array | 见源码默认 |
| authCode | 初始密码链接校验码 | string | — |
| onSubmit | 提交:修改初始密码接口 | function | — |
| passwordPattern | 新密码正则(默认与 ForgetPage / 常见后台一致) | regexp | 内置 |
| enterMessage | 通用「必填」提示 | string | 请输入 |
| passwordFormatMessage | 密码格式错误提示 | string | 密码格式不正确 |
| confirmMismatchMessage | 两次密码不一致提示 | string | 两次密码不一致 |
插槽
| 名称 | 说明 |
|---|---|
| logo | 覆盖左上角品牌 Logo |
| title | 覆盖卡片内主标题(默认 pageTitle) |
| description | 覆盖顶部信息提示(默认根据 subTitle / productTitle) |
事件
| 名称 | 说明 |
|---|---|
| back | 点击左上角返回按钮时触发 |
| finish | 表单校验通过后触发,参数为 { newPassword, authCode? }(先于 onSubmit) |
类型
InitialPasswordSubmitValues:newPassword、authCode?DEFAULT_INITIAL_PASSWORD_REGEXP:默认密码正则(与 ForgetPage 同源)
源码位于 packages/components 仓库的 initial-page;安装与 registry 要求见 开发指南。