هشدار (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
| Prop | Type | Default | Description |
|---|---|---|---|
variant | 'default' | 'info' | 'success' | 'warning' | 'destructive' | 'default' | نوع ظاهری هشدار |
className | string | - | کلاسهای CSS اضافی |
دسترسیپذیری
- از نقش
alertیاstatusمناسب استفاده میشود - پیامهای مهم به screen readers اعلام میشوند
- رنگبندی مناسب برای تمایز انواع پیام
ملاحظات RTL
- متن بهصورت خودکار راستچین میشود
- آیکونها در سمت راست قرار میگیرند
- فاصلهگذاری با استفاده از Logical Properties