نشان منبع (PlatformMark)

معرفی

PlatformMark نشان منبع است: نُه شبکهٔ اجتماعی با نشانهٔ برندشان، وب‌سایت، مطبوعات، تلویزیون، رادیو، استوری و فایل بارگذاری‌شده. منبع ناشناخته (کد API که سیستم طراحی نمی‌شناسد) نشان عمومی می‌گیرد و با برچسب یا کدش نام‌گذاری می‌شود («پلتفرم 7»)؛ هرگز خطا نمی‌دهد.

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

• کنار نام نویسنده در سرِ پست، نظر یا ردیف حساب؛ ورودی آن post.source از مدل است.
• برای فیلتر، چیپ یا راهنمای نمودار: با variant="badge" (قاب و پس‌زمینه) و showLabel.

استفاده

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

export function Source({ post }: { post: SocialPost }) {
  return <PlatformMark source={post.source} />
}

نام منبع بیرون از PlatformMark

برای فیلتر، سرستون جدول یا متن فایل خروجی، نام منبع را از sourceLabel بگیرید؛ PlatformMark هم نامش را از همین تابع می‌گیرد. این تابع را از @partodata/ui/social/adapters بگیرید، نه از @partodata/ui/social که نشانهٔ 'use client' دارد؛ پس در کامپوننت سرور هم کار می‌کند.

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

export function SourceName({ post }: { post: SocialPost }) {
  return <span>{sourceLabel(post.source, 'fa')}</span>
}

sourceLabel(source, locale = 'fa') نام منبع را به زبان locale برمی‌گرداند. source همان post.source یا یک کلید است؛ source.label اگر باشد جای نام سیستم طراحی را می‌گیرد و منبع ناشناخته با کدش («پلتفرم 7») یا «منبع ناشناخته» نام‌گذاری می‌شود. این تابع هرگز خطا نمی‌دهد.

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

• بدون showLabel نشان خودش نام دارد (role="img")؛ با showLabel نام کنار نشانه دیده می‌شود.
• source.label جای نام سیستم طراحی را می‌گیرد (مثلاً «فایل اکسل»).
• نوشتارهایی که محصولات می‌فرستند هم پذیرفته می‌شوند: x، website، television.
• اندازه‌ها: xs (12)، sm (16، پیش‌فرض)، md (20 پیکسل).

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

Props

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

• نشانه تزئینی است (aria-hidden)؛ نام منبع روی ریشه است (role="img" و aria-label) مگر showLabel یا decorative.

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

• Handle — شناسهٔ حساب کنار همین نشان.