跳到正文

StatusBanner 状态横幅 ​

非阻塞式状态提示横幅,用于展示连接状态、断网提醒、同步进度等场景,支持四种语义类型、loading 与可关闭能力。

使用方式 ​

组件以 EmStatusBanner 为名导出,全局注册后可直接使用:

vue
<script setup lang="ts">
import { ref } from 'vue'

const show = ref(true)
</script>

<template>
  <em-status-banner
    v-model:show="show"
    type="warning"
    title="网络连接不稳定"
    description="消息可能无法及时送达"
    closable
  />
</template>

基础用法 ​

API ​

StatusBanner API ​

Props ​

属性类型默认值说明
typeStatusBannerType'info'横幅类型,决定颜色与默认图标
loadingbooleanfalse是否展示 loading 旋转图标
closablebooleanfalse是否可关闭
showbooleantrue是否可见,支持 v-model:show
iconstring—自定义图标名,格式 "category/icon-name";不传时按 type 默认
titlestring—标题文本
descriptionstring—描述/副标题文本
clickablebooleanfalse是否可点击(仅影响光标与 hover 反馈,不控制事件)

Events ​

事件名参数说明
update:showvalue: boolean关闭按钮被点击时发出(配合 v-model:show 收起横幅),负载为新的可见性值 false
close—关闭按钮被点击时触发,通知业务方横幅已关闭
clickevent: MouseEvent点击横幅主体时触发(clickable 仅影响视觉反馈,事件始终会发出),负载为原生点击事件 MouseEvent

Slots ​

插槽名说明
icon—
title—
description—
action—

说明 ​

  • type 决定横幅语义配色与默认图标,也可通过 icon 传入自定义图标(格式 "category/icon-name")
  • clickable 仅影响光标与 hover 反馈,点击事件统一由 click 事件处理
  • 关闭按钮触发 close 事件并同步更新 show(支持 v-model:show)
  • 内置进场/退场过渡动画,主题化样式走 --uikit-* CSS 变量