LoginPage 登录

基于 uniboot-uiUFormUInput 等封装的 登录表单:提供 标题 / 副标题 / 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/uuidfunction
initialValues初始值(username/password/captcha/captchaKey)object
onFinish提交回调,可异步function

事件

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

插槽

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

类型

提交值 LoginFormValues

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

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