توزیع (Distribution)

معرفی

Distribution نشان می‌دهد مجموعه‌ای از مطالب میان دسته‌های یک مقیاس چطور پخش شده است. مقیاس را kind تعیین می‌کند:

• kind="sentiment" — مثبت، خنثی، ترکیبی، منفی، و «نامشخص» (تحلیل‌نشده) در انتها
• kind="emotion" — نه هیجان؛ در نمای bars و compact فقط topN دستهٔ بزرگ‌تر (پیش‌فرض 5) و بقیه در «بقیه»
• kind="flow" — پنج موضع مخاطب؛ در نمای bars و compact به ترتیب تعداد

عددهای ورودی خودکار به درصد تبدیل می‌شوند (با گرد کردن به روش بیشترین باقی‌مانده، تا جمعشان دقیقاً 100 باشد)؛ دسته‌ای که مطلبی ندارد نمایش داده نمی‌شود و اگر هیچ دسته‌ای مطلب نداشته باشد، همین را می‌گوید.

از 5.0 این کامپوننت جای کامپوننت‌های نسخهٔ 4 SentimentDistribution، EmotionDistribution و FlowDistribution را گرفته است (npx --no parto-migrate-v5 کد آن‌ها را به Distribution با kind مناسب تبدیل می‌کند).

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

• نسبت مثبت/منفی/خنثی نظرهای یک پست یا کمپین
• ترکیب هیجان‌ها یا موضع مخاطبان یک موضوع در داشبورد یا گزارش
• ستون توزیع در جدول (از طریق SentimentCell و FlowCell)

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

• روند در طول زمان — PartoLineChart یا PartoAreaChart
• احساس یک مطلب — SentimentBadge، EmotionBadge یا FlowBadge

زمین بازی

استفاده

import { Distribution } from '@partodata/ui'
;<Distribution kind="sentiment" data={{ positive: 1200, negative: 340, neutral: 560 }} />

نماها

bars (پیش‌فرض احساس و هیجان)

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

tone — همیشه رنگی (mono منسوخ، 7.12)

احساس، هیجان و موضع دستهٔ معنایی‌اند و رنگ هر دسته معنای آن است (--sentiment-*، --emotion-*، --flow-*). نسخهٔ 7.11 حالت tone="mono" را برای شبکهٔ کارت‌ها افزود؛ نتیجه حذف همان معنا بود و مالک آن را رد کرد (17 مهر 1405: «تمیز یعنی بی‌سیگنال بصری نیست»). از 7.12 mono منسوخ است و در محیط توسعه هشدار می‌دهد. آرامش یک شبکهٔ کارت را از سطح‌ها، فاصله و تایپوگرافی بگیرید، نه از حذف رنگ دسته‌ها.

stacked (پیش‌فرض موضع)

<Distribution kind="flow" data={{ 'pro-gov': 50, 'internal-critic': 30, grey: 20 }} />

compact

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

هیجان‌ها

<Distribution kind="emotion" data={{ joy: 460, trust: 380, anger: 320, neutral: 540 }} topN={3} />

موضع مخاطبان

نمایش تعداد

<Distribution kind="sentiment" data={{ positive: 1200, negative: 340, neutral: 560 }} showCounts />

Props

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

• نوار stacked یک role="img" است با نامی که کل تقسیم را می‌خواند («مثبت 57٪، خنثی 27٪، منفی 16٪»)؛ بدون داده، تزئینی است.
• هر ردیف bars یک progressbar با aria-valuenow درصد همان دسته است.
• متن مقادیر رنگ لایهٔ خوانای هر خانواده (-text) را دارد، نه رنگ پررنگ پر کردن.

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

• SentimentBadge — احساس یک مطلب
• EmotionBadge — هیجان یک مطلب
• FlowBadge — موضع یک مطلب
• DataTable Cells — SentimentCell و FlowCell در جدول