跳到主要内容

Message 消息提示

全局浮层的轻量反馈:操作成功 / 失败、网络状态等。挂载在单例容器中,多条消息自上而下堆叠。

基础用法​

基础用法
import { message } from '@lh-ui/react'
import '@lh-ui/react/style/message'

message.success('保存成功')

message 方法​

方法说明返回值
info / success / warning / error / danger显示消息{ close }
loading显示加载消息(默认不自动关闭){ close }
destroyAll关闭全部消息并卸载容器void

返回的句柄用于主动关闭:

const handle = message.loading('正在上传…', { duration: 0 })
// ...
handle.close()

LhMessageOptions​

属性说明类型默认值
duration自动关闭毫秒数,0 不自动关闭(loading 语义默认 0)number3000
showClose是否显示关闭按钮booleanfalse
offset距视口顶部偏移 pxnumber20
closeLabel关闭按钮的 aria-labelstring语言包(zh-CN:关闭提示)
onClose关闭时回调() => void—
sx快速布局属性SxProps—
与 Vue 版的事件映射

message.success('x') 对应 plus 的 LhMessage.success('x');句柄的 close() 对应 plus 的 LhMessage.close(id)。React 侧用返回值而非全局 id 管理。

无障碍

成功 / 信息为 role="status"(排队播报),错误 / 警告为 role="alert"(立即播报), 与 Alert、Notification 同范式。

样式​

import '@lh-ui/react/style/message'