توزیع احساسات (SentimentDistribution)

معرفی

کامپوننت SentimentDistribution برای نمایش توزیع احساسات (مثبت، منفی، خنثی) در سه قالب مختلف استفاده می‌شود. داده‌های عددی ورودی به صورت خودکار به درصد تبدیل می‌شوند.

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

• برای نمایش نسبت مثبت/منفی/خنثی نظرات یک پست یا کمپین
• در داشبورد social listening برای خلاصه احساسات
• وقتی نیاز به مقایسه بصری سه دسته احساس دارید

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

• برای کمتر از ۳ نوع داده — از Progress یا Badge استفاده کنید
• برای داده‌های غیر احساساتی — از PartoBarChart استفاده کنید

استفاده

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

;<SentimentDistribution data={{ positive: 1200, negative: 340, neutral: 560 }} />

همه حالت‌ها

bars (پیش‌فرض)

<SentimentDistribution data={{ positive: 1200, negative: 340, neutral: 560 }} variant="bars" />

stacked

<SentimentDistribution data={{ positive: 1200, negative: 340, neutral: 560 }} variant="stacked" />

compact

<SentimentDistribution data={{ positive: 1200, negative: 340, neutral: 560 }} variant="compact" />

نمایش تعداد

<SentimentDistribution data={{ positive: 1200, negative: 340, neutral: 560 }} showCounts />

Props

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

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

• برچسب‌های متنی (مثبت، منفی، خنثی) همراه رنگ نمایش داده می‌شوند تا وابستگی به رنگ نباشد
• درصدها به locale مناسب فرمت می‌شوند
• رنگ‌ها از CSS variables استاندارد (--sentiment-positive/negative/neutral) می‌آیند و کنتراست WCAG AA دارند

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

• SentimentBadge — اگر فقط نمایش نوع احساس یک آیتم واحد نیاز دارید (نه توزیع)، از SentimentBadge استفاده کنید
• PartoBarChart — اگر داده‌های غیر احساساتی یا بیش از سه دسته دارید، از PartoBarChart استفاده کنید