حساب (Account)

معرفی

Account تنها کامپوننت نمایش یک حساب است: حساب شبکهٔ اجتماعی، وب‌سایت، رسانهٔ خبری یا کانال. دادهٔ آن یک SocialAccount است. هویت (نام، شناسه با جهت درست، نشان تأیید فقط وقتی منبع آن را گفته، حساب تجاری، حساب خصوصی به‌عنوان یک وضعیت)، عددهای حساب با MetricGroup و یک جایگاه aside برای مقدار زمینه (تعداد منشن یک موضوع، رتبه در یک فهرست، وضعیت پایش) را دارد.

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

• هر جا یک حساب نمایش داده می‌شود: نتیجهٔ جست‌وجو، ردیف منشن، حساب‌های مرتبط، سربرگ صفحهٔ حساب.
• برای فهرست یا شبکهٔ حساب‌ها Account را داخل EntityCollection با entity="account" بگذارید (ردیف و کارت؛ کارت حساب شبکه است).

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

• برای نویسندهٔ یک پست یا نظر: Post و Comment هویت نویسنده را خودشان نمایش می‌دهند.
• برای کاربر واردشده به برنامه (منوی کاربر): از UserMenu استفاده کنید.

آناتومی

Account یک کامپوننت ترکیبی است؛ تکه‌هایش در همین صفحه مستند شده‌اند و جدول API هر تکه در بخش Props است.

استفاده

'use client'

import { Account, type SocialAccount } from '@partodata/ui/social'

export function MentionRow({ account, mentions }: { account: SocialAccount; mentions: number }) {
  return (
    <Account
      account={account}
      layout="row"
      metrics={['followers', 'engagement']}
      aside={<span className="text-meta">{`${mentions} منشن`}</span>}
    />
  )
}

حساب پشت یک ردیف پست را accountFromPost از @partodata/ui/social/adapters می‌سازد؛ API حساب محصول مبدل خودش را دارد که عددها را با toCount و toRatio یک بار به مدل تبدیل می‌کند (نرخ تعامل درصدی با toRatio(value, { unit: 'percent' })).

حالت‌ها و انواع

• هویت: نام اگر هست، وگرنه شناسه به‌عنوان عنوان؛ سایت و رسانه با دامنه (بدون @)، بقیه با شناسهٔ حساب. تصویر نداشتن یعنی حروف اول نام، نه تصویر یک چهرهٔ ناشناس؛ سازمان‌ها کاشی مربعی می‌گیرند و افراد دایره.
• پرچم‌ها: تأییدشده فقط وقتی verified === true؛ حساب تجاری با flags.business؛ حساب خصوصی state: 'private' است.
• عددها: دنبال‌کننده، دنبال‌شده، پست، نرخ تعامل و رتبه، با برچسب‌های هر منبع («عضو» در کانال تلگرام). نامعلوم «—».
• ترکیب: بدون children ترکیب پیش‌فرض هر چیدمان؛ برای ترکیب دیگر Account.Select، Account.Identity، Account.Bio، Account.Stats، Account.Aside و Account.Actions را بچینید (در کامپوننت کلاینت). فقط جایگاه‌های چیده‌شده نمایش داده می‌شوند: حساب انتخاب‌شدنی Account.Select لازم دارد و ویژگی aside در ترکیب دلخواه نادیده می‌ماند (Account.Aside).
• سربرگ: از عرض 40rem هویت و بیوگرافی و عددها کنار هم‌اند، حتی با بیوگرافی بلند؛ باریک‌تر، عددها زیر هویت می‌آیند.

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

Props

Account

Account.Stats / AccountStatsProps

Account.Actions / AccountActionsProps

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

• هر حساب یک article است که با نام (یا شناسه) نام‌گذاری می‌شود؛ نام در کارت و سربرگ عنوان است (h3 و h2).
• شناسه و دامنه جزیرهٔ چپ‌به‌راست با ارقام لاتین‌اند: @sample_shop2، هرگز sample_shop2@.
• وقتی onOpen هست، حساب فوکوس می‌گیرد و Enter آن را باز می‌کند؛ اقدامات کنترل‌های جدا هستند.

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

• Post — پست‌های یک حساب.
• EntityCollection — فهرست و شبکهٔ حساب‌ها.