Calendar
A month of events laid out by day, with buttons to step between months.
Display
Added in v0.76.3
Updated
Default
November 2026
-
- Craft hour
{component calendar,
month: '2026-11',
events: [
['title' => 'Story time', 'href' => '#', 'date' => '2026-11-04'],
['title' => 'Book club', 'href' => '#', 'date' => '2026-11-12'],
['title' => 'Chess night', 'href' => '#', 'date' => '2026-11-12'],
['title' => 'Craft hour', 'date' => '2026-11-20'],
['title' => 'Author visit', 'href' => '#', 'date' => '2026-11-27'],
],
min: '2026-10',
max: '2027-04',
/}
month is like 2026-11, this month when empty, and events are arrays with a title, a date and an optional href. Each lands on its date, in a link when it has an href. The buttons in the header go to this month, the previous and the next, and link to href with {month} replaced (?month={month} by default). min and max disable the buttons at either end. Add hx-boost:inherited and a target to attrs to swap the calendar without a reload. Below 768px the grid becomes a list of only the days that have events.
Your own days
November 2026
- 1
- 2
{component calendar,
month: '2026-11',
week: 1,
events: [
['title' => 'Story time', 'href' => '#', 'date' => '2026-11-04'],
['title' => 'Book club', 'href' => '#', 'date' => '2026-11-12'],
['title' => 'Chess night', 'href' => '#', 'date' => '2026-11-12'],
],
}
{block day}
{if $dayEvents}
{ui badge, title: count($dayEvents), class: 'badge-outline' /}
{/if}
{/block}
{/component}
{block day} replaces what a day shows below its number. It sees $date, the day, and $dayEvents, that day's events. week: 1 starts the weeks on Monday.