Skip to content

Alert 提示

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

基础用法

Alert 组件不属于浮层元素,不会自动消失或关闭。

Alert 组件提供四种类型,由 type 属性指定,默认值为 info

Success alert

Info alert

Warning alert

Danger alert

<template>
  <p>
    <m-alert title="Success alert" type="success"></m-alert>
  </p>
  <p>
    <m-alert title="Info alert" type="info"></m-alert>
  </p>
  <p>
    <m-alert title="Warning alert" type="warning"></m-alert>
  </p>
  <p>
    <m-alert title="Danger alert" type="danger"></m-alert>
  </p>
</template>

主题

Alert 组件提供了两个不同的主题:lightdark

通过设置 effect 属性来改变主题,默认为 light

Success alert

Info alert

Warning alert

Danger alert

<template>
  <p>
    <m-alert title="Success alert" type="success" effect="dark"></m-alert>
  </p>
  <p>
    <m-alert title="Info alert" type="info" effect="dark"></m-alert>
  </p>
  <p>
    <m-alert title="Warning alert" type="warning" effect="dark"></m-alert>
  </p>
  <p>
    <m-alert title="Danger alert" type="danger" effect="dark"></m-alert>
  </p>
</template>

使用图标

你可以通过为 Alert 组件添加图标来提高可读性。

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

Success alert

Info alert

Warning alert

Danger alert

<template>
  <p>
    <m-alert title="Success alert" type="success" show-icon="true"></m-alert>
  </p>
  <p>
    <m-alert title="Info alert" type="info" show-icon="true"></m-alert>
  </p>
  <p>
    <m-alert title="Warning alert" type="warning" show-icon="true"></m-alert>
  </p>
  <p>
    <m-alert title="Danger alert" type="danger" show-icon="true"></m-alert>
  </p>
</template>

文字居中

使用 center 属性来让文字水平居中。

Success alert

Info alert

Warning alert

Danger alert

<template>
  <p>
    <m-alert title="Success alert" type="success" show-icon="true" center="true"></m-alert>
  </p>
  <p>
    <m-alert title="Info alert" type="info" show-icon="true" center="true"></m-alert>
  </p>
  <p>
    <m-alert title="Warning alert" type="warning" show-icon="true" center="true"></m-alert>
  </p>
  <p>
    <m-alert title="Danger alert" type="danger" show-icon="true" center="true"></m-alert>
  </p>
</template>

文字描述

为 Alert 组件添加一个更加详细的描述来使用户了解更多信息。

除了必填的 title 属性外,你可以设置 description 属性来帮助你更好地介绍,我们称之为辅助性文字。辅助性文字只能存放文本内容,当内容超出长度限制时会自动换行显示。

With description

This is a description

<template>
  <m-alert title="With description" description="This is a description" type="success"></m-alert>
</template>

带图标和描述

在最后,这是一个带有图标和描述的例子。

Success alert

More text description

Info alert

More text description

Warning alert

More text description

Danger alert

More text description

<template>
  <p>
    <m-alert title="Success alert" description="More text description" type="success" show-icon="true"></m-alert>
  </p>
  <p>
    <m-alert title="Info alert" description="More text description" type="info" show-icon="true"></m-alert>
  </p>
  <p>
    <m-alert title="Warning alert" description="More text description" type="warning" show-icon="true"></m-alert>
  </p>
  <p>
    <m-alert title="Danger alert" description="More text description" type="danger" show-icon="true"></m-alert>
  </p>
</template>

Alert API

Props

NameDescriptionTypeDefault
titleAlert 标题string
typeAlert 类型enum - 'success'| 'warning'| 'danger'| 'info'info
description描述性文本string
closable是否可以关闭booleantrue
center文字是否居中booleanfalse
show-icon是否展示图标booleanfalse
effect主题样式enum - 'light'|'dark'light

Events

NameDescriptionType
close关闭 Alert 时触发的事件(event: MouseEvent)=> void

Slots

NameDescription
default默认插槽,用于设置 Alert 的内容描述
title标题的内容

Expose

NameDescriptionType
open打开 Alert() => void
close关闭 Alert() => void