状态点
使用方法
StatusDot 是一个轻量的状态指示点,常出现在头像角标、列表项和监控页面中,用颜色快速传达在线、异常等状态。从独立入口导入即可,结构样式会随组件自动加载:
vue
<script setup lang="ts">
import { StatusDot } from '@astryx-vue/core/StatusDot'
</script>
<template>
<StatusDot label="在线" variant="success" />
</template>最佳实践
| 指引 | 实践 |
|---|---|
| 推荐 | label 是必填项:状态点本身没有文字,屏幕阅读器用户依赖这个 aria-label 理解当前状态,描述应写清状态的含义。 |
| 推荐 | 把状态点当作辅助信号,和附近的文字标签搭配使用,用户不必辨认颜色也能读懂状态。 |
| 推荐 | 直播、同步、录制等正在进行的活动可以开启 isPulsing,脉冲动画能明确传达“进行中”的感觉。 |
| 避免 | 仅用颜色传达关键状态:色觉障碍用户无法区分颜色,关键状态必须同时给出文字或图标说明。 |
| 避免 | 在同一界面放置过多脉冲状态点:持续动画容易分散注意力,只给真正有活动的状态开启。 |
示例
变体
状态点有 neutral、info、success、warning、error 五种语义变体。
脉冲
设置 isPulsing 可以让状态点呼吸闪烁,表示活动中的状态。