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
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| type | StatusBannerType | 'info' | 横幅类型,决定颜色与默认图标 |
| loading | boolean | false | 是否展示 loading 旋转图标 |
| closable | boolean | false | 是否可关闭 |
| show | boolean | true | 是否可见,支持 v-model:show |
| icon | string | — | 自定义图标名,格式 "category/icon-name";不传时按 type 默认 |
| title | string | — | 标题文本 |
| description | string | — | 描述/副标题文本 |
| clickable | boolean | false | 是否可点击(仅影响光标与 hover 反馈,不控制事件) |
Events
| 事件名 | 参数 | 说明 |
|---|---|---|
update:show | value: boolean | 关闭按钮被点击时发出(配合 v-model:show 收起横幅),负载为新的可见性值 false |
close | — | 关闭按钮被点击时触发,通知业务方横幅已关闭 |
click | event: MouseEvent | 点击横幅主体时触发(clickable 仅影响视觉反馈,事件始终会发出),负载为原生点击事件 MouseEvent |
Slots
| 插槽名 | 说明 |
|---|---|
icon | — |
title | — |
description | — |
action | — |
说明
type决定横幅语义配色与默认图标,也可通过icon传入自定义图标(格式"category/icon-name")clickable仅影响光标与 hover 反馈,点击事件统一由click事件处理- 关闭按钮触发
close事件并同步更新show(支持v-model:show) - 内置进场/退场过渡动画,主题化样式走
--uikit-*CSS 变量
