نشان وضعیت (StatusBadge)

معرفی

StatusBadge وضعیت عملیاتی یک موجودیت (خوشه، کمپین، پیج، هشدار) را روی یک طیف چهارکلاسه‌ی شدت (بحرانی ← هشدار ← متوسط ← پایین) نشان می‌دهد. حالت «بحرانی» به‌صورت پیش‌فرض نبض ملایم دارد تا توجه را جلب کند — رفتار احترام‌کننده به prefers-reduced-motion.

ورودی status انعطاف‌پذیر است: می‌توانید کلید وضعیت، کد عددی (۱ تا ۴)، یا متن (نام انگلیسی یا برچسب محلی) بدهید — کامپوننت در هر حالت وضعیت درست را تشخیص می‌دهد و رنگ، نقطه و برچسب متناظر را نمایش می‌دهد.

چه زمانی استفاده کنیم:

• روی کارت خوشه/کمپین برای نشان وضعیت بحرانی‌بودن
• در سطر جدول برای فیلتر سریع ردیف‌های بحرانی
• کنار نام یک هشدار یا job عملیاتی

چه زمانی استفاده نکنیم:

• برای اولویت یا فوریت — از SeverityBadge استفاده کنید
• برای sentiment/emotion — از SentimentBadge / EmotionBadge استفاده کنید
• برای status نرم‌افزاری (online/offline/loading) — از Badge با رنگ‌های brand/muted استفاده کنید

زمین بازی

import { StatusBadge } from '@parto-system-design/ui'

<StatusBadge />

مقادیر و نگاشت عددی

نشان وضعیت روی مقیاس عددی افکارسنجی کار می‌کند. کدها از 1 (بحرانی) شروع و به 4 (پایین) ختم می‌شوند:

استفاده

status هر یک از این فرم‌ها را می‌پذیرد:

import { StatusBadge } from '@parto-system-design/ui';

// ۱) کلید وضعیت
<StatusBadge status="critical" />     // پیش‌فرض نبض‌دار

// ۲) کد عددی (۱ تا ۴) — مثلاً خروجی مستقیم API
<StatusBadge status={1} />            {/* → بحرانی */}
<StatusBadge status={4} />            {/* → پایین */}

// ۳) متن — نام انگلیسی، رشته‌ی عددی، یا برچسب محلی (بزرگ/کوچک مهم نیست)
<StatusBadge status="Critical" />     {/* → بحرانی */}
<StatusBadge status="متوسط" />        {/* → متوسط */}
<StatusBadge status={'3'} />          {/* → متوسط */}

// سایر تنظیمات
<StatusBadge status="critical" animated={false} />  // خاموش کردن نبض

// مقدار ناشناخته یا خارج از بازه → چیزی رندر نمی‌شود
<StatusBadge status={0} />            {/* → null */}

ورودی از کد عددی (۱ تا ۴)

ورودی از متن

نام انگلیسی، رشته‌ی عددی، یا برچسب فارسی/عربی — همه به یک وضعیت نگاشت می‌شوند.

اندازه‌ها

Props

ابزار کمکی

برای تبدیل دستی مقدار به کلید وضعیت (خارج از این کامپوننت)، از resolveStatus استفاده کنید. خروجی برای مقادیر نامعتبر null است:

import { resolveStatus, STATUS_VALUE_MAP, STATUS_KEY_TO_VALUE } from '@parto-system-design/ui'

resolveStatus(1) // 'critical'
resolveStatus('Critical') // 'critical'
resolveStatus('متوسط') // 'middle'
resolveStatus('3') // 'middle'
resolveStatus('normal') // 'low'  (alias سازگاری)
resolveStatus(0) // null
resolveStatus(99) // null

STATUS_VALUE_MAP[1] // 'critical'
STATUS_KEY_TO_VALUE.low // 4

راهنمای استفاده

دسترسی‌پذیری

• نقطه رنگی و برچسب متنی هر دو نمایش داده می‌شوند (وابستگی صرف به رنگ نیست)
• نبض با prefers-reduced-motion: reduce به‌صورت خودکار غیرفعال می‌شود
• با showLabel={false} مقدار aria-label در متن صفحه‌خوان خوانده می‌شود

کامپوننت‌های مرتبط

• SeverityBadge — نمایش اولویت/فوریت (مستقل از status)
• Badge — نشان عمومی غیر دامنه‌ای