JGuang

警告提示

Alert · Arco Design

交互预览
npm install @arco-design/web-react@2.66.18

警告提示 Alert

向用户显示警告的信息时,通过警告提示,展现需要关注的信息。

安装

npm install @arco-design/web-react@2.66.18

在入口引入 @arco-design/web-react/dist/css/arco.css,用 ConfigProvider 设置语言。React 19 项目还需在入口最先引入 @arco-design/web-react/es/_util/react-19-adapter,否则 Message、Modal 等命令式 API 无法渲染。

示例

  • 基本用法:警告提示,展现需要关注的信息,适用于简短的警告提示。
  • 不同类型:警告提示的类型有 info, success, warning, error 四种。
  • 可关闭:指定 closable = true,可开启关闭按钮。
  • 自定义关闭元素:指定 closeElement,自定义关闭元素。closeElement 可以接收 onClick,并且自带 close 参数,调用 close() 可以关闭。
  • 含有标题:通过设置 title 可以给添加标题,将 content 变为辅助性介绍文字。
  • 不含图标:通过指定 showIcon=false 来不显示图标。
  • 顶部公告:设置 banner = true,可以当作顶部公告使用。
  • 操作项:通过 action 可以自定义右上角操作项。

示例来自 Arco Design 官方仓库(MIT),固定在 npm 2.66.18 对应的提交;部分示例使用在线图片或上传地址,预览中网络请求被禁用。

API

Alert

参数名描述类型默认值
banner是否用作顶部公告boolean-
closable是否可关闭boolean-
showIcon是否显示图标booleantrue
type警告的类型'info' | 'success' | 'warning' | 'error'info
action自定义操作项ReactNode-
closeElement自定义关闭按钮ReactNode-
content内容ReactNode-
icon可以指定自定义图标,showIcon 为 true 时生效。ReactNode-
title标题ReactNode-
className节点类名string | string[]-
style节点样式CSSProperties-
afterClose关闭动画结束后执行的回调() => void-
onClose关闭的回调(e) => void-