رفتن به محتوای اصلی

هشدار

پیامی مهم دربارهٔ وضعیت سیستم یا نتیجهٔ یک عمل، با آیکون شاخص و عمل‌های اختیاری.

import { Alert } from "@kashi-ui/react";

رنگ‌ها

سطح هشدار خنثی است و رنگ فقط در آیکون شاخص دیده می‌شود؛ این کار صفحه را آرام نگه می‌دارد.

نسخهٔ جدید منتشر شد

کاشی ۰.۲ با هفت کامپوننت تازه در دسترس است.

تغییرات ذخیره شد

<Alert tone="brand" title="نسخهٔ جدید منتشر شد">کاشی ۰.۲ با هفت کامپوننت تازه در دسترس است.</Alert>
<Alert tone="success" title="تغییرات ذخیره شد" />
<Alert tone="warning" title="اشتراک شما ۳ روز دیگر تمام می‌شود">برای جلوگیری از قطع سرویس، اشتراک را تمدید کنید.</Alert>
<Alert tone="error" title="پرداخت ناموفق بود">موجودی کارت کافی نیست. کارت دیگری را امتحان کنید.</Alert>

عمل‌ها و بستن

به‌روزرسانی در دسترس است

نسخهٔ جدید بهبودهای امنیتی دارد.
<Alert
tone="info"
title="به‌روزرسانی در دسترس است"
actions={<>
  <Button variant="link">به‌روزرسانی</Button>
  <Button variant="link">بعداً</Button>
</>}
onClose={() => setOpen(false)}
>
نسخهٔ جدید بهبودهای امنیتی دارد.
</Alert>

پس‌زمینهٔ رنگی

برای پیام‌هایی که باید بیشتر دیده شوند، از tinted استفاده کنید.

<Alert tone="warning" tinted title="حالت نگهداری">سرویس امشب از ساعت ۲ تا ۴ در دسترس نیست.</Alert>

ویژگی‌ها

نامنوعپیش‌فرضتوضیح
tone"neutral" | "brand" | "info" | "success" | "warning" | "error""neutral"رنگ و آیکون پیش‌فرض
titleReactNode—عنوان
childrenReactNode—توضیح
iconReactNode | false—آیکون سفارشی؛ false برای حذف
actionsReactNode—دکمه‌ها یا لینک‌های زیر متن
onClose() => void—با دادن این تابع دکمهٔ بستن نمایش داده می‌شود
closeLabelstring"بستن"نام دسترس‌پذیر دکمهٔ بستن
tintedbooleanfalseپس‌زمینهٔ رنگی کم‌رنگ
rolestringخودکارپیش‌فرض alert برای خطا و هشدار، status برای بقیه

متغیرهای CSS

متغیرپیش‌فرضکاربرد
--k-alert-radiusvar(--k-radius-xl)گردی گوشه‌ها
--k-alert-padding1rem × densityفاصلهٔ داخلی
--k-alert-bgvar(--k-bg-secondary)پس‌زمینه

دسترس‌پذیری

  • هشدارهای error و warning نقش alert دارند و صفحه‌خوان آن‌ها را فوراً اعلام می‌کند؛ بقیه با نقش status بدون قطع کاربر خوانده می‌شوند.
  • فقط هشدارهایی را که پس از بارگذاری صفحه اضافه می‌شوند alert کنید؛ هشدار ثابت صفحه را با role="note" نمایش دهید.
  • آیکون تزئینی است و از صفحه‌خوان پنهان است؛ عنوان باید معنا را کامل برساند.