LoginPage 登录 ​

基于 uniboot-ui 的 UForm、UInput 等封装的 登录表单:提供 标题 / 副标题 / Logo、用户名与密码、可选 图形验证码、onFinish 异步提交 与底部 actions 区域。支持整页登录布局:默认蓝色背景(可自定义背景图)+ 左右分栏卡片(可自定义插画区)。

基础用法 ​

通过 title / subTitle 展示页头;message 可放提示(如维护公告);onFinish 接收 { username, password, captcha?, captchaKey? }。验证码开启时,使用 showCaptcha + getCaptcha 获取图片并展示(点击可刷新)。底部链接放在 #actions 插槽;右侧可通过 #extra 放辅助内容。

最小登录示例:提交前会短暂等待以模拟请求。

LoginPage 属性 ​

名称说明类型默认值
fullPage是否使用整页登录布局(背景 + 左右分栏卡片)booleantrue
backgroundImage背景图 URL(不传则使用默认蓝色背景)string''
showLanguageSwitch是否展示右上角语言切换booleantrue
getLanguages获取语言列表(优先级高于 languages;空时回退内置默认)function—
languages语言列表(不走接口时可直接传入;空时回退内置默认)object[]
defaultLanguage默认语言 valuestring''
onLanguageChange语言切换回调function—
showIllustration是否展示左侧插画区booleantrue
illustration左侧插画图 URL;也可用 illustration 插槽string内置默认图
title主标题string''
subTitle副标题string''
logoLogo 图片 URL;也可用 logo 插槽string内置默认图
message提示区文案(如公告)string''
loading主按钮 loading(可与内部提交态叠加)booleanfalse
submitText主按钮文案string登 录
usernameLabel用户名字段标签string用户名
passwordLabel密码字段标签string密码
usernamePlaceholder用户名占位string用户名
passwordPlaceholder密码占位string密码
showCaptcha是否展示验证码booleanfalse
captchaLabel验证码字段标签string验证码
captchaPlaceholder验证码占位string请输入验证码
getCaptcha获取验证码(返回图片 src 与可选 key/uuid)function—
initialValues初始值(username/password/captcha/captchaKey)object—
onFinish提交回调,可异步function—

事件 ​

名称说明类型
finish校验通过后、调用 onFinish 前触发,参数同提交值Function

插槽 ​

名称说明
logo自定义 Logo/品牌区(左侧)
illustration自定义左侧插画区
footer左侧底部区域(如版权)
title自定义主标题
subTitle自定义副标题
message自定义提示区
extra表单辅助区域
actions表单下方(如注册 / 联系管理员)

类型 ​

提交值 LoginFormValues:

  • username:string
  • password:string
  • captcha?:string(验证码输入)
  • captchaKey?:string(验证码 key/uuid,来自 getCaptcha 返回值)

源码位于 packages/components 仓库的 login-page;安装与 registry 要求见 开发指南。