متن بلند (Prose)

معرفی

Prose تایپوگرافی متن بلند را یک‌جا می‌دهد: تیترها، پاراگراف، فهرست، نقل‌قول، کد و لینک با نقش‌های متنی 4.0 (h1 عنوان صفحه، h2 عنوان بخش، h3 عنوان کارت، و text-body برای متن). ورودی می‌تواند JSX باشد یا یک رشتهٔ مارک‌داون با markdown. MarkdownRenderer همین کامپوننت است با ورودی مارک‌داون.

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

• بدنهٔ بخش‌های گزارش، راهنمای اپراتور، خلاصه و روایت هوش مصنوعی
• هر جا متن چندپاراگرافی دارید و نمی‌خواهید برای هر عنصر کلاس بنویسید

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

• برای برچسب، عنوان کارت یا متن کوتاه رابط — از نقش‌های متنی مستقیم (text-body، text-caption) استفاده کنید
• برای متن پست کاربر — از SocialText استفاده کنید

استفاده

import { Prose } from '@partodata/ui/prose'

<Prose>
  <h2>جمع‌بندی هفته</h2>
  <p>بیشترین بحث دربارهٔ قیمت بنزین بود.</p>
  <ul>
    <li>افزایش 40 درصدی حجم گفت‌وگو</li>
  </ul>
</Prose>

مارک‌داون

مارک‌داون امن رندر می‌شود: HTML خام به‌صورت متن می‌ماند و لینک‌های javascript: حذف می‌شوند.

<Prose markdown={report.summary} density="compact" />

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

Props

Prose

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

• خروجی عناصر معنایی واقعی است (h1–h6، ul/ol، blockquote، pre/code)
• بلوک کد با dir="ltr" رندر می‌شود و لینک‌ها حلقهٔ focus مرئی دارند

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

• MarkdownRenderer — همین کامپوننت با API قدیمی (مارک‌داون در children)
• ReportSections — بخش‌های گزارش که بدنه‌شان با Prose است