فارسی
انتخاب ماه
انتخاب ماه و سال شمسی برای گزارش ماهانه، صورت‌حساب یا تاریخ انقضا.
import { MonthPicker, type JalaliMonth } from "@kashi-ui/react";نمونه
۱۴۰۵
ماهی انتخاب نشده.
const [m, setM] = useState<JalaliMonth | null>(null);
<MonthPicker aria-label="ماه گزارش" value={m} onChange={setM} max={{ year: 1405, month: 12 }} />برای تبدیل به تاریخ میلادی: toGregorian(m.year, m.month, 1) از @kashi-ui/persian.
| نام | نوع | پیش‌فرض | توضیح |
|---|---|---|---|
value / defaultValue | { year, month } | null | null | ماه شمسی؛ month از ۱ تا ۱۲ |
onChange | (value) => void | — | |
min / max | { year, month } | — | محدودهٔ مجاز |
digits | "fa" | "latin" | "fa" | |
aria-label | string | «انتخاب ماه» | |
labels | { prevYear?, nextYear? } | «سال قبل»، «سال بعد» |
کیبورد
| کلید | عمل |
|---|---|
| ← / → | ماه بعد / قبل (در RTL) |
| ↑ / ↓ | سه ماه قبل / بعد |
| PageUp / PageDown | سال قبل / بعد |
| Home / End | فروردین / اسفند |
دسترس‌پذیری
هر ماه دکمه‌ای با نام کامل («آبان ۱۴۰۵») و aria-pressed است؛ ماه جاری aria-current="date" دارد. فقط یک ماه در ترتیب Tab است و سال با aria-live اعلام می‌شود.