Skip to content

Status Dot

Usage ​

Import the component from its dedicated entry. Structural styles are loaded automatically.

vue
<script setup lang="ts">
import { StatusDot } from '@astryx-vue/core/StatusDot'
</script>

<template>
  <StatusDot label="Online" variant="success" />
</template>

Best practices ​

GuidancePractice
RecommendedAlways provide label; screen readers announce it via aria-label.
RecommendedUse the dot as a supporting signal alongside a visible text label.
RecommendedUse isPulsing for live, ongoing activity such as streaming or syncing.
Don'tRely on color alone for critical status. Color is not perceivable by everyone.
Don'tUse many pulsing dots on the same screen; it creates visual noise.

Examples ​

Variants

Status dots come in neutral, info, success, warning, and error semantic variants.

Pulsing

Set isPulsing to make the dot pulse, indicating an active state.