Skip to content

小提示(showTip)

顶层小提示,生命周期一般最短,层级最高。

一、场景和形态

弹框选择之一,特点轻量级、自动关闭无需交互无回调,无模态。 支持warning、info、error、success标准组合。

UI效果

下面是自定义了logo之后的效果

image-20250424115359408

现场演示

演示代码如下:

vue
<div @click="show"><button id="tip-btn" style="border:1px solid #999;padding:10px 20px;margin:6px;">点我弹出 showTip</button></div>

<!--vitepress默认会拦截<script>代码,这里采用vue,setup是vue的语法糖,用于确保在DOM 渲染之前执行-->
<script setup>
    import { init,showTip } from 'axue';
    init()   //如果全局注册过,这里最好不要重复注册,虽然除了打印警告不会有真实负面影响
    const show = () => {
      showTip.send('Hello, axue components!');
    };
</script>

二、使用方式

发送tip消息

JavaScript
import {showTip} from "axue";

/**
    默认1.5秒后自动消失
    默认不指定提示类型,
*/
showTip.send('Hello, axue!');

指定提示类型

showTip.send,左边默认显示logo图标,业务含义不清晰,也可以指定类型

JavaScript
showTip.info('Hello, axue!');    //普通提示图标
showTip.warning('警告, axue!');  //警告图标
showTip.error('错误, axue!');    //错误图标
showTip.success('成功, axue!');  //成功图标

提前关闭tip

JavaScript
/**
    不等内部逻辑自动关闭,而是从外围主动关闭
    实际上,.info、.warning等方法会在默认延迟后自动调用.close()
*/
showTip.close();

高级配置

如果默认的样式背景、显示时长不能满足需求,可以使用配置能力

使用方法

JavaScript
import {showTip} from "axue";

//在调用前,进行全局配置,对后续所有类型的tip均有效
showTip.config({
    duration:1000,
    backgroundColor:"#eee"
})

//发送提示,此时将变成1s后自动关闭
showTip.info('Hello, axue!');
全局配置项
内联属性说明类型默认值
duration弹出到自动消失的时间间隔毫秒数string1500
backgroundColor背景色,符合16进制颜色字符串string"#ffffffee"

青锋三尺,樵夫十年