پرتوپرتو

هشدار (Alert)

کامپوننت نمایش پیام‌های هشدار و اطلاعات مهم

معرفی

کامپوننت Alert برای نمایش پیام‌های مهم، اطلاعات یا هشدارها به کاربران استفاده می‌شود.

استفاده

import { Alert, AlertDescription, AlertTitle } from '@parto/ui';

<div className="space-y-4">
  <Alert>
    <AlertTitle>اطلاعیه</AlertTitle>
    <AlertDescription>این یک پیام اطلاعاتی برای کاربر است.</AlertDescription>
  </Alert>

  <Alert variant="destructive">
    <AlertTitle>خطا</AlertTitle>
    <AlertDescription>مشکلی در ذخیره‌سازی اطلاعات به‌وجود آمد.</AlertDescription>
  </Alert>
</div>

انواع

پیش‌فرض

<Alert>
  <AlertTitle>اطلاعات</AlertTitle>
  <AlertDescription>
    این یک پیام اطلاعاتی است.
  </AlertDescription>
</Alert>

اطلاعات (Info)

<Alert variant="info">
  <AlertTitle>اطلاعات</AlertTitle>
  <AlertDescription>
    این یک پیام اطلاعاتی است.
  </AlertDescription>
</Alert>

موفقیت (Success)

<Alert variant="success">
  <AlertTitle>موفقیت</AlertTitle>
  <AlertDescription>
    عملیات با موفقیت انجام شد.
  </AlertDescription>
</Alert>

هشدار (Warning)

<Alert variant="warning">
  <AlertTitle>هشدار</AlertTitle>
  <AlertDescription>
    لطفاً این مورد را بررسی کنید.
  </AlertDescription>
</Alert>

خطا (Destructive)

<Alert variant="destructive">
  <AlertTitle>خطا</AlertTitle>
  <AlertDescription>
    یک خطای مهم رخ داده است.
  </AlertDescription>
</Alert>

با آیکون

import { Icons } from '@parto/ui';

<Alert>
  <Icons.info className="h-4 w-4" />
  <AlertTitle>اطلاعات</AlertTitle>
  <AlertDescription>
    پیام با آیکون اطلاعات
  </AlertDescription>
</Alert>

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

Alert از سه جزء اصلی تشکیل شده است:

  • Alert: کانتینر اصلی
  • AlertTitle: عنوان پیام
  • AlertDescription: متن توضیحات

Props

PropTypeDefaultDescription
variant'default' | 'info' | 'success' | 'warning' | 'destructive''default'نوع ظاهری هشدار
classNamestring-کلاس‌های CSS اضافی

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

  • از نقش alert یا status مناسب استفاده می‌شود
  • پیام‌های مهم به screen readers اعلام می‌شوند
  • رنگ‌بندی مناسب برای تمایز انواع پیام

ملاحظات RTL

  • متن به‌صورت خودکار راست‌چین می‌شود
  • آیکون‌ها در سمت راست قرار می‌گیرند
  • فاصله‌گذاری با استفاده از Logical Properties