# `PhoenixLiveCalendar.Views.YearView`
[🔗](https://github.com/mdon/phoenix_live_calendar/blob/v0.5.0/lib/phoenix_live_calendar/views/year_view.ex#L1)

Year view — displays 12 mini-month calendars in a responsive grid.

Uses lightweight rendering: event dots only, no event details.
Click a date to navigate to that day's detail view.

# `year_view`

Renders a year view with 12 mini-month calendars.

## Attributes

- `year` — The year to display
- `events` — List of `PhoenixLiveCalendar.Event` structs (used for dot indicators)
- `day_markers` — List of `PhoenixLiveCalendar.DayMarker` structs; custom
  marker colors tint the mini cells (year-scale heatmap)
- `selected_date` — Currently selected date
- `today` — Today's date
- `week_start` — First day of week (default: 1)
- `columns` — Number of columns in the grid (default: 3)
- `on_date_click` — Handler for date clicks
- `translations` — Translation overrides
- `class` — Additional CSS classes

## Attributes

* `year` (`:integer`) (required)
* `events` (`:list`) - Defaults to `[]`.
* `day_markers` (`:list`) - Defaults to `[]`.
* `selected_date` (`Date`) - Defaults to `nil`.
* `today` (`:any`) - Date | nil (server today) | :none (no today highlight). Defaults to `nil`.
* `week_start` (`:integer`) - Defaults to `1`.
* `columns` (`:integer`) - Defaults to `3`.
* `on_date_click` (`:any`) - Defaults to `nil`.
* `translations` (`:map`) - Defaults to `%{}`.
* `class` (`:string`) - Defaults to `""`.
* `dir` (`:atom`) - Defaults to `:ltr`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*