Message 消息提示
以短暂提示反馈操作结果。需要标题、详细说明或后续操作时使用 Notification。
基础用法
在应用入口放置 ConfigProvider,再在子组件中调用 useMessage()。已有该配置时无需重复添加。
basic.tsx
示例
状态提示
通过快捷方法显示成功、信息、警告和危险提示。
states.tsx
手动关闭
设置 duration: 0 持续显示,配合 closable: true 提供关闭按钮。
manual.tsx
异步更新
使用 loading() 返回的 key,将加载消息替换为操作结果。相同 key 会替换整组配置,而不是合并旧配置,并按新的时长重新计时。
async.tsx
跨组件共享
下面两个按钮来自不同子组件。同一入口下的组件共享消息队列,可以用相同 key 更新消息。嵌套的 ConfigProvider 沿用同一队列,每条消息使用调用组件所在区域的主题和语言。
shared.tsx
调用组件卸载后,已有消息继续保留,异步任务仍可更新结果;入口 provider 卸载后,其消息和计时器一起清理。
API
Message API
直接渲染时,由应用响应 onClose 并设置 open=false;afterClose 在离场动画结束后触发。
useMessage API
获取当前入口托管的消息队列。
MessageApi
close(key) 仅关闭指定消息;close() 关闭共享队列中的全部消息。
MessageOptions
鼠标停留或焦点进入消息时暂停计时,恢复后按剩余时长继续。
MessageProvider API
单独使用消息时,可用 MessageProvider 代替 ConfigProvider;显式添加它也可建立独立队列。不同 React 应用及 SSR 请求各自拥有队列。