全局提示 Message
全局展示操作反馈信息,常用于通知用户操作结果。
何时使用
- 需要向用户显示操作反馈时
- 需要全局性的简短通知时
- 不希望打断用户操作流程的通知场景
示例
基础用法
最简单的用法,通过不同方法显示不同类型的消息。
正在加载组件...
使用 message.show() 方法
可以通过 message.show() 方法动态指定提示类型。
正在加载组件...
多个提示排列
多个提示会按顺序向下排列,先进先出。
正在加载组件...
自定义显示时长
可以自定义消息显示时长,设置为 0 则不自动关闭。
正在加载组件...
富文本内容
支持 ReactNode 类型的内容,可以显示富文本。
正在加载组件...
移除单个消息
可以通过 message.remove(id) 方法移除指定的消息。
正在加载组件...
清除所有消息
可以通过 message.clear() 方法一次性清除所有消息。
正在加载组件...
完整示例
展示 Message 组件的各种使用场景。
正在加载组件...
API
message
| 方法 | 说明 | 类型 |
|---|---|---|
| message.show | 显示消息 | (type: 'info' | 'success' | 'warning' | 'error', message: React.ReactNode, duration?: number) => string |
| message.info | 显示信息消息 | (message: React.ReactNode, duration?: number) => string |
| message.success | 显示成功消息 | (message: React.ReactNode, duration?: number) => string |
| message.warning | 显示警告消息 | (message: React.ReactNode, duration?: number) => string |
| message.error | 显示错误消息 | (message: React.ReactNode, duration?: number) => string |
| message.remove | 移除指定消息 | (id: string) => void |
| message.clear | 清除所有消息 | () => void |
参数说明
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| type | 消息类型 | 'info' | 'success' | 'warning' | 'error' | - |
| message | 消息内容 | React.ReactNode | - |
| duration | 显示时长(毫秒),设置为 0 则不自动关闭 | number | 5000 |
| id | 消息唯一标识符,用于移除消息 | string | - |