پرتوپرتو

نشان احساس (SentimentBadge)

نمایش نوع احساس (مثبت، منفی، خنثی، ترکیبی) به صورت نشان رنگی

معرفی

کامپوننت SentimentBadge برای نمایش تحلیل احساسات (Sentiment Analysis) استفاده می‌شود.

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

  • برای نمایش نوع احساس یک نظر، پست یا محتوا
  • در جدول‌ها و لیست‌ها برای نشان دادن sentiment هر آیتم
  • وقتی نیاز به نمایش سریع و بصری مثبت/منفی/خنثی دارید

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

  • برای status های غیر احساسات (مثل وضعیت کمپین) — از Badge استفاده کنید
  • برای نمایش توزیع درصدی احساسات — از SentimentDistribution استفاده کنید
مثبت۱۲۰منفی۴۵خنثی۶۷ترکیبی

استفاده

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

<SentimentBadge sentiment="positive" />
<SentimentBadge sentiment="negative" />
<SentimentBadge sentiment="neutral" />
<SentimentBadge sentiment="mixed" />

زمین بازی

با تغییر تنظیمات زیر، نشان احساس را به صورت زنده مشاهده کنید.

زمین بازی
مثبت
تنظیمات
import { SentimentBadge } from '@parto-system-design/ui'

<SentimentBadge />

با تعداد

<SentimentBadge sentiment="positive" count={120} />
<SentimentBadge sentiment="negative" count={45} />

اندازه‌ها

مثبتمثبت

بدون برچسب

<SentimentBadge sentiment="positive" showLabel={false} />

Props

Prop

Type

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

بکنید

  • از showLabel برای نمایش متن فارسی احساس استفاده کنید - از count برای نمایش تعداد آیتم‌های هر احساس استفاده کنید
  • از size="sm" در جدول‌ها و فضاهای محدود استفاده کنید

نکنید

  • از SentimentBadge برای statusهای غیر احساساتی (مثل وضعیت کمپین) استفاده نکنید — از Badge استفاده کنید - بدون context از SentimentBadge استفاده نکنید — کاربر باید بداند sentiment مربوط به چیست - از showLabel={false} بدون tooltip استفاده نکنید — فقط رنگ برای درک معنا کافی نیست

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

  • آیکون احساس با رنگ و متن ترکیب شده تا وابستگی صرف به رنگ نباشد
  • showLabel متن فارسی را نمایش می‌دهد تا صفحه‌خوان‌ها بتوانند نوع احساس را بخوانند
  • رنگ‌ها با پس‌زمینه کنتراست WCAG AA دارند

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

  • SentimentDistribution — اگر نیاز به نمایش توزیع درصدی احساسات (مثبت/منفی/خنثی) دارید، از SentimentDistribution استفاده کنید
  • Badge — اگر label عمومی (غیر احساساتی) نیاز دارید، از Badge استفاده کنید
  • CommentCard — اگر نیاز به نمایش متن نظر با شاخص احساسات دارید، از CommentCard استفاده کنید