mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-14 17:31:02 +08:00
239 lines
5.5 KiB
Markdown
239 lines
5.5 KiB
Markdown
|
## Alert 警告
|
|||
|
|
|||
|
用于页面中展示重要的提示信息。
|
|||
|
|
|||
|
### 基本用法
|
|||
|
|
|||
|
页面中的非浮层元素,不会自动消失。
|
|||
|
|
|||
|
:::demo Alert 组件提供四种主题,由`type`属性指定,默认值为`info`。
|
|||
|
```html
|
|||
|
<template>
|
|||
|
<el-alert
|
|||
|
title="成功提示的文案"
|
|||
|
type="success">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="消息提示的文案"
|
|||
|
type="info">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="警告提示的文案"
|
|||
|
type="warning">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="错误提示的文案"
|
|||
|
type="error">
|
|||
|
</el-alert>
|
|||
|
</template>
|
|||
|
```
|
|||
|
:::
|
|||
|
|
|||
|
### 主题
|
|||
|
|
|||
|
Alert 组件提供了两个不同的主题:`light`和`dark`。
|
|||
|
|
|||
|
:::demo 通过设置`effect`属性来改变主题,默认为`light`。
|
|||
|
```html
|
|||
|
<template>
|
|||
|
<el-alert
|
|||
|
title="成功提示的文案"
|
|||
|
type="success"
|
|||
|
effect="dark">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="消息提示的文案"
|
|||
|
type="info"
|
|||
|
effect="dark">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="警告提示的文案"
|
|||
|
type="warning"
|
|||
|
effect="dark">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="错误提示的文案"
|
|||
|
type="error"
|
|||
|
effect="dark">
|
|||
|
</el-alert>
|
|||
|
</template>
|
|||
|
```
|
|||
|
:::
|
|||
|
|
|||
|
|
|||
|
|
|||
|
### 自定义关闭按钮
|
|||
|
|
|||
|
自定义关闭按钮为文字或其他符号。
|
|||
|
|
|||
|
:::demo 在 Alert 组件中,你可以设置是否可关闭,关闭按钮的文本以及关闭时的回调函数。`closable`属性决定是否可关闭,接受`boolean`,默认为`true`。你可以设置`close-text`属性来代替右侧的关闭图标,注意:`close-text`必须为文本。设置`close`事件来设置关闭时的回调。
|
|||
|
```html
|
|||
|
<template>
|
|||
|
<el-alert
|
|||
|
title="不可关闭的 alert"
|
|||
|
type="success"
|
|||
|
:closable="false">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="自定义 close-text"
|
|||
|
type="info"
|
|||
|
close-text="知道了">
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="设置了回调的 alert"
|
|||
|
type="warning"
|
|||
|
@close="hello">
|
|||
|
</el-alert>
|
|||
|
</template>
|
|||
|
|
|||
|
<script>
|
|||
|
export default {
|
|||
|
methods: {
|
|||
|
hello() {
|
|||
|
alert('Hello World!');
|
|||
|
}
|
|||
|
}
|
|||
|
}
|
|||
|
</script>
|
|||
|
```
|
|||
|
:::
|
|||
|
|
|||
|
### 带有 icon
|
|||
|
|
|||
|
表示某种状态时提升可读性。
|
|||
|
|
|||
|
:::demo 通过设置`show-icon`属性来显示 Alert 的 icon,这能更有效地向用户展示你的显示意图。
|
|||
|
```html
|
|||
|
<template>
|
|||
|
<el-alert
|
|||
|
title="成功提示的文案"
|
|||
|
type="success"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="消息提示的文案"
|
|||
|
type="info"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="警告提示的文案"
|
|||
|
type="warning"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="错误提示的文案"
|
|||
|
type="error"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
</template>
|
|||
|
```
|
|||
|
:::
|
|||
|
|
|||
|
### 文字居中
|
|||
|
|
|||
|
使用 `center` 属性让文字水平居中。
|
|||
|
|
|||
|
:::demo
|
|||
|
```html
|
|||
|
<template>
|
|||
|
<el-alert
|
|||
|
title="成功提示的文案"
|
|||
|
type="success"
|
|||
|
center
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="消息提示的文案"
|
|||
|
type="info"
|
|||
|
center
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="警告提示的文案"
|
|||
|
type="warning"
|
|||
|
center
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="错误提示的文案"
|
|||
|
type="error"
|
|||
|
center
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
</template>
|
|||
|
```
|
|||
|
:::
|
|||
|
|
|||
|
### 带有辅助性文字介绍
|
|||
|
|
|||
|
包含标题和内容,解释更详细的警告。
|
|||
|
|
|||
|
:::demo 除了必填的`title`属性外,你可以设置`description`属性来帮助你更好地介绍,我们称之为辅助性文字。辅助性文字只能存放单行文本,会自动换行显示。
|
|||
|
```html
|
|||
|
<template>
|
|||
|
<el-alert
|
|||
|
title="带辅助性文字介绍"
|
|||
|
type="success"
|
|||
|
description="这是一句绕口令:黑灰化肥会挥发发灰黑化肥挥发;灰黑化肥会挥发发黑灰化肥发挥。 黑灰化肥会挥发发灰黑化肥黑灰挥发化为灰……">
|
|||
|
</el-alert>
|
|||
|
</template>
|
|||
|
```
|
|||
|
:::
|
|||
|
|
|||
|
### 带有 icon 和辅助性文字介绍
|
|||
|
|
|||
|
:::demo 最后,这是一个同时具有 icon 和辅助性文字的样例。
|
|||
|
```html
|
|||
|
<template>
|
|||
|
<el-alert
|
|||
|
title="成功提示的文案"
|
|||
|
type="success"
|
|||
|
description="文字说明文字说明文字说明文字说明文字说明文字说明"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="消息提示的文案"
|
|||
|
type="info"
|
|||
|
description="文字说明文字说明文字说明文字说明文字说明文字说明"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="警告提示的文案"
|
|||
|
type="warning"
|
|||
|
description="文字说明文字说明文字说明文字说明文字说明文字说明"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
<el-alert
|
|||
|
title="错误提示的文案"
|
|||
|
type="error"
|
|||
|
description="文字说明文字说明文字说明文字说明文字说明文字说明"
|
|||
|
show-icon>
|
|||
|
</el-alert>
|
|||
|
</template>
|
|||
|
```
|
|||
|
:::
|
|||
|
|
|||
|
### Attributes
|
|||
|
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
|||
|
|---------- |-------------- |---------- |-------------------------------- |-------- |
|
|||
|
| title | 标题 | string | — | — |
|
|||
|
| type | 主题 | string | success/warning/info/error | info |
|
|||
|
| description | 辅助性文字。也可通过默认 slot 传入 | string | — | — |
|
|||
|
| closable | 是否可关闭 | boolean | — | true |
|
|||
|
| center | 文字是否居中 | boolean | — | true |
|
|||
|
| close-text | 关闭按钮自定义文本 | string | — | — |
|
|||
|
| show-icon | 是否显示图标 | boolean | — | false |
|
|||
|
| effect | 选择提供的主题 | string | light/dark | light |
|
|||
|
|
|||
|
### Slot
|
|||
|
|
|||
|
| Name | Description |
|
|||
|
|------|--------|
|
|||
|
| — | 描述 |
|
|||
|
| title | 标题的内容 |
|
|||
|
|
|||
|
### Events
|
|||
|
| 事件名称 | 说明 | 回调参数 |
|
|||
|
|---------- |-------- |---------- |
|
|||
|
| close | 关闭alert时触发的事件 | — |
|