# Alert 警告

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

# 基本用法

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

Alert 组件提供五种主题,由type属性指定,默认值为default

<template>
	<div class="alert-block">
		<tu-alert title="默认提示"></tu-alert>

		<tu-alert
			title="成功提示"
			type="success"
		>
		</tu-alert>
		<tu-alert
			title="消息提示"
			type="info"
		>
		</tu-alert>
		<tu-alert
			title="警告提示"
			type="warning"
		>
		</tu-alert>
		<tu-alert
			title="错误提示"
			type="error"
		>
		</tu-alert>
	</div>
</template>
<style>
	.alert-block .tu-alert {
		margin-bottom: 20px;
	}
</style>
Expand Copy

# 主题

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

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

<template>
	<div class="alert-block">
		<tu-alert
			title="成功提示"
			effect="dark"
		>
		</tu-alert>

		<tu-alert
			title="成功提示"
			type="success"
			effect="dark"
		>
		</tu-alert>
		<tu-alert
			title="消息提示"
			type="info"
			effect="dark"
		>
		</tu-alert>
		<tu-alert
			title="警告提示"
			type="warning"
			effect="dark"
		>
		</tu-alert>
		<tu-alert
			title="错误提示"
			type="error"
			effect="dark"
		>
		</tu-alert>
	</div>
</template>
<style>
	.alert-block .tu-alert {
		margin-bottom: 20px;
	}
</style>
Expand Copy

# 自定义关闭按钮

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

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

<template>
	<div class="alert-block">
		<tu-alert
			title="不可关闭的 alert"
			type="success"
			:closable="false"
		>
		</tu-alert>
		<tu-alert
			title="自定义 close-text"
			type="info"
			close-text="知道了"
		>
		</tu-alert>
		<tu-alert
			title="设置了回调的 alert"
			type="warning"
			@close="close"
		>
		</tu-alert>
	</div>
</template>

<script>
	export default {
		methods: {
			close() {
				alert("Hello World!");
			},
		},
	};
</script>
<style>
	.alert-block .tu-alert {
		margin-bottom: 20px;
	}
</style>
Expand Copy

# 带有 icon

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

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

<template>
	<div class="alert-block">
		<tu-alert
			title="成功提示"
			type="success"
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="消息提示"
			type="info"
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="警告提示"
			type="warning"
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="错误提示"
			type="error"
			show-icon
		>
		</tu-alert>
	</div>
</template>
<style>
	.alert-block .tu-alert {
		margin-bottom: 20px;
	}
</style>
Expand Copy

# 文字居中

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

<template>
	<div class="alert-block">
		<tu-alert
			title="成功提示"
			type="success"
			center
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="消息提示"
			type="info"
			center
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="警告提示"
			type="warning"
			center
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="错误提示"
			type="error"
			center
			show-icon
		>
		</tu-alert>
	</div>
</template>
<style>
	.alert-block .tu-alert {
		margin-bottom: 20px;
	}
</style>
Expand Copy

# 带有辅助性文字介绍

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

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

<template>
	<tu-alert
		title="带辅助性文字介绍"
		description="他可以想象成功的生活,却不能触碰它;可以想象永久的幸福,却知道自己会死亡,可以想象一个更美好的世界,但知道,在自己有生之年,有改善也微乎其微;可以想象轻松的生活,当下过得却磕磕碰碰。意愿无限,干起事来却总是受限制;愿望无边,行动却接受界限的奴役"
	>
	</tu-alert>
</template>
Expand Copy

# 带有 icon 和辅助性文字介绍

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

<template>
	<div class="alert-block">
		<tu-alert
			title="成功提示"
			type="success"
			description="漂泊的人生都梦想着平静,童年,杜鹃花,正如平静的人生梦想着伏特加,乐队和醉生梦死。"
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="消息提示"
			type="info"
			description="漂泊的人生都梦想着平静,童年,杜鹃花,正如平静的人生梦想着伏特加,乐队和醉生梦死。"
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="警告提示"
			type="warning"
			description="漂泊的人生都梦想着平静,童年,杜鹃花,正如平静的人生梦想着伏特加,乐队和醉生梦死。"
			show-icon
		>
		</tu-alert>
		<tu-alert
			title="错误提示"
			type="error"
			description="漂泊的人生都梦想着平静,童年,杜鹃花,正如平静的人生梦想着伏特加,乐队和醉生梦死。"
			show-icon
		>
		</tu-alert>
	</div>
</template>
<style>
	.alert-block .tu-alert {
		margin-bottom: 20px;
	}
</style>
Expand Copy

# 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 时触发的事件