uniapp中uview组件库的AlertTips 警告提示使用方法

目录

#使用场景

#平台差异说明

#基本使用

#图标

#可关闭的警告提示

#API

#Props

#Events


警告提示,展现需要关注的信息。

#使用场景

  • 当某个页面需要向用户显示警告的信息时。
  • 非浮层的静态展现形式,始终展现,不会自动消失,用户可以点击关闭。

#平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 头条小程序 QQ小程序
√ √ √ √ √ √ √

#基本使用

  • 通过title和description设置组件的标题和描述内容,如果内容和标题同时存在,标题字体会被加粗加大

  • 通过type设置主题类型,有primary,success,error,warning,info可选值

#图标

通过show-icon设置是否显示图标,作用是让信息类型更加醒目。

注意 :当前版本图标为uView内置图标,根据type参数显示不同的图标,无法自定义。

复制代码
<u-alert-tips type="warning" :show-icon="true"></u-alert-tips>

#可关闭的警告提示

显示关闭按钮,点击可关闭警告提示。

  • close-text参数配置关闭的文字,默认为一个叉的icon图标。close-able为true时有效
  • close-able参数配置是否允许关闭的文字或图标

注意

由于props传参的限制,您需要监听组件的close事件,并在此此事件中设置show参数为false,才能关闭组件。

复制代码
<template>
	<u-alert-tips :show="show" type="error" @close="show = false" :title="title" :close-able="true"></u-alert-tips>
	
	<u-alert-tips type="error" :title="title" close-text="close" :description="description" :close-able="true"></u-alert-tips>
</template>

<script>
	export default {
		data() {
			title: '寻隐者不遇',
			description: '松下问童子,言师采药去。只在此山中,云深不知处。',
			show: true
		}
	}
</script>

#API

#Props

参数 说明 类型 默认值 可选值
title 显示的文字 String - -
description 辅助性文字,颜色比title浅一点,字号也小一点,可选 String - -
close-able 关闭按钮(默认为叉号icon图标) Boolean false true
type 使用预设的颜色 String warning success / primary / error / info
close-text 用文字替代关闭图标,close-able为true时有效 String - -
show-icon 是否显示左边的辅助图标 Boolean false true
show 显示或隐藏组件 Boolean true false
icon 1.5.8 左侧的图标名称,如设置type和show-icon值,会有一个默认的图标 String - -
icon-style 1.5.8 自定义图标的样式,对象形式 Object - -
title-style 1.5.8 自定义标题的样式,对象形式 Object - -
desc-style 1.5.8 自定义内容的样式,对象形式 Object - -

#Events

事件名 说明 回调参数
close 点击关闭按钮时触发,需在此回调设置show为false -
click 点击组件时触发 -
相关推荐
码间留白11 小时前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
anyup14 小时前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
2401_879692514 天前
微信小程序照相与摄像功能实现——chooseImage 与 chooseVideo 详解
微信小程序·小程序·notepad++
码间留白6 天前
六轮真机实验后,我把鸿蒙直播推流的 UI 全逼成了原生——uni-app 适配 HarmonyOS NEXT 完整复盘
uni-app·鸿蒙·harmonyos next·直播推流·arkts/arkui
wuxianda10307 天前
2026 苹果审核 4.3 (a) 被拒全解析|Guideline 4.3a spam 马甲包拒审原因 + 避坑方案
flutter·uni-app·苹果上架
头发还在的女程序员9 天前
基于 Spring Boot + Vue 3 + uni-app 的灵活用工系统:四端架构与业务流程设计
vue.js·spring boot·uni-app·灵活用工·灵工系统
Dumbness11 天前
订阅消息弹窗必须在用户点击里调:联调实验室里 timing 和 Mock 支付通知踩的坑
javascript·uni-app
码间留白12 天前
uni-app 鸿蒙离线打包:一个改动从源码到真机要穿过几条链
uni-app·鸿蒙·deveco·离线打包·uts插件
多客:duokelijie12 天前
代练订单系统选型思路:跨品类游戏接入、订单分层管理、自动结算逻辑拆解!
数据库·mysql·微信小程序·前端框架·uni-app·php·持续部署
码间留白13 天前
鸿蒙端对接 BLE 血压计:从一次握手到读数入库(二)设备篇
物联网·uni-app·鸿蒙·蓝牙ble·血压计