Calendar
Month Grid
Месяц на сетке 7×6 с постоянной высотой: неделя с понедельника, дни соседних месяцев видны и кликабельны.
- calendar
- date picker
- month
- intl
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/calendar-001
| пн | вт | ср | чт | пт | сб | вс |
|---|---|---|---|---|---|---|
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «calendar-001» (Month Grid) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/calendar-001.json
Registry item: https://vibeui.ru/r/calendar-001.json
Ставится в: components/vibeui/calendar-001.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Месяц на сетке 7×6 с постоянной высотой: неделя с понедельника, дни соседних месяцев видны и кликабельны.
Календарь месяца: сетка 7×6 постоянной высоты, выбор дня, переключение месяцев, кнопка «Сегодня» и локаль через Intl. Ноль зависимостей, один файл.
## 3. Как использовать
import { Calendar001 } from "@/components/vibeui/calendar-001"
<Calendar001 defaultValue="2026-03-14" onChange={setDate} />
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-calendar-001-* и не подменять её токенами вашей темы
- шесть строк всегда: месяц переменной высоты дёргает всё под собой
- неделю с понедельника через сдвиг getDay(): по умолчанию JavaScript начинает с воскресенья
- aria-label с полной датой на каждой кнопке — одно число вслух бессмысленно
- кликабельные дни соседних месяцев: попасть на 1 число из последней строки — обычное дело
- строку ISO на входе и выходе вместо объекта Date
## 6. Можно менять
- defaultValue — стартовая дата
- locale — язык подписей
- обработчик onChange
- акцент через проп accent
## 7. Правила
- Праздники, выходные и заблокированные дни компонент не знает: добавьте свой признак в разметку кнопки.
- Часовой пояс не учитывается: строка ISO трактуется как местная дата, и это осознанный выбор для выбора дня.
- Для диапазона возьмите calendar-002, для двух месяцев — calendar-009.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/calendar-001.jsonhttps://vibeui.ru/r/calendar-001.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-calendar-001-*. Клиентский: "use client". Дата приходит и уходит строкой ISO — её проще передать с сервера, чем объект Date. Сетка всегда 42 клетки, неделя считается с понедельника через сдвиг (getDay() + 6) % 7. Названия месяцев и дней даёт Intl.DateTimeFormat, поэтому язык меняется одним пропом.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useMemo, useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Calendar001Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "onChange" | "defaultValue"
> & {
/** Дата в ISO: 2026-03-14. Строка, а не Date — её проще передать с сервера. */
defaultValue?: string
locale?: string
onChange?: (iso: string) => void
accent?: string
}
// Идея компонента: месяц на сетке 7×6 с постоянной высотой. Число строк
// фиксировано: месяц, который то на пять строк, то на шесть, дёргает всё
// под собой при переключении. Неделя начинается с понедельника, потому что
// в России и Европе так, а не как в JavaScript по умолчанию.
const STYLES = `
:where([data-vibeui-block="calendar-001"]){
--vibeui-calendar-001-bg:oklch(1 0 0);
--vibeui-calendar-001-fg:oklch(0.24 0.014 265);
--vibeui-calendar-001-muted:oklch(0.6 0.014 265);
--vibeui-calendar-001-border:oklch(0.91 0.006 265);
--vibeui-calendar-001-hover:oklch(0.96 0.004 265);
--vibeui-calendar-001-accent:oklch(0.55 0.17 265);
--vibeui-calendar-001-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="calendar-001"]{
display:flex;flex-direction:column;gap:0.625rem;
width:100%;max-width:18rem;box-sizing:border-box;padding:0.875rem;
background:var(--vibeui-calendar-001-bg);
border:1px solid var(--vibeui-calendar-001-border);border-radius:0.875rem;
color:var(--vibeui-calendar-001-fg);font-family:var(--vibeui-calendar-001-font);
}
[data-vibeui-block="calendar-001"] [data-part="head"]{
display:flex;align-items:center;justify-content:space-between;gap:0.5rem;
}
[data-vibeui-block="calendar-001"] [data-part="title"]{
font-size:0.875rem;font-weight:650;
}
/* Заглавная только первая буква: capitalize поднимает и «г.» в «январь 2026 г.». */
[data-vibeui-block="calendar-001"] [data-part="title"]::first-letter{text-transform:uppercase}
[data-vibeui-block="calendar-001"] [data-part="nav"]{display:flex;gap:0.25rem}
[data-vibeui-block="calendar-001"] [data-part="nav"] button{
appearance:none;cursor:pointer;
display:inline-flex;align-items:center;justify-content:center;
width:1.75rem;height:1.75rem;padding:0;
border:1px solid var(--vibeui-calendar-001-border);border-radius:0.5rem;
background:transparent;color:inherit;
}
[data-vibeui-block="calendar-001"] [data-part="nav"] button:hover{background:var(--vibeui-calendar-001-hover)}
[data-vibeui-block="calendar-001"] [data-part="nav"] button:focus-visible{outline:2px solid var(--vibeui-calendar-001-accent);outline-offset:2px}
[data-vibeui-block="calendar-001"] [data-part="arrow"]{
width:0.375rem;height:0.375rem;
border-left:1.5px solid currentColor;border-bottom:1.5px solid currentColor;
transform:rotate(45deg) translate(0.0625rem,-0.0625rem);
}
[data-vibeui-block="calendar-001"] [data-part="arrow"][data-dir="next"]{transform:rotate(-135deg) translate(0.0625rem,-0.0625rem)}
[data-vibeui-block="calendar-001"] table{width:100%;border-collapse:collapse;table-layout:fixed}
[data-vibeui-block="calendar-001"] th{
padding:0.25rem 0;font-size:0.6875rem;font-weight:600;
color:var(--vibeui-calendar-001-muted);text-transform:capitalize;
}
[data-vibeui-block="calendar-001"] td{padding:0.0625rem;text-align:center}
[data-vibeui-block="calendar-001"] td button{
appearance:none;cursor:pointer;
display:inline-flex;align-items:center;justify-content:center;
width:2rem;height:2rem;padding:0;border:0;border-radius:0.5rem;
background:transparent;color:inherit;
font:inherit;font-size:0.8125rem;font-variant-numeric:tabular-nums;
}
[data-vibeui-block="calendar-001"] td button:hover{background:var(--vibeui-calendar-001-hover)}
[data-vibeui-block="calendar-001"] td button:focus-visible{outline:2px solid var(--vibeui-calendar-001-accent);outline-offset:-2px}
/* Дни соседних месяцев приглушены, но кликабельны: попасть на 1 число
следующего месяца из последней строки — обычное дело. */
[data-vibeui-block="calendar-001"] td button[data-outside="true"]{color:var(--vibeui-calendar-001-muted);opacity:.6}
[data-vibeui-block="calendar-001"] td button[data-today="true"]{box-shadow:inset 0 0 0 1px var(--vibeui-calendar-001-border);font-weight:650}
[data-vibeui-block="calendar-001"] td button[aria-pressed="true"]{
background:var(--vibeui-calendar-001-accent);color:oklch(0.99 0.01 265);font-weight:650;opacity:1;
}
[data-vibeui-block="calendar-001"] [data-part="footer"]{
display:flex;align-items:center;justify-content:space-between;gap:0.5rem;
font-size:0.75rem;color:var(--vibeui-calendar-001-muted);
}
[data-vibeui-block="calendar-001"] [data-part="today"]{
appearance:none;border:0;background:transparent;cursor:pointer;padding:0;
color:var(--vibeui-calendar-001-accent);font:inherit;font-size:0.75rem;font-weight:600;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="calendar-001"] *{animation:none!important;transition:none!important}}
`
const DAY = 86400000
function iso(date: Date) {
return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`
}
// Неделя с понедельника: getDay() отдаёт воскресенье нулём, и без сдвига
// сетка съезжает на день.
function mondayIndex(date: Date) {
return (date.getDay() + 6) % 7
}
function buildGrid(year: number, month: number) {
const first = new Date(year, month, 1)
const start = new Date(first.getTime() - mondayIndex(first) * DAY)
// Шесть строк всегда: месяц переменной высоты дёргает раскладку.
return Array.from(
{ length: 42 },
(_, index) => new Date(start.getTime() + index * DAY),
)
}
/**
* Месяц на сетке 7×6 с постоянной высотой и неделей с понедельника.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Calendar001({
defaultValue = "2026-03-14",
locale = "ru-RU",
onChange,
accent,
className,
style,
...props
}: Calendar001Props) {
const [selected, setSelected] = useState(defaultValue)
const [cursor, setCursor] = useState(() => {
const [year, month] = defaultValue.split("-").map(Number)
return { year, month: month - 1 }
})
const days = useMemo(
() => buildGrid(cursor.year, cursor.month),
[cursor.month, cursor.year],
)
const titles = useMemo(() => {
const week = new Intl.DateTimeFormat(locale, { weekday: "short" })
const month = new Intl.DateTimeFormat(locale, {
month: "long",
year: "numeric",
})
return {
weekdays: days.slice(0, 7).map((date) => week.format(date)),
month: month.format(new Date(cursor.year, cursor.month, 1)),
full: new Intl.DateTimeFormat(locale, { dateStyle: "long" }),
}
}, [cursor.month, cursor.year, days, locale])
const palette = {
...(accent ? { "--vibeui-calendar-001-accent": accent } : null),
...style,
} as CSSProperties
const today = iso(new Date())
const shift = (delta: number) => {
const next = new Date(cursor.year, cursor.month + delta, 1)
setCursor({ year: next.getFullYear(), month: next.getMonth() })
}
const pick = (date: Date) => {
setSelected(iso(date))
setCursor({ year: date.getFullYear(), month: date.getMonth() })
onChange?.(iso(date))
}
return (
<>
<style href="vibeui-calendar-001" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="calendar-001"
className={className}
style={palette}
>
<div data-part="head">
<span data-part="title">{titles.month}</span>
<span data-part="nav">
<button
type="button"
aria-label="Предыдущий месяц"
onClick={() => shift(-1)}
>
<span data-part="arrow" aria-hidden="true" />
</button>
<button
type="button"
aria-label="Следующий месяц"
onClick={() => shift(1)}
>
<span data-part="arrow" data-dir="next" aria-hidden="true" />
</button>
</span>
</div>
<table>
<thead>
<tr>
{titles.weekdays.map((day) => (
<th key={day} scope="col" abbr={day}>
{day}
</th>
))}
</tr>
</thead>
<tbody>
{Array.from({ length: 6 }, (_, row) => (
<tr key={row}>
{days.slice(row * 7, row * 7 + 7).map((date) => {
const value = iso(date)
return (
<td key={value}>
<button
type="button"
aria-pressed={value === selected}
aria-label={titles.full.format(date)}
data-outside={date.getMonth() !== cursor.month}
data-today={value === today}
onClick={() => pick(date)}
>
{date.getDate()}
</button>
</td>
)
})}
</tr>
))}
</tbody>
</table>
<div data-part="footer">
<span>{titles.full.format(new Date(`${selected}T00:00:00`))}</span>
<button
type="button"
data-part="today"
onClick={() => pick(new Date())}
>
Сегодня
</button>
</div>
</div>
</>
)
}