# Alert 警告框

概述

Alert 警告框,可自定义颜色,图标等。

# 支持平台

App-vue App-Nvue 微信小程序 支付宝小程序 钉钉小程序 百度小程序 字节小程序 QQ小程序 H5/PC

# 引入

以下介绍两种常用的引入方式。
第一种:在页面中引用、注册
import fuiAlert from "@/components/firstui/fui-alert/fui-alert.vue"
export default {
	components:{
		fuiAlert
	}
}
1
2
3
4
5
6
第二种:easycom组件规范
传统vue组件,需要安装、引用、注册,三个步骤后才能使用组件。easycom将其精简为一步。

First UI easycom配置请查看 快速上手

如果不了解easycom,可先查看 官网文档 (opens new window)

# 代码演示

部分示例演示,完整使用请参考示例程序以及文档API。
基础使用

通过 title 属性设置标题,type 属性设置类型。

 <fui-alert title="An info alert"></fui-alert>
 <fui-alert type="success" title="An success alert"></fui-alert>
1
2

注意:非nvue端,可通过css变量全局修改按钮type类型对应的颜色,css变量参考 自定义主题

可关闭

通过 closable 属性设置是否显示关闭按钮。

<fui-alert closable title="An info alert" v-if="show" @close="close"></fui-alert>
1
自定义图标

通过 isLeft 属性设置是否自定义左侧图标内容。

<fui-alert type="warn" isLeft spacing title="An info alert" size="28rpx" :marginTop="24">
	<fui-icon name="warning" :size="48" color="#fff"></fui-icon>
</fui-alert>
1
2
3
自定义颜色

通过 iconColor 属性设置图标颜色,background 属性设置背景色,color 属性设置标题颜色。

<fui-alert type="success" iconColor="#09BE4F" background="#fff" color="#181818" title="An info alert"></fui-alert>
1

# Slots

插槽名称 说明
default 左侧区域,自定义内容展示
content 内容区域,自定义内容展示
right 右侧区域,自定义内容展示

# Props

属性名 类型 说明 默认值 平台差异说明
type String 类型,有效值:info, success, warn, waiting,clear - -
background String 背景色,如果设置则type对应颜色失效 - 非Nvue端可通过css变量修改对应type的默认颜色
padding Array padding值:[上,右,下,左] ['20rpx', '32rpx'] -
marginTop Number, String margin-top值,单位rpx 0 -
marginBottom Number, String margin-bottom值,单位rpx 0 -
radius String 圆角值 16rpx -
iconColor String 左侧icon颜色 #fff -
iconSize Number 左侧icon字体大小,单位px 22 -
closable Boolean 是否显示关闭按钮 false -
closeColor String 关闭按钮颜色 #fff -
closeSize Number 关闭按钮icon字体大小,单位px 22 -
isLeft Boolean 是否自定义左侧内容,默认图标失效 false -
spacing Boolean 内容是否与图标之间有间隔,isLeft为true时生效 false -
title String 标题内容 - -
color String 标题字体颜色 #fff -
size String 标题字体大小 14px -
desc String 描述内容 - -
descColor String 描述内容的字体颜色 #fff -
descSize String 描述内容字体大小 12px -
single Boolean 描述内容是否单行展示,超出隐藏 false -

# Events

事件名 说明 回调参数
@leftClick 点击左侧图标区域时触发 -
@click 点击内容区域时触发 -
@close 点击关闭按钮时触发 -

示例预览

# 示例代码地址

FirstUIAlert 警告框
Last Updated: 9/29/2022, 1:07:59 AM