Element React 中文文档 Element-React Alert 警告

2024-02-25 开发教程 Element React 中文文档匿名 2℃

用于页面中展示重要的提示信息。

基本用法

页面中的非浮层元素，不会自动消失。

Alert 组件提供四种主题，由type属性指定，默认值为info。

render() {
  return (
    <div>
      <Alert title="成功提示的文案" type="success" />
      <Alert title="消息提示的文案" type="info" />
      <Alert title="警告提示的文案" type="warning" />
      <Alert title="错误提示的文案" type="error" />
    </div>
  )
}

自定义关闭按钮

自定义关闭按钮为文字或其他符号。

在 Alert 组件中，你可以设置是否可关闭，关闭按钮的文本以及关闭时的回调函数。closable属性决定是否可关闭，接受boolean，默认为true。你可以设置closeText属性来代替右侧的关闭图标，注意：closeText必须为文本。设置onClose事件来设置关闭时的回调。

render() {
  return (
    <div>
      <Alert title="不可关闭的 alert" type="success" closable={false} />
      <Alert title="自定义 close-text" type="info" closeText="知道了" />
      <Alert title="设置了回调的 alert" type="warning" onClose={() => alert('Hello World!')}/>
    </div>
  )
}

带有 icon

表示某种状态时提升可读性。

通过设置showIcon属性来显示 Alert 的 icon，这能更有效地向用户展示你的显示意图。

render() {
  return (
    <div>
      <Alert title="成功提示的文案" type="success" showIcon={true} />
      <Alert title="消息提示的文案" type="info" showIcon={true} />
      <Alert title="警告提示的文案" type="warning" showIcon={true} />
      <Alert title="错误提示的文案" type="error" showIcon={true} />
    </div>
  )
}

带有辅助性文字介绍

包含标题和内容，解释更详细的警告。

除了必填的title属性外，你可以设置description属性来帮助你更好地介绍，我们称之为辅助性文字。辅助性文字只能存放单行文本，会自动换行显示。

render() {
  return (
    <Alert
      type="success"
      title="带辅助性文字介绍"
      description="这是一句绕口令：黑灰化肥会挥发发灰黑化肥挥发；灰黑化肥会挥发发黑灰化肥发挥。 黑灰化肥会挥发发灰黑化肥黑灰挥发化为灰……" />
  )
}

带有 icon 和辅助性文字介绍

最后，这是一个同时具有 icon 和辅助性文字的样例。

render() {
  return (
    <div>
      <Alert title="成功提示的文案" type="success" description="文字说明文字说明文字说明文字说明文字说明文字说明"  showIcon={true} />
      <Alert title="消息提示的文案" type="info" description="文字说明文字说明文字说明文字说明文字说明文字说明" showIcon={true} />
      <Alert title="警告提示的文案" type="warning" description="文字说明文字说明文字说明文字说明文字说明文字说明" showIcon={true} />
      <Alert title="错误提示的文案" type="error" description="文字说明文字说明文字说明文字说明文字说明文字说明" showIcon={true} />
    </div>
  )
}

Attributes

参数	说明	类型	可选值	默认值
title	标题，必选参数	string	—	—
type	主题	string	success/warning/info/error	info
description	辅助性文字	string	—	—
closable	是否可关闭	boolean	—	true
closeText	关闭按钮自定义文本	string	—	—
showIcon	是否显示图标	boolean	—	false

Events

事件名称	说明	回调参数
onClose	关闭alert时触发的事件	—

上一节： Element-React Badge 标记

下一节： Element-React Loading 加载

"Element React 中文文档"的目录