Components
Calendar
Month, week, day and agenda views with event chips, a mini date picker and category filters. Radios switch views, container queries handle every width.
How it works
The calendar is a set of layout components. Your server renders the dates and events; the CSS lays them out and handles the interaction. Nothing calculates dates in the browser.
- Views are radio inputs. A checked
.calendar-view-check[value="week"]hides every element whosedata-calendar-viewdoes not listweek. This uses:has(), so view switching works anywhere tabs work. - Event placement uses inline custom properties. Month and all-day events take a column and a span. Timed events take a start and end hour. CSS grid and
calc()do the rest. - Responsive behaviour uses container queries, not media queries. Each view adapts to the width of its own box, so it behaves the same in a sidebar or a full page. Month chips turn into colour bars, the week grid scrolls and snaps one day at a time, and the agenda stacks.
- Event details are native popovers. Any chip can be a
<button popovertarget>, and one popover can serve the same event in every view. - Filters are checkboxes. Unchecking
.calendar-filter-check[value="danger"]hides every.calendar-event-dangerin the calendar.
- Baseline: CSS grid, custom properties,
:has()and size container queries (Chrome 105, Safari 16, Firefox 121). - Enhancement: anchor positioning puts event popovers next to their chip. Without it they open centred, like every popover in this theme.
- Fallback: without
:has()every view is shown, stacked. Without container queries the views keep their wide layouts and the week grid scrolls sideways.
Example
A full calendar: toolbar, view switcher, mini month, category filters, and all four views. Today is Thursday 29 October 2026. Click any event for its details. Uncheck a calendar to hide its events. Resize the window, or open the page on a phone, to see each view adapt.
29ThursdayOctober 2026 · Today
30FridayOctober 2026
31SaturdayOctober 2026
1SundayNovember 2026
2MondayNovember 2026
No bookings. Rest day.
3TuesdayNovember 2026
4WednesdayNovember 2026
Ring camp
- When
- Mon 5 Oct – Wed 7 Oct
- Where
- Performance Center
- Type
- Training
Scouting trip
- When
- Sat 24 Oct – Tue 27 Oct
- Where
- Indie shows, Ohio
- Type
- Travel
Halloween Havoc weekend
- When
- Fri 30 Oct – Sun 1 Nov
- Where
- Detroit, MI
- Type
- Shows
Merch inventory
- When
- All day
- Where
- Warehouse
- Type
- Admin
Fly to Chicago
- When
- All day
- Where
- ORD
- Type
- Travel
Thursday Night Throwdown
- When
- Thu 1 Oct, 7:00 PM – 10:00 PM
- Where
- The Armory
- Type
- Shows
Media day
- When
- Fri 2 Oct, 10:00 AM – 1:00 PM
- Where
- Studio B
- Type
- Media
Physio check
- When
- Tue 6 Oct, 9:00 AM – 10:00 AM
- Where
- Clinic
- Type
- Medical
Windy City Rumble
- When
- Sat 10 Oct, 7:00 PM – 11:00 PM
- Where
- Chicago, IL
- Type
- Shows
Booking meeting
- When
- Mon 12 Oct, 11:00 AM – 12:00 PM
- Where
- Office
- Type
- Admin
Tag team practice
- When
- Wed 14 Oct, 6:00 PM – 8:00 PM
- Where
- Gym
- Type
- Training
Friday Night RopeBreak.net
- When
- Fri 16 Oct, 8:00 PM – 11:00 PM
- Where
- The Armory
- Type
- Shows
Podcast guest spot
- When
- Mon 19 Oct, 3:00 PM – 4:00 PM
- Where
- Remote
- Type
- Media
Physio check
- When
- Tue 20 Oct, 9:00 AM – 10:00 AM
- Where
- Clinic
- Type
- Medical
Sparring
- When
- Thu 22 Oct, 10:00 AM – 12:00 PM
- Where
- Gym
- Type
- Training
Friday Night RopeBreak.net
- When
- Fri 23 Oct, 8:00 PM – 11:00 PM
- Where
- The Armory
- Type
- Shows
Ring drills
- When
- Mon 26 Oct, 9:00 AM – 11:00 AM
- Where
- Performance Center
- Type
- Training
Booking meeting
- When
- Mon 26 Oct, 11:30 AM – 12:30 PM
- Where
- Office
- Type
- Admin
Physio check
- When
- Tue 27 Oct, 8:00 AM – 9:00 AM
- Where
- Clinic
- Type
- Medical
Tag team practice
- When
- Tue 27 Oct, 10:00 AM – 12:00 PM
- Where
- Gym
- Type
- Training
Podcast taping
- When
- Tue 27 Oct, 6:00 PM – 7:00 PM
- Where
- Studio B
- Type
- Media
Cardio block
- When
- Wed 28 Oct, 9:00 AM – 10:30 AM
- Where
- Gym
- Type
- Training
Booking call
- When
- Wed 28 Oct, 9:30 AM – 11:00 AM
- Where
- Phone
- Type
- Admin · tentative
Merch design review
- When
- Wed 28 Oct, 2:00 PM – 3:00 PM
- Where
- Office
- Type
- Admin
Ring drills
- When
- Thu 29 Oct, 9:00 AM – 11:00 AM
- Where
- Performance Center
- Type
- Training
Promo taping
- When
- Thu 29 Oct, 1:00 PM – 2:00 PM
- Where
- Studio B
- Type
- Media
Radio interview
- When
- Thu 29 Oct, 1:30 PM – 2:15 PM
- Where
- WRBK 101.5
- Type
- Media
Physio check
- When
- Thu 29 Oct, 3:00 PM – 3:30 PM
- Where
- Clinic
- Type
- Medical
Thursday Night Throwdown
- When
- Thu 29 Oct, 7:00 PM – 10:00 PM
- Where
- The Armory
- Type
- Shows
Flight to Detroit
- When
- Fri 30 Oct, 7:00 AM – 9:00 AM
- Where
- DTW · Gate B12
- Type
- Travel
Venue walkthrough
- When
- Fri 30 Oct, 12:00 PM – 1:00 PM
- Where
- Little Caesars Arena
- Type
- Admin
Press scrum
- When
- Fri 30 Oct, 5:00 PM – 5:45 PM
- Where
- Media room
- Type
- Media · cancelled
Light workout
- When
- Sat 31 Oct, 10:00 AM – 11:00 AM
- Where
- Hotel gym
- Type
- Training
Meet & greet
- When
- Sat 31 Oct, 4:00 PM – 5:00 PM
- Where
- Concourse
- Type
- Media
Halloween Havoc
- When
- Sat 31 Oct, 7:00 PM – 11:00 PM
- Where
- Little Caesars Arena
- Type
- Shows
Flight home
- When
- Sun 1 Nov, 11:00 AM – 1:00 PM
- Where
- DTW → ORD
- Type
- Travel
Recovery session
- When
- Tue 3 Nov, 10:00 AM – 11:00 AM
- Where
- Clinic
- Type
- Medical
Booking meeting
- When
- Wed 4 Nov, 11:00 AM – 12:00 PM
- Where
- Office
- Type
- Admin · tentative
Thursday 29 October
Anatomy
.calendar is the shell and the container that the toolbar and layout query. Inside it,
.calendar-layout places an optional .calendar-sidebar beside
.calendar-main once the calendar is at least 52rem wide. Below that the sidebar moves under the
views. Each view is a standalone component. You can use .calendar-month,
.calendar-timegrid or .calendar-agenda without the shell.
<div class="calendar" role="region" aria-label="Talent schedule">
<div class="calendar-toolbar">
<div class="calendar-toolbar-group"><!-- prev / today / next links --></div>
<!-- One title per view; data-calendar-view shows the right one -->
<h3 class="calendar-title" data-calendar-view="month">October 2026</h3>
<h3 class="calendar-title" data-calendar-view="week">Oct 26 – Nov 1, 2026</h3>
<div class="btn-group" role="group" aria-label="Calendar view">
<input type="radio" class="btn-check calendar-view-check" name="cal-view" id="cal-month" value="month" checked>
<label class="btn btn-outline-primary" for="cal-month">Month</label>
<input type="radio" class="btn-check calendar-view-check" name="cal-view" id="cal-week" value="week">
<label class="btn btn-outline-primary" for="cal-week">Week</label>
<!-- day, agenda … -->
</div>
</div>
<div class="calendar-layout">
<aside class="calendar-sidebar"><!-- .calendar-mini, .calendar-legend --></aside>
<div class="calendar-main">
<div class="calendar-view" data-calendar-view="month"><!-- .calendar-month --></div>
<div class="calendar-view" data-calendar-view="week"><!-- .calendar-timegrid --></div>
<div class="calendar-view" data-calendar-view="day"><!-- .calendar-timegrid, 1 day --></div>
<div class="calendar-view" data-calendar-view="agenda"><!-- .calendar-agenda --></div>
</div>
</div>
</div>
data-calendar-view takes a space-separated list. data-calendar-view="week day"
shows an element in both time-grid views. Elements without the attribute are always shown. The built-in
views are day, week, month and agenda. Add more names to
$calendar-views.
Month view
.calendar-month stacks .calendar-week rows under a .calendar-weekdays
header. Each week has two layers. .calendar-days holds the seven cells and their date links.
.calendar-events is a seven-column grid laid over them. Events go in the second layer, and
dense auto-placement packs them into rows under the date numbers. A busy week grows taller; it never
overlaps.
Thursday 29 October
HTML
<div class="calendar-month">
<div class="calendar-weekdays" aria-hidden="true">
<div class="calendar-weekday">Mon</div>
<div class="calendar-weekday">Tue</div>
<div class="calendar-weekday">Wed</div>
<div class="calendar-weekday">Thu</div>
<div class="calendar-weekday">Fri</div>
<div class="calendar-weekday">Sat</div>
<div class="calendar-weekday">Sun</div>
</div>
<div class="calendar-week">
<div class="calendar-days">
<div class="calendar-day is-outside"><a class="calendar-date" href="#!" aria-label="Monday 28 September">28</a></div>
<div class="calendar-day is-outside"><a class="calendar-date" href="#!" aria-label="Tuesday 29 September">29</a></div>
<div class="calendar-day is-outside"><a class="calendar-date" href="#!" aria-label="Wednesday 30 September">30</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 1 October">1</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 2 October">2</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 3 October">3</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 4 October">4</a></div>
</div>
<div class="calendar-events">
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 1 Oct, </span><span class="calendar-event-time">7p</span><span class="calendar-event-title">Thursday Night Throwdown</span></a>
<a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 2 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Media day</span></a>
</div>
</div>
<div class="calendar-week">
<div class="calendar-days">
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 5 October">5</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 6 October">6</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 7 October">7</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 8 October">8</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 9 October">9</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 10 October">10</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 11 October">11</a></div>
</div>
<div class="calendar-events">
<a href="#!" class="calendar-event calendar-event-navy" style="--bs-calendar-col: 1; --bs-calendar-span: 3;"><span class="visually-hidden">Mon 5 Oct – Wed 7 Oct: </span><span class="calendar-event-title">Ring camp</span></a>
<a href="#!" class="calendar-event calendar-event-info" style="--bs-calendar-col: 5;"><span class="visually-hidden">All day, Fri 9 Oct: </span><span class="calendar-event-title">Fly to Chicago</span></a>
<a href="#!" class="calendar-event calendar-event-danger calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 6 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Physio check</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 10 Oct, </span><span class="calendar-event-time">7p</span><span class="calendar-event-title">Windy City Rumble</span></a>
</div>
</div>
<div class="calendar-week">
<div class="calendar-days">
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 12 October">12</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 13 October">13</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 14 October">14</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 15 October">15</a></div>
<div class="calendar-day is-selected"><a class="calendar-date" href="#!" aria-label="Friday 16 October">16</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 17 October">17</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 18 October">18</a></div>
</div>
<div class="calendar-events">
<a href="#!" class="calendar-event calendar-event-secondary" style="--bs-calendar-col: 2;"><span class="visually-hidden">All day, Tue 13 Oct: </span><span class="calendar-event-title">Merch inventory</span></a>
<a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 12 Oct, </span><span class="calendar-event-time">11a</span><span class="calendar-event-title">Booking meeting</span></a>
<a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 14 Oct, </span><span class="calendar-event-time">6p</span><span class="calendar-event-title">Tag team practice</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 16 Oct, </span><span class="calendar-event-time">8p</span><span class="calendar-event-title">Friday Night RopeBreak.net</span></a>
</div>
</div>
<div class="calendar-week">
<div class="calendar-days">
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 19 October">19</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 20 October">20</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 21 October">21</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 22 October">22</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 23 October">23</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 24 October">24</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 25 October">25</a></div>
</div>
<div class="calendar-events">
<a href="#!" class="calendar-event calendar-event-info is-continued-after" style="--bs-calendar-col: 6; --bs-calendar-span: 2;"><span class="visually-hidden">Sat 24 Oct – Tue 27 Oct: </span><span class="calendar-event-title">Scouting trip</span></a>
<a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 19 Oct, </span><span class="calendar-event-time">3p</span><span class="calendar-event-title">Podcast guest spot</span></a>
<a href="#!" class="calendar-event calendar-event-danger calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 20 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Physio check</span></a>
<a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 22 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Sparring</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 23 Oct, </span><span class="calendar-event-time">8p</span><span class="calendar-event-title">Friday Night RopeBreak.net</span></a>
</div>
</div>
<div class="calendar-week">
<div class="calendar-days">
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 26 October">26</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 27 October">27</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 28 October">28</a></div>
<div class="calendar-day is-today"><a class="calendar-date" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a></div>
<div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 30 October">30</a></div>
<div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 31 October">31</a></div>
<div class="calendar-day is-outside is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 1 November">1</a></div>
</div>
<div class="calendar-events">
<a href="#!" class="calendar-event calendar-event-info is-continued-before" style="--bs-calendar-col: 1; --bs-calendar-span: 2;"><span class="visually-hidden">Sat 24 Oct – Tue 27 Oct: </span><span class="calendar-event-title">Scouting trip</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-col: 5; --bs-calendar-span: 3;"><span class="visually-hidden">Fri 30 Oct – Sun 1 Nov: </span><span class="calendar-event-title">Halloween Havoc weekend</span></a>
<a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 26 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
<a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 26 Oct, </span><span class="calendar-event-time">11:30a</span><span class="calendar-event-title">Booking meeting</span></a>
<a href="#!" class="calendar-event calendar-event-danger calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 27 Oct, </span><span class="calendar-event-time">8a</span><span class="calendar-event-title">Physio check</span></a>
<a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 27 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Tag team practice</span></a>
<a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 27 Oct, </span><span class="calendar-event-time">6p</span><span class="calendar-event-title">Podcast taping</span></a>
<a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 28 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Cardio block</span></a>
<a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-tentative is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 28 Oct, </span><span class="calendar-event-time">9:30a</span><span class="calendar-event-title">Booking call</span></a>
<a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 28 Oct, </span><span class="calendar-event-time">2p</span><span class="calendar-event-title">Merch design review</span></a>
<a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 29 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
<a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 29 Oct, </span><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
<button type="button" class="calendar-more" style="--bs-calendar-col: 4;" popovertarget="calendar-month-more-2026-10-29">+3<span class="calendar-more-label"> more</span><span class="visually-hidden"> on Thursday 29 October</span></button>
<a href="#!" class="calendar-event calendar-event-info calendar-event-dot" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 30 Oct, </span><span class="calendar-event-time">7a</span><span class="calendar-event-title">Flight to Detroit</span></a>
<a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 30 Oct, </span><span class="calendar-event-time">12p</span><span class="calendar-event-title">Venue walkthrough</span></a>
<a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-cancelled" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 30 Oct, </span><span class="calendar-event-time">5p</span><span class="calendar-event-title">Press scrum</span></a>
<a href="#!" class="calendar-event calendar-event-navy calendar-event-dot" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 31 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Light workout</span></a>
<a href="#!" class="calendar-event calendar-event-success calendar-event-dot" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 31 Oct, </span><span class="calendar-event-time">4p</span><span class="calendar-event-title">Meet & greet</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 31 Oct, </span><span class="calendar-event-time">7p</span><span class="calendar-event-title">Halloween Havoc</span></a>
<a href="#!" class="calendar-event calendar-event-info calendar-event-dot" style="--bs-calendar-col: 7;"><span class="visually-hidden">Sun 1 Nov, </span><span class="calendar-event-time">11a</span><span class="calendar-event-title">Flight home</span></a>
</div>
</div>
</div>
<div class="popover calendar-popover fade" popover id="calendar-month-more-2026-10-29" data-bs-placement="bottom">
<div class="popover-arrow"></div>
<h4 class="popover-header">Thursday 29 October</h4>
<div class="popover-body d-grid gap-1">
<a href="#!" class="calendar-event calendar-event-navy is-past"><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
<a href="#!" class="calendar-event calendar-event-success is-past"><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
<a href="#!" class="calendar-event calendar-event-success is-past"><span class="calendar-event-time">1:30p</span><span class="calendar-event-title">Radio interview</span></a>
<a href="#!" class="calendar-event calendar-event-danger"><span class="calendar-event-time">3p</span><span class="calendar-event-title">Physio check</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid"><span class="calendar-event-time">7p</span><span class="calendar-event-title">Thursday Night Throwdown</span></a>
</div>
</div>Placing events
Set --bs-calendar-col to the weekday column (1–7) and, for multi-day events,
--bs-calendar-span to the number of days. Put spanning events first in the source so they get
the top rows. An event that crosses a week boundary is two elements, one per week, marked
.is-continued-after and .is-continued-before to square off the joined ends.
<div class="calendar-week">
<div class="calendar-days">
<div class="calendar-day is-outside"><a class="calendar-date" href="…" aria-label="Monday 28 September">28</a></div>
<div class="calendar-day is-today"><a class="calendar-date" href="…" aria-current="date">29</a></div>
<div class="calendar-day is-weekend">…</div>
<!-- 7 cells -->
</div>
<div class="calendar-events">
<a class="calendar-event calendar-event-navy" href="…" style="--bs-calendar-col: 1; --bs-calendar-span: 3;">
<span class="calendar-event-title">Ring camp</span>
</a>
<a class="calendar-event calendar-event-info is-continued-after" href="…" style="--bs-calendar-col: 6; --bs-calendar-span: 2;">…</a>
<a class="calendar-event calendar-event-danger calendar-event-dot" href="…" style="--bs-calendar-col: 2;">
<span class="calendar-event-time">9a</span><span class="calendar-event-title">Physio check</span>
</a>
<button type="button" class="calendar-more" style="--bs-calendar-col: 4;" popovertarget="more-29">
+2<span class="calendar-more-label"> more</span>
</button>
</div>
</div>
Day states
| Class | On | Effect |
|---|---|---|
.is-today | .calendar-day, .calendar-column-header, .calendar-mini-day | Gold date badge. Also add aria-current="date" to the date link. |
.is-outside | Day cell, mini day | A day from the previous or next month. Shaded, with a muted number. |
.is-weekend | Day cell, time-grid column | Light shading. |
.is-selected | Day cell, mini day | Gold ring (month) or navy fill (mini). |
.is-disabled | Day cell, mini day | Hatched, struck through, not clickable. |
"More" overflow
The calendar does not count events for you. When a day has more than fits, render the first few and a
.calendar-more button. Give it the same --bs-calendar-col and point it at a
popover that lists the whole day. In narrow months the label shrinks to "+2". Thursday 29 above has one.
Week view
.calendar-timegrid is a scroll box with a sticky head (column headers and an all-day row) and
a body of hour columns. Set --bs-calendar-days, --bs-calendar-day-start and
--bs-calendar-day-end on it. The grid draws hour and half-hour lines, and sizes every column
from --bs-calendar-hour-height.
HTML
<div class="calendar-timegrid" style="--bs-calendar-days: 7; --bs-calendar-day-start: 7; --bs-calendar-day-end: 23;" tabindex="0" role="region" aria-label="Week of October 26">
<div class="calendar-timegrid-head">
<div class="calendar-timegrid-row">
<div class="calendar-timegrid-corner">CDT</div>
<div class="calendar-column-header"><span class="calendar-column-weekday">Mon</span><a class="calendar-date" href="#!" aria-label="Monday 26 October">26</a></div>
<div class="calendar-column-header"><span class="calendar-column-weekday">Tue</span><a class="calendar-date" href="#!" aria-label="Tuesday 27 October">27</a></div>
<div class="calendar-column-header"><span class="calendar-column-weekday">Wed</span><a class="calendar-date" href="#!" aria-label="Wednesday 28 October">28</a></div>
<div class="calendar-column-header is-today"><span class="calendar-column-weekday">Thu</span><a class="calendar-date" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a></div>
<div class="calendar-column-header"><span class="calendar-column-weekday">Fri</span><a class="calendar-date" href="#!" aria-label="Friday 30 October">30</a></div>
<div class="calendar-column-header"><span class="calendar-column-weekday">Sat</span><a class="calendar-date" href="#!" aria-label="Saturday 31 October">31</a></div>
<div class="calendar-column-header"><span class="calendar-column-weekday">Sun</span><a class="calendar-date" href="#!" aria-label="Sunday 1 November">1</a></div>
</div>
<div class="calendar-allday">
<div class="calendar-allday-label">All day</div>
<div class="calendar-allday-events">
<a href="#!" class="calendar-event calendar-event-info is-continued-before" style="--bs-calendar-col: 1; --bs-calendar-span: 2;"><span class="visually-hidden">Sat 24 Oct – Tue 27 Oct: </span><span class="calendar-event-title">Scouting trip</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-col: 5; --bs-calendar-span: 3;"><span class="visually-hidden">Fri 30 Oct – Sun 1 Nov: </span><span class="calendar-event-title">Halloween Havoc weekend</span></a>
</div>
</div>
</div>
<div class="calendar-timegrid-body">
<div class="calendar-times" aria-hidden="true">
<div class="calendar-time">7 AM</div>
<div class="calendar-time">8 AM</div>
<div class="calendar-time">9 AM</div>
<div class="calendar-time">10 AM</div>
<div class="calendar-time">11 AM</div>
<div class="calendar-time">12 PM</div>
<div class="calendar-time">1 PM</div>
<div class="calendar-time">2 PM</div>
<div class="calendar-time">3 PM</div>
<div class="calendar-time">4 PM</div>
<div class="calendar-time">5 PM</div>
<div class="calendar-time">6 PM</div>
<div class="calendar-time">7 PM</div>
<div class="calendar-time">8 PM</div>
<div class="calendar-time">9 PM</div>
<div class="calendar-time">10 PM</div>
</div>
<div class="calendar-column" role="group" aria-label="Monday 26 October">
<a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 11;"><span class="calendar-event-title">Ring drills</span><span class="calendar-event-time"><time datetime="2026-10-26T09:00">9:00 AM</time> – <time datetime="2026-10-26T11:00">11:00 AM</time></span><span class="calendar-event-meta">Performance Center</span></a>
<a href="#!" class="calendar-event calendar-event-secondary is-past" style="--bs-calendar-start: 11.5; --bs-calendar-end: 12.5;"><span class="calendar-event-title">Booking meeting</span><span class="calendar-event-time"><time datetime="2026-10-26T11:30">11:30 AM</time> – <time datetime="2026-10-26T12:30">12:30 PM</time></span><span class="calendar-event-meta">Office</span></a>
</div>
<div class="calendar-column" role="group" aria-label="Tuesday 27 October">
<a href="#!" class="calendar-event calendar-event-danger is-past" style="--bs-calendar-start: 8; --bs-calendar-end: 9;"><span class="calendar-event-title">Physio check</span><span class="calendar-event-time"><time datetime="2026-10-27T08:00">8:00 AM</time> – <time datetime="2026-10-27T09:00">9:00 AM</time></span><span class="calendar-event-meta">Clinic</span></a>
<a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 10; --bs-calendar-end: 12;"><span class="calendar-event-title">Tag team practice</span><span class="calendar-event-time"><time datetime="2026-10-27T10:00">10:00 AM</time> – <time datetime="2026-10-27T12:00">12:00 PM</time></span><span class="calendar-event-meta">Gym</span></a>
<a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 18; --bs-calendar-end: 19;"><span class="calendar-event-title">Podcast taping</span><span class="calendar-event-time"><time datetime="2026-10-27T18:00">6:00 PM</time> – <time datetime="2026-10-27T19:00">7:00 PM</time></span><span class="calendar-event-meta">Studio B</span></a>
</div>
<div class="calendar-column" role="group" aria-label="Wednesday 28 October">
<a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 10.5; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Cardio block</span><span class="calendar-event-time"><time datetime="2026-10-28T09:00">9:00 AM</time> – <time datetime="2026-10-28T10:30">10:30 AM</time></span><span class="calendar-event-meta">Gym</span></a>
<a href="#!" class="calendar-event calendar-event-secondary is-tentative is-past" style="--bs-calendar-start: 9.5; --bs-calendar-end: 11; --bs-calendar-lane: 1; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Booking call</span><span class="calendar-event-time"><time datetime="2026-10-28T09:30">9:30 AM</time> – <time datetime="2026-10-28T11:00">11:00 AM</time></span><span class="calendar-event-meta">Phone</span></a>
<a href="#!" class="calendar-event calendar-event-secondary is-past" style="--bs-calendar-start: 14; --bs-calendar-end: 15;"><span class="calendar-event-title">Merch design review</span><span class="calendar-event-time"><time datetime="2026-10-28T14:00">2:00 PM</time> – <time datetime="2026-10-28T15:00">3:00 PM</time></span><span class="calendar-event-meta">Office</span></a>
</div>
<div class="calendar-column is-today" role="group" aria-label="Thursday 29 October">
<a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 11;"><span class="calendar-event-title">Ring drills</span><span class="calendar-event-time"><time datetime="2026-10-29T09:00">9:00 AM</time> – <time datetime="2026-10-29T11:00">11:00 AM</time></span><span class="calendar-event-meta">Performance Center</span></a>
<a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13; --bs-calendar-end: 14; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Promo taping</span><span class="calendar-event-time"><time datetime="2026-10-29T13:00">1:00 PM</time> – <time datetime="2026-10-29T14:00">2:00 PM</time></span><span class="calendar-event-meta">Studio B</span></a>
<a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13.5; --bs-calendar-end: 14.25; --bs-calendar-lane: 1; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Radio interview</span><span class="calendar-event-time"><time datetime="2026-10-29T13:30">1:30 PM</time> – <time datetime="2026-10-29T14:15">2:15 PM</time></span><span class="calendar-event-meta">WRBK 101.5</span></a>
<a href="#!" class="calendar-event calendar-event-danger" style="--bs-calendar-start: 15; --bs-calendar-end: 15.5;"><span class="calendar-event-title">Physio check</span><span class="calendar-event-time"><time datetime="2026-10-29T15:00">3:00 PM</time> – <time datetime="2026-10-29T15:30">3:30 PM</time></span><span class="calendar-event-meta">Clinic</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-start: 19; --bs-calendar-end: 22;"><span class="calendar-event-title">Thursday Night Throwdown</span><span class="calendar-event-time"><time datetime="2026-10-29T19:00">7:00 PM</time> – <time datetime="2026-10-29T22:00">10:00 PM</time></span><span class="calendar-event-meta">The Armory</span></a>
<div class="calendar-now" style="--bs-calendar-start: 14.5;" role="presentation" title="Now, 2:30 PM"></div>
</div>
<div class="calendar-column" role="group" aria-label="Friday 30 October">
<a href="#!" class="calendar-event calendar-event-info" style="--bs-calendar-start: 7; --bs-calendar-end: 9;"><span class="calendar-event-title">Flight to Detroit</span><span class="calendar-event-time"><time datetime="2026-10-30T07:00">7:00 AM</time> – <time datetime="2026-10-30T09:00">9:00 AM</time></span><span class="calendar-event-meta">DTW · Gate B12</span></a>
<a href="#!" class="calendar-event calendar-event-secondary" style="--bs-calendar-start: 12; --bs-calendar-end: 13;"><span class="calendar-event-title">Venue walkthrough</span><span class="calendar-event-time"><time datetime="2026-10-30T12:00">12:00 PM</time> – <time datetime="2026-10-30T13:00">1:00 PM</time></span><span class="calendar-event-meta">Little Caesars Arena</span></a>
<a href="#!" class="calendar-event calendar-event-success is-cancelled" style="--bs-calendar-start: 17; --bs-calendar-end: 17.75;"><span class="calendar-event-title">Press scrum</span><span class="calendar-event-time"><time datetime="2026-10-30T17:00">5:00 PM</time> – <time datetime="2026-10-30T17:45">5:45 PM</time></span><span class="calendar-event-meta">Media room</span></a>
</div>
<div class="calendar-column is-weekend" role="group" aria-label="Saturday 31 October">
<a href="#!" class="calendar-event calendar-event-navy" style="--bs-calendar-start: 10; --bs-calendar-end: 11;"><span class="calendar-event-title">Light workout</span><span class="calendar-event-time"><time datetime="2026-10-31T10:00">10:00 AM</time> – <time datetime="2026-10-31T11:00">11:00 AM</time></span><span class="calendar-event-meta">Hotel gym</span></a>
<a href="#!" class="calendar-event calendar-event-success" style="--bs-calendar-start: 16; --bs-calendar-end: 17;"><span class="calendar-event-title">Meet & greet</span><span class="calendar-event-time"><time datetime="2026-10-31T16:00">4:00 PM</time> – <time datetime="2026-10-31T17:00">5:00 PM</time></span><span class="calendar-event-meta">Concourse</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-start: 19; --bs-calendar-end: 23;"><span class="calendar-event-title">Halloween Havoc</span><span class="calendar-event-time"><time datetime="2026-10-31T19:00">7:00 PM</time> – <time datetime="2026-10-31T23:00">11:00 PM</time></span><span class="calendar-event-meta">Little Caesars Arena</span></a>
</div>
<div class="calendar-column is-weekend" role="group" aria-label="Sunday 1 November">
<a href="#!" class="calendar-event calendar-event-info" style="--bs-calendar-start: 11; --bs-calendar-end: 13;"><span class="calendar-event-title">Flight home</span><span class="calendar-event-time"><time datetime="2026-11-01T11:00">11:00 AM</time> – <time datetime="2026-11-01T13:00">1:00 PM</time></span><span class="calendar-event-meta">DTW → ORD</span></a>
</div>
</div>
</div>Timed events
A timed event is a .calendar-event inside a .calendar-column.
--bs-calendar-start and --bs-calendar-end take decimal hours: 13.5 is 1:30 PM.
Events can show a title, a .calendar-event-time and a .calendar-event-meta line. Each event is
a size container, so short events drop the meta line and very short ones drop the time too.
<div class="calendar-timegrid" style="--bs-calendar-days: 7; --bs-calendar-day-start: 7; --bs-calendar-day-end: 23;"
tabindex="0" role="region" aria-label="Week of October 26">
<div class="calendar-timegrid-head">
<div class="calendar-timegrid-row">
<div class="calendar-timegrid-corner">CDT</div>
<div class="calendar-column-header is-today">
<span class="calendar-column-weekday">Thu</span>
<a class="calendar-date" href="…" aria-current="date">29</a>
</div>
<!-- one header per day -->
</div>
<div class="calendar-allday">
<div class="calendar-allday-label">All day</div>
<div class="calendar-allday-events">
<a class="calendar-event calendar-event-primary calendar-event-solid" href="…"
style="--bs-calendar-col: 5; --bs-calendar-span: 3;">…</a>
</div>
</div>
</div>
<div class="calendar-timegrid-body">
<div class="calendar-times" aria-hidden="true">
<div class="calendar-time">7 AM</div>
<!-- one label per hour -->
</div>
<div class="calendar-column is-today" role="group" aria-label="Thursday 29 October">
<a class="calendar-event calendar-event-success" href="…"
style="--bs-calendar-start: 13; --bs-calendar-end: 14; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;">
<span class="calendar-event-title">Promo taping</span>
<span class="calendar-event-time">1:00 PM – 2:00 PM</span>
<span class="calendar-event-meta">Studio B</span>
</a>
<div class="calendar-now" style="--bs-calendar-start: 14.5;" role="presentation"></div>
</div>
<!-- one column per day -->
</div>
</div>
Overlapping events
Events that overlap share the column in lanes. Give each one --bs-calendar-lanes (how many
share the slot) and --bs-calendar-lane (its position, from 0). Your server already knows which
events collide, so it can assign lanes. Wednesday and Thursday above both have a two-lane overlap.
Now indicator
.calendar-now draws the red current-time line at --bs-calendar-start. It shows
the time when the page was rendered and does not move. Put it in today's column only.
Day view
The day view is the same time grid with --bs-calendar-days: 1. With more room per event, a
taller --bs-calendar-hour-height lets each one show its location.
HTML
<div class="calendar-timegrid" style="--bs-calendar-days: 1; --bs-calendar-day-start: 7; --bs-calendar-day-end: 23; --bs-calendar-hour-height: 3.5rem;" tabindex="0" role="region" aria-label="Thursday 29 October">
<div class="calendar-timegrid-head">
<div class="calendar-timegrid-row">
<div class="calendar-timegrid-corner">CDT</div>
<div class="calendar-column-header is-today"><span class="calendar-column-weekday">Thu</span><a class="calendar-date" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a></div>
</div>
<div class="calendar-allday">
<div class="calendar-allday-label">All day</div>
<div class="calendar-allday-events">
</div>
</div>
</div>
<div class="calendar-timegrid-body">
<div class="calendar-times" aria-hidden="true">
<div class="calendar-time">7 AM</div>
<div class="calendar-time">8 AM</div>
<div class="calendar-time">9 AM</div>
<div class="calendar-time">10 AM</div>
<div class="calendar-time">11 AM</div>
<div class="calendar-time">12 PM</div>
<div class="calendar-time">1 PM</div>
<div class="calendar-time">2 PM</div>
<div class="calendar-time">3 PM</div>
<div class="calendar-time">4 PM</div>
<div class="calendar-time">5 PM</div>
<div class="calendar-time">6 PM</div>
<div class="calendar-time">7 PM</div>
<div class="calendar-time">8 PM</div>
<div class="calendar-time">9 PM</div>
<div class="calendar-time">10 PM</div>
</div>
<div class="calendar-column is-today" role="group" aria-label="Thursday 29 October">
<a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 11;"><span class="calendar-event-title">Ring drills</span><span class="calendar-event-time"><time datetime="2026-10-29T09:00">9:00 AM</time> – <time datetime="2026-10-29T11:00">11:00 AM</time></span><span class="calendar-event-meta">Performance Center</span></a>
<a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13; --bs-calendar-end: 14; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Promo taping</span><span class="calendar-event-time"><time datetime="2026-10-29T13:00">1:00 PM</time> – <time datetime="2026-10-29T14:00">2:00 PM</time></span><span class="calendar-event-meta">Studio B</span></a>
<a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13.5; --bs-calendar-end: 14.25; --bs-calendar-lane: 1; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Radio interview</span><span class="calendar-event-time"><time datetime="2026-10-29T13:30">1:30 PM</time> – <time datetime="2026-10-29T14:15">2:15 PM</time></span><span class="calendar-event-meta">WRBK 101.5</span></a>
<a href="#!" class="calendar-event calendar-event-danger" style="--bs-calendar-start: 15; --bs-calendar-end: 15.5;"><span class="calendar-event-title">Physio check</span><span class="calendar-event-time"><time datetime="2026-10-29T15:00">3:00 PM</time> – <time datetime="2026-10-29T15:30">3:30 PM</time></span><span class="calendar-event-meta">Clinic</span></a>
<a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-start: 19; --bs-calendar-end: 22;"><span class="calendar-event-title">Thursday Night Throwdown</span><span class="calendar-event-time"><time datetime="2026-10-29T19:00">7:00 PM</time> – <time datetime="2026-10-29T22:00">10:00 PM</time></span><span class="calendar-event-meta">The Armory</span></a>
<div class="calendar-now" style="--bs-calendar-start: 14.5;" role="presentation" title="Now, 2:30 PM"></div>
</div>
</div>
</div>Agenda view
.calendar-agenda is a list of days. Each .calendar-agenda-day has a sticky date
heading beside its events. Below 36rem the heading becomes a bar across the top. Each
.calendar-agenda-item is a link or button with a time column, a title and meta line, and an
optional badge at the end. Empty days take a .calendar-agenda-empty line. The agenda is the
most screen-reader-friendly view, so consider making it the default on small screens.
29ThursdayOctober 2026 · Today
30FridayOctober 2026
31SaturdayOctober 2026
1SundayNovember 2026
2MondayNovember 2026
No bookings. Rest day.
3TuesdayNovember 2026
4WednesdayNovember 2026
HTML
<div class="calendar-agenda">
<section class="calendar-agenda-day is-today" aria-labelledby="calendar-agenda-day-2026-10-29">
<h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-10-29"><span class="calendar-date" aria-current="date">29</span><span class="calendar-agenda-dayname">Thursday<small>October 2026 · Today</small></span></h4>
<ul class="calendar-agenda-list">
<li><a href="#!" class="calendar-agenda-item calendar-event-navy"><span class="calendar-agenda-time"><time datetime="2026-10-29T09:00">9:00 AM</time><span>– <time datetime="2026-10-29T11:00">11:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Ring drills</span><span class="calendar-agenda-meta">Performance Center</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-success"><span class="calendar-agenda-time"><time datetime="2026-10-29T13:00">1:00 PM</time><span>– <time datetime="2026-10-29T14:00">2:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Promo taping</span><span class="calendar-agenda-meta">Studio B</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-success"><span class="calendar-agenda-time"><time datetime="2026-10-29T13:30">1:30 PM</time><span>– <time datetime="2026-10-29T14:15">2:15 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Radio interview</span><span class="calendar-agenda-meta">WRBK 101.5</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-danger"><span class="calendar-agenda-time"><time datetime="2026-10-29T15:00">3:00 PM</time><span>– <time datetime="2026-10-29T15:30">3:30 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Physio check</span><span class="calendar-agenda-meta">Clinic</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><time datetime="2026-10-29T19:00">7:00 PM</time><span>– <time datetime="2026-10-29T22:00">10:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Thursday Night Throwdown</span><span class="calendar-agenda-meta">The Armory</span></span><span class="badge text-bg-primary">Live</span></a></li>
</ul>
</section>
<section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-10-30">
<h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-10-30"><span class="calendar-date">30</span><span class="calendar-agenda-dayname">Friday<small>October 2026</small></span></h4>
<ul class="calendar-agenda-list">
<li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><span>All day</span><span>Day 1 of 3</span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc weekend</span><span class="calendar-agenda-meta">Detroit, MI</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-info"><span class="calendar-agenda-time"><time datetime="2026-10-30T07:00">7:00 AM</time><span>– <time datetime="2026-10-30T09:00">9:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Flight to Detroit</span><span class="calendar-agenda-meta">DTW · Gate B12</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-secondary"><span class="calendar-agenda-time"><time datetime="2026-10-30T12:00">12:00 PM</time><span>– <time datetime="2026-10-30T13:00">1:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Venue walkthrough</span><span class="calendar-agenda-meta">Little Caesars Arena</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-success is-cancelled"><span class="calendar-agenda-time"><time datetime="2026-10-30T17:00">5:00 PM</time><span>– <time datetime="2026-10-30T17:45">5:45 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Press scrum</span><span class="calendar-agenda-meta">Media room</span></span><span class="badge text-bg-danger">Cancelled</span></a></li>
</ul>
</section>
<section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-10-31">
<h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-10-31"><span class="calendar-date">31</span><span class="calendar-agenda-dayname">Saturday<small>October 2026</small></span></h4>
<ul class="calendar-agenda-list">
<li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><span>All day</span><span>Day 2 of 3</span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc weekend</span><span class="calendar-agenda-meta">Detroit, MI</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-navy"><span class="calendar-agenda-time"><time datetime="2026-10-31T10:00">10:00 AM</time><span>– <time datetime="2026-10-31T11:00">11:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Light workout</span><span class="calendar-agenda-meta">Hotel gym</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-success"><span class="calendar-agenda-time"><time datetime="2026-10-31T16:00">4:00 PM</time><span>– <time datetime="2026-10-31T17:00">5:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Meet & greet</span><span class="calendar-agenda-meta">Concourse</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><time datetime="2026-10-31T19:00">7:00 PM</time><span>– <time datetime="2026-10-31T23:00">11:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc</span><span class="calendar-agenda-meta">Little Caesars Arena</span></span><span class="badge text-bg-primary">Live</span></a></li>
</ul>
</section>
<section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-01">
<h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-01"><span class="calendar-date">1</span><span class="calendar-agenda-dayname">Sunday<small>November 2026</small></span></h4>
<ul class="calendar-agenda-list">
<li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><span>All day</span><span>Day 3 of 3</span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc weekend</span><span class="calendar-agenda-meta">Detroit, MI</span></span></a></li>
<li><a href="#!" class="calendar-agenda-item calendar-event-info"><span class="calendar-agenda-time"><time datetime="2026-11-01T11:00">11:00 AM</time><span>– <time datetime="2026-11-01T13:00">1:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Flight home</span><span class="calendar-agenda-meta">DTW → ORD</span></span></a></li>
</ul>
</section>
<section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-02">
<h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-02"><span class="calendar-date">2</span><span class="calendar-agenda-dayname">Monday<small>November 2026</small></span></h4>
<p class="calendar-agenda-empty">No bookings. Rest day.</p>
</section>
<section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-03">
<h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-03"><span class="calendar-date">3</span><span class="calendar-agenda-dayname">Tuesday<small>November 2026</small></span></h4>
<ul class="calendar-agenda-list">
<li><a href="#!" class="calendar-agenda-item calendar-event-danger"><span class="calendar-agenda-time"><time datetime="2026-11-03T10:00">10:00 AM</time><span>– <time datetime="2026-11-03T11:00">11:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Recovery session</span><span class="calendar-agenda-meta">Clinic</span></span></a></li>
</ul>
</section>
<section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-04">
<h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-04"><span class="calendar-date">4</span><span class="calendar-agenda-dayname">Wednesday<small>November 2026</small></span></h4>
<ul class="calendar-agenda-list">
<li><a href="#!" class="calendar-agenda-item calendar-event-secondary is-tentative"><span class="calendar-agenda-time"><time datetime="2026-11-04T11:00">11:00 AM</time><span>– <time datetime="2026-11-04T12:00">12:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Booking meeting</span><span class="calendar-agenda-meta">Office</span></span><span class="badge text-bg-secondary">Tentative</span></a></li>
</ul>
</section>
</div><div class="calendar-agenda">
<section class="calendar-agenda-day is-today" aria-labelledby="agenda-2026-10-29">
<h4 class="calendar-agenda-date" id="agenda-2026-10-29">
<span class="calendar-date" aria-current="date">29</span>
<span class="calendar-agenda-dayname">Thursday<small>October 2026 · Today</small></span>
</h4>
<ul class="calendar-agenda-list">
<li>
<a class="calendar-agenda-item calendar-event-primary" href="…">
<span class="calendar-agenda-time"><time datetime="2026-10-29T19:00">7:00 PM</time><span>– 10:00 PM</span></span>
<span class="calendar-agenda-body">
<span class="calendar-agenda-title">Thursday Night Throwdown</span>
<span class="calendar-agenda-meta">The Armory</span>
</span>
<span class="badge text-bg-primary">Live</span>
</a>
</li>
</ul>
</section>
</div>
Set --bs-calendar-agenda-sticky-top when the page has a sticky header, so date headings stop
below it.
Events
.calendar-event is the chip used in every view. It is a link, a button or plain text. Add a
.calendar-event-{color} class for any theme colour, including gold,
navy and cream.
Colours
HTML
<a class="calendar-event calendar-event-primary" href="#!"><span class="calendar-event-time">7p</span><span class="calendar-event-title">Main event</span></a>
<a class="calendar-event calendar-event-navy" href="#!"><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
<a class="calendar-event calendar-event-gold" href="#!"><span class="calendar-event-time">4p</span><span class="calendar-event-title">Title presentation</span></a>
<a class="calendar-event calendar-event-success" href="#!"><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
<a class="calendar-event calendar-event-info" href="#!"><span class="calendar-event-time">7a</span><span class="calendar-event-title">Flight to Detroit</span></a>
<a class="calendar-event calendar-event-warning" href="#!"><span class="calendar-event-time">2p</span><span class="calendar-event-title">Contract review</span></a>
<a class="calendar-event calendar-event-danger" href="#!"><span class="calendar-event-time">3p</span><span class="calendar-event-title">Physio check</span></a>
<a class="calendar-event calendar-event-secondary" href="#!"><span class="calendar-event-time">11a</span><span class="calendar-event-title">Booking meeting</span></a>
<a class="calendar-event" href="#!"><span class="calendar-event-time">6p</span><span class="calendar-event-title">No colour class</span></a>Styles
.calendar-event-solid fills the chip with the accent colour, which suits headline events.
.calendar-event-dot drops the fill for a leading dot, which keeps busy month cells readable.
The month view above uses solid chips for shows and dots for other timed events.
HTML
<a class="calendar-event calendar-event-primary calendar-event-solid" href="#!"><span class="calendar-event-time">7p</span><span class="calendar-event-title">Halloween Havoc</span></a>
<a class="calendar-event calendar-event-navy calendar-event-solid" href="#!"><span class="calendar-event-title">Ring camp</span></a>
<a class="calendar-event calendar-event-danger calendar-event-solid" href="#!"><span class="calendar-event-title">Injury report due</span></a>
<a class="calendar-event calendar-event-success calendar-event-dot" href="#!"><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
<a class="calendar-event calendar-event-info calendar-event-dot" href="#!"><span class="calendar-event-time">7a</span><span class="calendar-event-title">Flight to Detroit</span></a>States
| Class | Effect |
|---|---|
.is-tentative | Hatched fill and a dashed accent edge. |
.is-cancelled | Struck-through title, faded. |
.is-past | Faded. The month and week examples above mark everything before 2:30 PM today. |
.is-continued-before / .is-continued-after | Square ends for multi-day events cut by a week edge. |
HTML
<a class="calendar-event calendar-event-secondary is-tentative" href="#!"><span class="calendar-event-time">11a</span><span class="calendar-event-title">Booking call (maybe)</span></a>
<a class="calendar-event calendar-event-success is-cancelled" href="#!"><span class="calendar-event-time">5p</span><span class="calendar-event-title">Press scrum</span></a>
<a class="calendar-event calendar-event-navy is-past" href="#!"><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>Event details
Make the chip a <button popovertarget> and give the popover
.calendar-popover plus the event's colour class. The header takes the colour as an accent
edge, and .calendar-event-details lays out a <dl>. Several chips can open the
same popover. In the full example above, the month, week, day and agenda entries for an event all share
one.
Thursday Night Throwdown
- When
- Thu 29 Oct, 7:00 PM – 10:00 PM
- Where
- The Armory
- Card
- Six matches, title on the line
HTML
<button type="button" class="calendar-event calendar-event-primary calendar-event-solid" popovertarget="calendar-details-demo" style="max-width: 16rem;">
<span class="calendar-event-time">7p</span><span class="calendar-event-title">Thursday Night Throwdown</span>
</button>
<div class="popover calendar-popover calendar-event-primary fade" popover id="calendar-details-demo" data-bs-placement="bottom">
<div class="popover-arrow"></div>
<h4 class="popover-header">Thursday Night Throwdown</h4>
<div class="popover-body">
<dl class="calendar-event-details">
<dt>When</dt><dd>Thu 29 Oct, 7:00 PM – 10:00 PM</dd>
<dt>Where</dt><dd>The Armory</dd>
<dt>Card</dt><dd>Six matches, title on the line</dd>
</dl>
<div class="d-flex gap-2 mt-3">
<a class="btn btn-sm btn-primary" href="#!">Open event</a>
<button type="button" class="btn btn-sm btn-outline-secondary" popovertarget="calendar-details-demo" popovertargetaction="hide">Close</button>
</div>
</div>
</div>Mini calendar
.calendar-mini is a compact month for sidebars and forms. With links it navigates. Add
.has-events for a dot under busy days.
HTML
<div class="calendar-mini">
<div class="calendar-mini-header">
<a class="calendar-mini-nav" href="#!" aria-label="Previous month">‹</a>
<h4 class="calendar-mini-title">October 2026</h4>
<a class="calendar-mini-nav" href="#!" aria-label="Next month">›</a>
</div>
<div class="calendar-mini-grid">
<span class="calendar-mini-weekday" aria-hidden="true">M</span>
<span class="calendar-mini-weekday" aria-hidden="true">T</span>
<span class="calendar-mini-weekday" aria-hidden="true">W</span>
<span class="calendar-mini-weekday" aria-hidden="true">T</span>
<span class="calendar-mini-weekday" aria-hidden="true">F</span>
<span class="calendar-mini-weekday" aria-hidden="true">S</span>
<span class="calendar-mini-weekday" aria-hidden="true">S</span>
<a class="calendar-mini-day is-outside" href="#!" aria-label="Monday 28 September">28</a>
<a class="calendar-mini-day is-outside" href="#!" aria-label="Tuesday 29 September">29</a>
<a class="calendar-mini-day is-outside" href="#!" aria-label="Wednesday 30 September">30</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 1 October">1</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 2 October">2</a>
<a class="calendar-mini-day" href="#!" aria-label="Saturday 3 October">3</a>
<a class="calendar-mini-day" href="#!" aria-label="Sunday 4 October">4</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Monday 5 October">5</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 6 October">6</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 7 October">7</a>
<a class="calendar-mini-day" href="#!" aria-label="Thursday 8 October">8</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 9 October">9</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 10 October">10</a>
<a class="calendar-mini-day" href="#!" aria-label="Sunday 11 October">11</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Monday 12 October">12</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 13 October">13</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 14 October">14</a>
<a class="calendar-mini-day" href="#!" aria-label="Thursday 15 October">15</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 16 October">16</a>
<a class="calendar-mini-day" href="#!" aria-label="Saturday 17 October">17</a>
<a class="calendar-mini-day" href="#!" aria-label="Sunday 18 October">18</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Monday 19 October">19</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 20 October">20</a>
<a class="calendar-mini-day" href="#!" aria-label="Wednesday 21 October">21</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 22 October">22</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 23 October">23</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 24 October">24</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Sunday 25 October">25</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Monday 26 October">26</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 27 October">27</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 28 October">28</a>
<a class="calendar-mini-day is-today is-selected has-events" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 30 October">30</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 31 October">31</a>
<a class="calendar-mini-day is-outside has-events" href="#!" aria-label="Sunday 1 November">1</a>
</div>
</div>
<div class="calendar-mini">
<div class="calendar-mini-header">
<a class="calendar-mini-nav" href="#!" aria-label="Previous month">‹</a>
<h4 class="calendar-mini-title">October 2026</h4>
<a class="calendar-mini-nav" href="#!" aria-label="Next month">›</a>
</div>
<div class="calendar-mini-grid">
<span class="calendar-mini-weekday" aria-hidden="true">M</span>
<span class="calendar-mini-weekday" aria-hidden="true">T</span>
<span class="calendar-mini-weekday" aria-hidden="true">W</span>
<span class="calendar-mini-weekday" aria-hidden="true">T</span>
<span class="calendar-mini-weekday" aria-hidden="true">F</span>
<span class="calendar-mini-weekday" aria-hidden="true">S</span>
<span class="calendar-mini-weekday" aria-hidden="true">S</span>
<a class="calendar-mini-day is-outside" href="#!" aria-label="Monday 28 September">28</a>
<a class="calendar-mini-day is-outside" href="#!" aria-label="Tuesday 29 September">29</a>
<a class="calendar-mini-day is-outside" href="#!" aria-label="Wednesday 30 September">30</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 1 October">1</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 2 October">2</a>
<a class="calendar-mini-day" href="#!" aria-label="Saturday 3 October">3</a>
<a class="calendar-mini-day" href="#!" aria-label="Sunday 4 October">4</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Monday 5 October">5</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 6 October">6</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 7 October">7</a>
<a class="calendar-mini-day" href="#!" aria-label="Thursday 8 October">8</a>
<a class="calendar-mini-day is-selected has-events" href="#!" aria-label="Friday 9 October">9</a>
<a class="calendar-mini-day is-in-range has-events" href="#!" aria-label="Saturday 10 October">10</a>
<a class="calendar-mini-day is-in-range" href="#!" aria-label="Sunday 11 October">11</a>
<a class="calendar-mini-day is-in-range has-events" href="#!" aria-label="Monday 12 October">12</a>
<a class="calendar-mini-day is-selected has-events" href="#!" aria-label="Tuesday 13 October">13</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 14 October">14</a>
<a class="calendar-mini-day" href="#!" aria-label="Thursday 15 October">15</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 16 October">16</a>
<a class="calendar-mini-day" href="#!" aria-label="Saturday 17 October">17</a>
<a class="calendar-mini-day" href="#!" aria-label="Sunday 18 October">18</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Monday 19 October">19</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 20 October">20</a>
<a class="calendar-mini-day" href="#!" aria-label="Wednesday 21 October">21</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 22 October">22</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 23 October">23</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 24 October">24</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Sunday 25 October">25</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Monday 26 October">26</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 27 October">27</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 28 October">28</a>
<a class="calendar-mini-day is-today has-events" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Friday 30 October">30</a>
<a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 31 October">31</a>
<a class="calendar-mini-day is-outside has-events" href="#!" aria-label="Sunday 1 November">1</a>
</div>
</div>Date picker
Wrap a radio in each <label class="calendar-mini-day"> and the mini calendar becomes a
form control. The checked date gets the navy fill, arrow keys move between dates, and the form submits the
value. Disabled radios grey their day out; here every day before today is disabled.
HTML
<form class="d-inline-flex flex-column gap-3" action="#!">
<div class="calendar-mini">
<div class="calendar-mini-header">
<a class="calendar-mini-nav" href="#!" aria-label="Previous month">‹</a>
<h4 class="calendar-mini-title">October 2026</h4>
<a class="calendar-mini-nav" href="#!" aria-label="Next month">›</a>
</div>
<fieldset class="calendar-mini-grid">
<legend class="visually-hidden">Pick a date</legend>
<span class="calendar-mini-weekday" aria-hidden="true">M</span>
<span class="calendar-mini-weekday" aria-hidden="true">T</span>
<span class="calendar-mini-weekday" aria-hidden="true">W</span>
<span class="calendar-mini-weekday" aria-hidden="true">T</span>
<span class="calendar-mini-weekday" aria-hidden="true">F</span>
<span class="calendar-mini-weekday" aria-hidden="true">S</span>
<span class="calendar-mini-weekday" aria-hidden="true">S</span>
<label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-09-28" aria-label="Monday 28 September" disabled>28</label>
<label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-09-29" aria-label="Tuesday 29 September" disabled>29</label>
<label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-09-30" aria-label="Wednesday 30 September" disabled>30</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-01" aria-label="Thursday 1 October" disabled>1</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-02" aria-label="Friday 2 October" disabled>2</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-03" aria-label="Saturday 3 October" disabled>3</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-04" aria-label="Sunday 4 October" disabled>4</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-05" aria-label="Monday 5 October" disabled>5</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-06" aria-label="Tuesday 6 October" disabled>6</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-07" aria-label="Wednesday 7 October" disabled>7</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-08" aria-label="Thursday 8 October" disabled>8</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-09" aria-label="Friday 9 October" disabled>9</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-10" aria-label="Saturday 10 October" disabled>10</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-11" aria-label="Sunday 11 October" disabled>11</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-12" aria-label="Monday 12 October" disabled>12</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-13" aria-label="Tuesday 13 October" disabled>13</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-14" aria-label="Wednesday 14 October" disabled>14</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-15" aria-label="Thursday 15 October" disabled>15</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-16" aria-label="Friday 16 October" disabled>16</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-17" aria-label="Saturday 17 October" disabled>17</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-18" aria-label="Sunday 18 October" disabled>18</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-19" aria-label="Monday 19 October" disabled>19</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-20" aria-label="Tuesday 20 October" disabled>20</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-21" aria-label="Wednesday 21 October" disabled>21</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-22" aria-label="Thursday 22 October" disabled>22</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-23" aria-label="Friday 23 October" disabled>23</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-24" aria-label="Saturday 24 October" disabled>24</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-25" aria-label="Sunday 25 October" disabled>25</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-26" aria-label="Monday 26 October" disabled>26</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-27" aria-label="Tuesday 27 October" disabled>27</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-28" aria-label="Wednesday 28 October" disabled>28</label>
<label class="calendar-mini-day is-today"><input type="radio" name="calendar-pick" value="2026-10-29" aria-label="Thursday 29 October">29</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-30" aria-label="Friday 30 October">30</label>
<label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-31" aria-label="Saturday 31 October" checked>31</label>
<label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-11-01" aria-label="Sunday 1 November">1</label>
</fieldset>
</div>
<button type="submit" class="btn btn-primary btn-sm align-self-start">Book this date</button>
</form><fieldset class="calendar-mini-grid">
<legend class="visually-hidden">Pick a date</legend>
<span class="calendar-mini-weekday" aria-hidden="true">M</span>
<!-- … -->
<label class="calendar-mini-day"><input type="radio" name="date" value="2026-10-28" disabled>28</label>
<label class="calendar-mini-day is-today"><input type="radio" name="date" value="2026-10-29">29</label>
<label class="calendar-mini-day"><input type="radio" name="date" value="2026-10-31" checked>31</label>
</fieldset>
Filters and legend
A .calendar-legend fieldset holds one checkbox per colour. Give each
.calendar-filter-check a value that names a theme colour. The checkbox takes that
colour, and unchecking it hides every matching event in the enclosing .calendar. It also
hides agenda list items. The checkboxes must be inside the .calendar. Try them in the
full example. Use .calendar-legend-inline to lay them out in a row.
HTML
<fieldset class="calendar-legend">
<legend>Calendars</legend>
<div class="form-check">
<input class="form-check-input calendar-filter-check" type="checkbox" value="primary" id="calendar-filters-filter-primary" checked>
<label class="form-check-label" for="calendar-filters-filter-primary">Shows</label>
</div>
<div class="form-check">
<input class="form-check-input calendar-filter-check" type="checkbox" value="navy" id="calendar-filters-filter-navy" checked>
<label class="form-check-label" for="calendar-filters-filter-navy">Training</label>
</div>
<div class="form-check">
<input class="form-check-input calendar-filter-check" type="checkbox" value="success" id="calendar-filters-filter-success" checked>
<label class="form-check-label" for="calendar-filters-filter-success">Media</label>
</div>
<div class="form-check">
<input class="form-check-input calendar-filter-check" type="checkbox" value="info" id="calendar-filters-filter-info" checked>
<label class="form-check-label" for="calendar-filters-filter-info">Travel</label>
</div>
<div class="form-check">
<input class="form-check-input calendar-filter-check" type="checkbox" value="danger" id="calendar-filters-filter-danger" checked>
<label class="form-check-label" for="calendar-filters-filter-danger">Medical</label>
</div>
<div class="form-check">
<input class="form-check-input calendar-filter-check" type="checkbox" value="secondary" id="calendar-filters-filter-secondary" checked>
<label class="form-check-label" for="calendar-filters-filter-secondary">Admin</label>
</div>
</fieldset>
For a legend with no filtering, use .calendar-swatch with a colour class:
- Shows
- Training
- Media
- Travel
HTML
<ul class="calendar-legend calendar-legend-inline">
<li><span class="calendar-swatch calendar-event-primary"></span>Shows</li>
<li><span class="calendar-swatch calendar-event-navy"></span>Training</li>
<li><span class="calendar-swatch calendar-event-success"></span>Media</li>
<li><span class="calendar-swatch calendar-event-info"></span>Travel</li>
</ul>Responsive behaviour
Every view is a size container, so it responds to its own width. The breakpoints are
$calendar-narrow (36rem) and $calendar-wide (52rem).
| Component | Under 36rem | 52rem and over |
|---|---|---|
.calendar | Title gets its own row; toolbar buttons shrink. | Sidebar moves beside the views. |
.calendar-month | Chips become colour bars (text kept for screen readers); "+2 more" becomes "+2"; dates centre. | — |
.calendar-timegrid | Columns stay at least 7.5rem wide. The grid scrolls sideways, snaps one day at a time, and keeps the time gutter pinned. | — |
.calendar-agenda | Date heading becomes a full-width sticky bar; time moves above the title. | — |
The same month and week at phone width (22rem), whatever your screen size:
Thursday 29 October
Accessibility
- Give the shell
role="region"and anaria-label. Label the view switcher group. - Date links need a full date as their
aria-label("Thursday 29 October"). Today's date link also needsaria-current="date". - In the month view, the weekday header is
aria-hidden, and events are read after the dates. Start each chip with visually hidden text that names its day, so it makes sense out of context. The time-grid columns are labelled groups, so this is not needed there. - The time grid scrolls, so give it
tabindex="0",role="region"and a label. Keyboard users can then scroll it. - The view switcher, the filters and the date picker are native radios and checkboxes. They are keyboard operable and announce their state.
- Colour is never the only signal. Tentative events are hatched, cancelled ones are struck through, and the agenda adds badges.
- The agenda view is a list of headed sections. It is the easiest view to use with a screen reader, so offer it.
Event custom properties
| Property | Set on | Meaning |
|---|---|---|
--bs-calendar-col | Month and all-day events, .calendar-more | Starting column, 1–7 (or 1–--bs-calendar-days). |
--bs-calendar-span | Month and all-day events | Number of days. Default 1. |
--bs-calendar-start | Timed events, .calendar-now | Start hour, decimal (9.25 = 9:15). |
--bs-calendar-end | Timed events | End hour, decimal. Default start + 1. |
--bs-calendar-lane / --bs-calendar-lanes | Timed events | Position and count for side-by-side overlaps. Default 0 / 1. |
--bs-calendar-days | .calendar-timegrid | Number of day columns. Default 7. |
--bs-calendar-day-start / --bs-calendar-day-end | .calendar-timegrid | First and last hour shown. Default 0 / 24. |
CSS variables
Each part reads its own variables, scoped to its root class. Override them there, the Bootstrap way.
.calendar-event {
--bs-calendar-event-bg: var(--bs-secondary-bg);
--bs-calendar-event-color: var(--bs-emphasis-color);
--bs-calendar-event-accent: var(--bs-secondary-color);
--bs-calendar-event-contrast: var(--bs-body-bg); // text on .calendar-event-solid
--bs-calendar-event-font-size: 0.765625rem;
--bs-calendar-event-padding-x: 0.375rem;
--bs-calendar-event-padding-y: 0.125rem;
--bs-calendar-event-border-width: 3px;
--bs-calendar-event-border-radius: var(--bs-border-radius-sm);
}
.calendar-month {
--bs-calendar-month-week-min-height: 7rem;
--bs-calendar-month-date-height: 2.125rem; // space reserved above event rows
--bs-calendar-month-event-gap: 2px;
--bs-calendar-month-border-color: var(--bs-border-color);
--bs-calendar-month-header-bg: var(--bs-tertiary-bg);
--bs-calendar-month-outside-bg: color-mix(in srgb, var(--bs-secondary-bg) 70%, transparent);
--bs-calendar-month-weekend-bg: color-mix(in srgb, var(--bs-secondary-bg) 35%, transparent);
--bs-calendar-month-selected-color: var(--bs-primary);
--bs-calendar-today-bg: var(--bs-primary);
--bs-calendar-today-color: var(--color-accent-fg);
}
.calendar-timegrid {
--bs-calendar-hour-height: 3rem;
--bs-calendar-gutter-width: 4.25rem;
--bs-calendar-gutter-width-narrow: 3.25rem;
--bs-calendar-col-min: 5.5rem; // minimum day width when wide
--bs-calendar-col-min-narrow: 7.5rem; // … and under 36rem
--bs-calendar-timegrid-max-height: 36rem;
--bs-calendar-timegrid-line: var(--bs-border-color-translucent);
--bs-calendar-now-color: var(--bs-danger);
}
.calendar-agenda {
--bs-calendar-agenda-date-width: 9rem;
--bs-calendar-agenda-time-width: 10.5rem;
--bs-calendar-agenda-sticky-top: 0;
}
.calendar-mini {
--bs-calendar-mini-cell-size: 2.25rem;
--bs-calendar-mini-selected-bg: var(--bs-navy); // cream-100 in dark mode
--bs-calendar-mini-range-bg: var(--bs-primary-bg-subtle);
--bs-calendar-mini-dot-color: var(--bs-primary);
}
Sass
$calendar-views: day, week, month, agenda !default; // names accepted by data-calendar-view
$calendar-narrow: 36rem !default; // chips → bars, grid scrolls, agenda stacks
$calendar-wide: 52rem !default; // sidebar beside the views