# Calendar

> Satu bulan berisi hari untuk memilih tanggal.

Calendar menampilkan satu bulan langsung di halaman untuk memilih hari, misalnya tanggal rilis saat memilih tanggal adalah tugas utama layar itu. Di dalam form, pakai [Date Picker](https://design.sosialoka.tech/id/components/date-picker/) yang membuka kalender ini di popover.

## Kapan dipakai

- Pakai langsung di halaman kalau memilih tanggal adalah tugasnya, misalnya menjadwalkan rilis.
- Di form, pakai Date Picker supaya kalender hanya memakan tempat saat dibuka.
- Untuk tanggal yang jauh di masa lalu, misalnya tanggal lahir, pakai pemilih bulan dan tahun (`captionLayout="dropdown"` di React, `layout="month-and-year"` di Vue).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/calendar/_

## Anatomi

1. Judul bulan
2. Nama hari, mulai Senin
3. Hari terpilih
4. Hari ini

Judul berisi bulan dan tahun, tombol sebelumnya dan berikutnya, baris nama hari singkat, lalu hari-harinya.

| Hari | Gaya |
| --- | --- |
| Hari biasa | 36px (`size-9`), `rounded-md` |
| Hari ini | `ring` |
| Terpilih | `bg-primary`, `text-primary-foreground` |
| Di luar bulan | `muted-foreground` |

Bawaannya berbahasa Inggris (en-GB): "November 2026", "Mo Tu We Th Fr Sa Su", dan minggu dimulai hari Senin. Untuk bahasa Indonesia, isi `id` dari `react-day-picker/locale` di React atau `locale="id-ID"` di Vue, seperti contohnya; Flutter mengikuti locale aplikasi.

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `mode="single"` | tunggal bawaannya | `ShadCalendar` | | tunggal | Memilih satu hari, rentang, atau beberapa hari. |
| `selected`, `onSelect` | `v-model` | `selected`, `onChanged` | `Date` / `DateValue` / `DateTime` | tidak ada | Hari yang dipilih. |
| `locale` | `locale` | `locale` aplikasi | lokal | Inggris (en-GB) | Nama bulan dan hari, serta hari pertama dalam minggu. |
| `defaultMonth` | `default-placeholder` | `initialMonth` | tanggal | hari ini | Bulan yang tampil pertama. |
| `captionLayout` | `layout` | `captionLayout` | teks | label | Pemilih bulan dan tahun sebagai ganti judul. |

## Kode

**React**
```tsx
import { useState } from "react"
import { id } from "react-day-picker/locale"
import { Calendar } from "@/components/ui/calendar"

export default function CalendarDemo() {
  const [date, setDate] = useState<Date | undefined>(new Date(2026, 10, 14))
  return <Calendar locale={id} mode="single" selected={date} onSelect={setDate} defaultMonth={date} className="rounded-lg border border-border" />
}
```

**Vue**
```vue
<script setup lang="ts">
import type { DateValue } from "@internationalized/date"
import { CalendarDate } from "@internationalized/date"
import { shallowRef } from "vue"
import { Calendar } from "@/components/ui/calendar"

const date = shallowRef<DateValue>(new CalendarDate(2026, 11, 14))
</script>

<template>
  <Calendar v-model="date" locale="id-ID" :default-placeholder="date" class="rounded-lg border border-border" />
</template>
```

**Flutter**
```dart
// ShadCalendar reads month and weekday names from the app locale: run the app with
// locale: Locale('id') and GlobalMaterialLocalizations.delegates (flutter_localizations).
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class CalendarDemo extends StatelessWidget {
  const CalendarDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadCalendar(
      selected: DateTime(2026, 11, 14),
      initialMonth: DateTime(2026, 11),
      weekStartsOn: 1,
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/calendar.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/calendar.json
```

## Aksesibilitas

- Tombol panah berpindah antarhari, Page Up dan Page Down antarbulan, dan Enter atau Spasi memilih hari.
- Setiap tombol hari menyebut tanggal lengkapnya, misalnya "Sabtu, 14 November 2026", serta apakah itu hari ini atau sudah dipilih.
- Tombol sebelumnya dan berikutnya bernama "Ke bulan sebelumnya" dan "Ke bulan berikutnya".
