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

کامپوننت‌ها

نوار اطلاعیه

پیام سطح صفحه مثل نسخهٔ جدید، پایان اشتراک یا اختلال سرویس، با دکمهٔ عمل و بستن.

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

برای پیامی که به کل صفحه یا حساب مربوط است. پیام مربوط به یک بخش یا فرم را با Alert و پیام گذرا را با Toast نشان دهید.

نمونه

نسخهٔ ۰٫۱۰ منتشر شد. هفت کامپوننت تازه، از جمله پلاک خودرو و کد پستی.

اشتراک شما ۳ روز دیگر تمام می‌شود. برای جلوگیری از قطع سرویس آن را تمدید کنید.

<Banner tone="brand" icon={<InfoIcon />} onClose={dismiss}
actions={<Button size="sm" variant="primary">مشاهدهٔ تغییرات</Button>}>
<strong>نسخهٔ ۰٫۱۰ منتشر شد.</strong> هفت کامپوننت تازه…
</Banner>

<Banner tone="warning" icon={<WarningIcon />} actions={<Button size="sm">تمدید اشتراک</Button>}>
<strong>اشتراک شما ۳ روز دیگر تمام می‌شود.</strong> …
</Banner>

برای چسباندن به بالای صفحه، flush را بدهید تا حاشیه و گوشهٔ گرد حذف شود.

نامنوعپیش‌فرضتوضیح
tone"neutral" | "brand" | "warning" | "error""neutral"رنگ
iconReactNode—آیکون شاخص
actionsReactNode—دکمه یا لینک‌ها
onClose() => void—با آن دکمهٔ بستن نمایش داده می‌شود
flushbooleanfalseبدون حاشیه، برای بالای صفحه
label / closeLabelstring«اطلاعیه» / «بستن اطلاعیه»نام ناحیه و دکمه

دسترس‌پذیری

ناحیهٔ role="region" با نام «اطلاعیه»، تا کاربر صفحه‌خوان بتواند به آن پرش کند. نوار به‌عمد aria-live ندارد، چون هنگام بارگذاری صفحه نمایش داده می‌شود؛ برای پیام‌هایی که بعداً ظاهر می‌شوند از Toast استفاده کنید.