پرتوپرتو

سربرگ صفحه (Page Header)

سربرگ استاندارد صفحه با پشتیبانی از عنوان، توضیح، دکمه بازگشت، breadcrumb و عملیات.

معرفی

کامپوننت PageHeader یک سربرگ یکپارچه برای صفحات داخلی است. شامل عنوان، توضیح اختیاری، دکمه بازگشت، breadcrumb، و ناحیه عملیات در انتهای ردیف می‌شود.

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

  • در بالای هر صفحه داخلی برای نمایش عنوان و اقدامات مرتبط
  • وقتی نیاز به دکمه بازگشت یا breadcrumb دارید
  • برای ایجاد ساختار یکپارچه در تمام صفحات داشبورد

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

  • داخل modal یا dialog — header در overlay ها معمولاً ساده‌تر است
  • برای section header های داخل صفحه — از h2 ساده استفاده کنید

استفاده

گزارش تعامل اینستاگرام

تحلیل نرخ تعامل در بازه زمانی انتخاب‌شده

import { PageHeader, Button } from '@parto-system-design/ui'

export default function MyComponent() {
  return (
    <PageHeader
      title="گزارش تعامل اینستاگرام"
      description="تحلیل نرخ تعامل در بازه زمانی انتخاب‌شده"
      onBack={() => history.back()}
      actions={
        <>
          <Button variant="outline" size="sm">
            صادر کردن
          </Button>
          <Button size="sm">به‌روزرسانی</Button>
        </>
      }
    />
  )
}

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

با Breadcrumb

تحلیل کمپین نوروز

گزارش جامع عملکرد کمپین از ۱ فروردین تا ۱۵ فروردین

Props

Prop

Type

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

بکنید

  • در هر صفحه فقط یک PageHeader قرار دهید تا ساختار h1 صفحه مشخص باشد - از actions برای دکمه‌های مرتبط با محتوای صفحه استفاده کنید - وقتی صفحه در hierarchy عمیق قرار دارد، از breadcrumbs استفاده کنید

نکنید

  • از PageHeader به عنوان جایگزین AppBar استفاده نکنید — PageHeader برای سطح صفحه است، نه سطح اپلیکیشن - بیش از ۳ دکمه در actions نگذارید — اقدامات اضافی را در DropdownMenu قرار دهید

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

  • دکمه برگشت دارای aria-label است که از locale سیستم خوانده می‌شود
  • عنوان صفحه با تگ <h1> رندر می‌شود که برای ساختار صفحه مهم است

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

  • Breadcrumb — اغلب در کنار PageHeader استفاده می‌شود تا مسیر ناوبری کاربر مشخص باشد
  • AppBar — وقتی به هدر سطح اپلیکیشن (sticky) نیاز دارید، نه هدر سطح صفحه