# Alert 警告提示
警告提示,展现需要关注的信息。
# 使用场景
- 当某个页面需要向用户显示警告的信息时。
- 非浮层的静态展现形式,始终展现,不会自动消失,用户可以点击关闭。
# 平台差异说明
App(vue) | App(nvue) | H5 | 小程序 |
---|---|---|---|
√ | √ | √ | √ |
# 基本使用
- 通过
title
和description
设置组件的标题和描述内容 - 通过
type
设置主题类型,有primary
,success
,error
,warning
,info
可选值 - 通过
effect
设置主题浅或深色调,有light
(浅色 默认),dark
(深色)可选值
<template>
<view>
<up-alert :title="title" type = "warning" :description = "description"></up-alert>
<up-alert :title="title" type = "warning" effect="dark" :description = "description"></up-alert>
</view>
</template>
<script setup>
import { ref } from 'vue';
// 响应式数据
const title = ref('uview-plus的目标是成为uni-app生态最优秀的UI框架');
const description = ref('uview-plus是uni-app生态专用的UI框架');
</script>
# 图标
通过showIcon
设置是否显示图标,作用是让信息类型更加醒目。
注意:当前版本图标为uview-plus内置图标,根据type
参数显示不同的图标,无法自定义。
<up-alert type="warning" :show-icon="true"></up-alert>
# 可关闭的警告提示
显示关闭按钮,点击可关闭警告提示。
closable
参数配置是否可关闭
<template>
<view>
<up-alert :title="title" type = "warning" :closable="closable" :description = "description"></up-alert>
</view>
</template>
<script setup>
import { ref } from 'vue';
import { onLoad, onShow } from '@dcloudio/uni-app';
// 定义响应式数据
const title = ref('uview-plus的目标是成为uni-app生态最优秀的UI框架');
const description = ref('uview-plus是uni-app生态专用的UI框架');
const closable = ref(true);
// 使用 uni-app 的 onLoad 生命周期钩子
onLoad(() => {
// 组件加载时执行的逻辑
console.log('组件加载了');
});
// 使用 uni-app 的 onShow 生命周期钩子
onShow(() => {
// 组件显示时执行的逻辑
console.log('组件显示了');
});
</script>
# 右侧演示页面源代码地址
# API
# Props
参数 | 说明 | 类型 | 默认值 | 可选值 |
---|---|---|---|---|
title | 显示的文字 | String | - | - |
type | 使用预设的颜色 | String | warning | success | primary | error | info |
description | 辅助性文字,颜色比title 浅一点,字号也小一点,可选 | String | - | - |
closable | 关闭按钮(默认为叉号icon图标) | Boolean | false | true |
showIcon | 是否显示左边的辅助图标 | Boolean | false | true |
effect | 多图时,图片缩放裁剪的模式 | String | light(浅色) | dark(深色) |
center | 文字是否居中 | Boolean | false | true |
fontSize | 字体大小 | String | Number | 14 | - |
# Events
事件名 | 说明 | 回调参数 |
---|---|---|
click | 点击组件时触发 | - |