شناسهٔ حساب (Handle)

معرفی

Handle شناسهٔ یک حساب (@brand) یا دامنهٔ یک سایت (news.example.com) را نمایش می‌دهد. در صفحهٔ راست‌به‌چپ، @ یک نویسهٔ خنثی است و جهت پاراگراف را می‌گیرد؛ به همین دلیل @news_agency_ir بدون جداسازی به شکل news_agency_ir@ نمایش داده می‌شد. Handle شناسه را داخل یک جزیرهٔ چپ‌به‌راست نمایش می‌دهد و ارقامش را لاتین نگه می‌دارد، چون شناسه یک شناسه است نه عدد. شناسهٔ بلند کوتاه می‌شود و مقدار کامل در راهنمای شناور می‌آید.

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

• هر جا شناسهٔ حساب کنار نام یا در متن فارسی نمایش داده می‌شود: سرِ پست، ردیف حساب، ردیف منشن.
• برای دامنهٔ وب‌سایت یا رسانهٔ خبری: source مورد را بدهید تا نوع از روی منبع انتخاب شود.

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

• برای منشن داخل متن کاربر: SocialText خودش منشن‌ها را جدا می‌کند.
• برای نام نمایشی حساب: نام، متن معمولی است.

استفاده

import { Handle, type SocialPost } from '@partodata/ui/social'

export function Author({ post }: { post: SocialPost }) {
  if (!post.actor?.handle) return null
  return (
    <span className="flex min-w-0 items-center gap-2">
      {post.actor.name ? <span className="text-label text-foreground">{post.actor.name}</span> : null}
      <Handle value={post.actor.handle} source={post.source} />
    </span>
  )
}

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

• با source، نوع از قاعدهٔ مدل می‌آید: وب‌سایت (web) و رسانهٔ خبری (press) با دامنه شناخته می‌شوند و بقیهٔ منبع‌ها با شناسهٔ حساب. لازم نیست هر صفحه این قاعده را خودش بنویسد.
• kind="account": @ ابتدایی یک بار نوشته می‌شود، چه ورودی آن را داشته باشد چه نه.
• kind="domain": پروتکل، www. و / پایانی حذف می‌شوند و @ نوشته نمی‌شود. kind صریح بر source مقدم است.
• با href شناسه پیوند می‌شود (صفحهٔ حساب در برنامه یا در منبع). پیوند داخل ردیف یا کارت کلیک‌پذیر فقط مقصد خودش را باز می‌کند، نه خود مورد را.
• شناسهٔ خالی چیزی نمایش نمی‌دهد.

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

Props

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

• شناسه با dir="ltr" جداسازی می‌شود و صفحه‌خوان آن را همان‌طور که نوشته شده می‌خواند.
• مقدار کامل شناسهٔ کوتاه‌شده در title است.
• رنگ پیوند هنگام بردن نشانگر روی آن و هنگام فوکوس brand-600 است که در هر دو پوسته کنتراست متن را دارد.

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

• PlatformMark — نشان شبکه‌ای که شناسه به آن تعلق دارد.
• SocialText — منشن‌های داخل متن کاربر.