Bootstrap 5 Custom Date Picker with Calendar Popover
A custom date picker with a popover month calendar, today and clear shortcuts, past days disabled and keyboard-friendly buttons.
<section class="wdw-stage">
<div class="container" style="max-width:460px">
<div class="text-center mb-4">
<span class="wdw-eyebrow">Booking</span>
<h2 class="wdw-heading h2 mt-1 mb-2">Pick a date</h2>
<p class="wdw-muted mb-0">Choose the day for your appointment.</p>
</div>
<form class="wdw-card p-4" id="dpForm" novalidate>
<label for="dpInput" class="form-label fw-semibold">Appointment date</label>
<div class="dp position-relative" id="dp">
<div class="input-group">
<input type="text" class="form-control" id="dpInput" placeholder="Select a date" readonly aria-haspopup="dialog" aria-expanded="false" aria-controls="dpPanel">
<button type="button" class="btn btn-outline-secondary" id="dpToggle" aria-label="Open calendar">
<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="5" width="18" height="16" rx="3"/><path d="M8 3v4M16 3v4M3 10h18"/></svg>
</button>
</div>
<div class="dp-panel wdw-card-sm p-3" id="dpPanel" role="dialog" aria-label="Choose date" hidden>
<div class="d-flex align-items-center justify-content-between mb-2">
<button type="button" class="btn btn-sm bg-body-secondary text-body rounded-circle dp-nav" data-dp="-1" aria-label="Previous month"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 6l-6 6 6 6"/></svg></button>
<strong id="dpTitle" aria-live="polite"></strong>
<button type="button" class="btn btn-sm bg-body-secondary text-body rounded-circle dp-nav" data-dp="1" aria-label="Next month"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 6l6 6-6 6"/></svg></button>
</div>
<div class="dp-grid dp-week text-center small wdw-muted" aria-hidden="true"><span>Su</span><span>Mo</span><span>Tu</span><span>We</span><span>Th</span><span>Fr</span><span>Sa</span></div>
<div id="dpDays" role="grid" aria-labelledby="dpTitle"></div>
<div class="d-flex justify-content-between mt-2">
<button type="button" class="btn btn-sm btn-link text-decoration-none" id="dpToday">Today</button>
<button type="button" class="btn btn-sm btn-link text-decoration-none link-secondary" id="dpClear">Clear</button>
</div>
</div>
</div>
<div class="form-text" id="dpHelp">Pick any day from today onwards. Open the calendar and use the arrow keys to move between days.</div>
<button type="submit" class="btn btn-primary rounded-pill w-100 mt-4">Confirm date</button>
<div class="alert alert-success mt-3 mb-0 py-2" id="dpResult" role="status" hidden></div>
</form>
</div>
</section>
/* Web Designer Wall library style — shared base for every Bootstrap 5 snippet.
Indigo accent, Plus Jakarta Sans, soft cards, pill buttons. Works in light and dark. */
@import url("https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap");
:root,
[data-bs-theme="light"] {
--wdw-font: "Plus Jakarta Sans", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--bs-body-font-family: var(--wdw-font);
--bs-primary: #4f46e5;
--bs-primary-rgb: 79, 70, 229;
--bs-primary-text-emphasis: #3730a3;
--bs-primary-bg-subtle: #eef2ff;
--bs-primary-border-subtle: #c7d2fe;
--bs-link-color: #4f46e5;
--bs-link-color-rgb: 79, 70, 229;
--bs-link-hover-color: #4338ca;
--bs-link-hover-color-rgb: 67, 56, 202;
--bs-focus-ring-color: rgba(79, 70, 229, 0.25);
--bs-border-radius: 0.75rem;
--bs-border-radius-lg: 1rem;
--bs-border-radius-xl: 1.25rem;
--wdw-radius-card: 1.25rem;
--wdw-shadow: 0 1px 2px rgba(16, 24, 40, 0.05), 0 16px 40px -16px rgba(16, 24, 40, 0.22);
--wdw-shadow-sm: 0 1px 2px rgba(16, 24, 40, 0.06), 0 4px 12px -4px rgba(16, 24, 40, 0.12);
--wdw-stage: #f5f6fb;
}
[data-bs-theme="dark"] {
--bs-primary: #818cf8;
--bs-primary-rgb: 129, 140, 248;
--bs-primary-text-emphasis: #c7d2fe;
--bs-primary-bg-subtle: rgba(129, 140, 248, 0.14);
--bs-primary-border-subtle: rgba(129, 140, 248, 0.35);
--bs-link-color: #a5b4fc;
--bs-link-color-rgb: 165, 180, 252;
--bs-link-hover-color: #c7d2fe;
--bs-link-hover-color-rgb: 199, 210, 254;
--bs-focus-ring-color: rgba(129, 140, 248, 0.35);
--wdw-shadow: 0 1px 2px rgba(0, 0, 0, 0.4), 0 16px 40px -16px rgba(0, 0, 0, 0.7);
--wdw-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.4), 0 4px 12px -4px rgba(0, 0, 0, 0.5);
--wdw-stage: #0f1117;
}
body { font-family: var(--wdw-font); -webkit-font-smoothing: antialiased; }
/* Bootstrap compiles its blue into these components; point them at the accent. */
.btn-primary {
--bs-btn-bg: var(--bs-primary); --bs-btn-border-color: var(--bs-primary);
--bs-btn-hover-bg: #4338ca; --bs-btn-hover-border-color: #4338ca;
--bs-btn-active-bg: #3730a3; --bs-btn-active-border-color: #3730a3;
--bs-btn-disabled-bg: var(--bs-primary); --bs-btn-disabled-border-color: var(--bs-primary);
--bs-btn-focus-shadow-rgb: var(--bs-primary-rgb);
}
[data-bs-theme="dark"] .btn-primary { --bs-btn-color: #0f1117; --bs-btn-hover-bg: #a5b4fc; --bs-btn-hover-border-color: #a5b4fc; --bs-btn-hover-color: #0f1117; --bs-btn-active-color: #0f1117; }
.btn-outline-primary {
--bs-btn-color: var(--bs-primary); --bs-btn-border-color: var(--bs-primary);
--bs-btn-hover-bg: var(--bs-primary); --bs-btn-hover-border-color: var(--bs-primary);
--bs-btn-active-bg: var(--bs-primary); --bs-btn-active-border-color: var(--bs-primary);
--bs-btn-focus-shadow-rgb: var(--bs-primary-rgb);
}
.btn { --bs-btn-font-weight: 600; min-height: 44px; display: inline-flex; align-items: center; justify-content: center; gap: .5rem; }
.btn-sm { min-height: 36px; }
.form-control, .form-select { min-height: 44px; border-radius: .75rem; }
.form-control:focus, .form-select:focus, .form-check-input:focus { border-color: rgba(var(--bs-primary-rgb), .6); box-shadow: 0 0 0 .25rem var(--bs-focus-ring-color); }
.form-check-input:checked { background-color: var(--bs-primary); border-color: var(--bs-primary); }
.nav-pills { --bs-nav-pills-link-active-bg: var(--bs-primary); }
.nav { --bs-nav-link-color: var(--bs-secondary-color); --bs-nav-link-hover-color: var(--bs-emphasis-color); }
.pagination { --bs-pagination-active-bg: var(--bs-primary); --bs-pagination-active-border-color: var(--bs-primary); --bs-pagination-color: var(--bs-body-color); --bs-pagination-focus-box-shadow: 0 0 0 .25rem var(--bs-focus-ring-color); }
.progress, .progress-stacked { --bs-progress-bar-bg: var(--bs-primary); }
.list-group { --bs-list-group-active-bg: var(--bs-primary); --bs-list-group-active-border-color: var(--bs-primary); }
.dropdown-menu { --bs-dropdown-link-active-bg: var(--bs-primary); border-radius: .875rem; box-shadow: var(--wdw-shadow-sm); }
.accordion { --bs-accordion-active-bg: var(--bs-primary-bg-subtle); --bs-accordion-active-color: var(--bs-primary-text-emphasis); --bs-accordion-btn-focus-box-shadow: 0 0 0 .25rem var(--bs-focus-ring-color); }
.badge { font-weight: 600; }
/* Library building blocks — use these instead of re-inventing them per snippet. */
.wdw-stage { min-height: 100vh; display: flex; align-items: center; background: var(--wdw-stage); padding-block: 3rem; }
.wdw-card { background: var(--bs-body-bg); border: 1px solid var(--bs-border-color-translucent); border-radius: var(--wdw-radius-card); box-shadow: var(--wdw-shadow); }
.wdw-card-sm { background: var(--bs-body-bg); border: 1px solid var(--bs-border-color-translucent); border-radius: 1rem; box-shadow: var(--wdw-shadow-sm); }
.wdw-aurora { position: relative; color: #fff; background: radial-gradient(60% 55% at 100% 0, #818cf8 0, transparent 70%), radial-gradient(65% 60% at 0 100%, #ec4899 0, transparent 65%), #1e1b4b; }
.wdw-eyebrow { display: inline-block; font-size: .75rem; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: var(--bs-primary); }
.wdw-heading { font-weight: 800; letter-spacing: -.02em; color: var(--bs-emphasis-color); }
.wdw-muted { color: var(--bs-secondary-color); }
.wdw-icon { width: 2.75rem; height: 2.75rem; flex: none; display: inline-flex; align-items: center; justify-content: center; border-radius: .875rem; background: var(--bs-primary-bg-subtle); color: var(--bs-primary); }
/* Component */
.dp-panel { position: absolute; z-index: 5; inset-inline: 0; top: 100%; margin-top: .5rem; background: var(--bs-body-bg); box-shadow: var(--wdw-shadow); }
.dp-panel[hidden] { display: none; }
.dp-grid { display: grid; grid-template-columns: repeat(7, 1fr); gap: 2px; }
.dp-week span { padding: .35rem 0; font-weight: 600; }
.dp-nav { width: 40px; height: 40px; padding: 0; }
.dp-day { width: 100%; aspect-ratio: 1; min-height: 38px; border: 0; background: transparent; border-radius: 50%; color: var(--bs-body-color); font-weight: 500; font-size: .9rem; }
.dp-day:hover:not([aria-disabled="true"]) { background: var(--bs-primary-bg-subtle); }
.dp-day[aria-current="date"] { box-shadow: inset 0 0 0 1.5px var(--bs-primary); }
.dp-cell[aria-selected="true"] .dp-day, .dp-cell[aria-selected="true"] .dp-day:hover { background: var(--bs-primary); color: #fff; font-weight: 700; }
[data-bs-theme="dark"] .dp-cell[aria-selected="true"] .dp-day { color: #0f1117; }
.dp-day[aria-disabled="true"] { color: var(--bs-secondary-color); opacity: .45; cursor: not-allowed; }
.dp-day:focus-visible { outline: 2px solid var(--bs-primary); outline-offset: 2px; }
function initDatePicker() {
const root = document.getElementById('dp');
if (!root) return;
const input = document.getElementById('dpInput');
const toggle = document.getElementById('dpToggle');
const panel = document.getElementById('dpPanel');
const days = document.getElementById('dpDays');
const title = document.getElementById('dpTitle');
const result = document.getElementById('dpResult');
const form = document.getElementById('dpForm');
const today = new Date(); today.setHours(0, 0, 0, 0);
const addDays = (d, n) => new Date(d.getFullYear(), d.getMonth(), d.getDate() + n);
const same = (a, b) => a && b && a.getTime() === b.getTime();
const fmt = d => d.toLocaleDateString('en-US', { weekday: 'long', month: 'long', day: 'numeric', year: 'numeric' });
let selected = addDays(today, 3);
let view = new Date(selected.getFullYear(), selected.getMonth(), 1);
let focusDate = selected;
function render() {
title.textContent = view.toLocaleDateString('en-US', { month: 'long', year: 'numeric' });
days.innerHTML = '';
const count = new Date(view.getFullYear(), view.getMonth() + 1, 0).getDate();
const cells = Array(view.getDay()).fill(null);
for (let n = 1; n <= count; n++) cells.push(new Date(view.getFullYear(), view.getMonth(), n));
while (cells.length % 7) cells.push(null);
const inView = focusDate.getMonth() === view.getMonth() && focusDate.getFullYear() === view.getFullYear();
if (!inView) focusDate = new Date(view.getFullYear(), view.getMonth(), 1);
for (let r = 0; r < cells.length; r += 7) {
const row = document.createElement('div');
row.className = 'dp-grid'; row.setAttribute('role', 'row');
cells.slice(r, r + 7).forEach(d => {
const cell = document.createElement('div');
cell.className = 'dp-cell'; cell.setAttribute('role', 'gridcell');
if (d) {
const b = document.createElement('button');
b.type = 'button'; b.className = 'dp-day'; b.textContent = d.getDate();
b.dataset.t = d.getTime();
b.tabIndex = same(d, focusDate) ? 0 : -1;
b.setAttribute('aria-label', fmt(d));
if (same(d, today)) b.setAttribute('aria-current', 'date');
if (d < today) b.setAttribute('aria-disabled', 'true');
cell.setAttribute('aria-selected', same(d, selected));
b.addEventListener('click', () => {
if (d < today) return;
selected = d; input.value = fmt(d); close(true);
});
cell.appendChild(b);
}
row.appendChild(cell);
});
days.appendChild(row);
}
}
function focusDay(d) {
focusDate = d;
if (d.getMonth() !== view.getMonth() || d.getFullYear() !== view.getFullYear()) view = new Date(d.getFullYear(), d.getMonth(), 1);
render();
const b = days.querySelector('[data-t="' + d.getTime() + '"]');
if (b) b.focus();
}
function open(move) {
focusDate = selected || today;
view = new Date(focusDate.getFullYear(), focusDate.getMonth(), 1);
render(); panel.hidden = false;
input.setAttribute('aria-expanded', 'true');
if (move) { const b = days.querySelector('[tabindex="0"]'); if (b) b.focus(); }
}
function close(returnFocus) {
panel.hidden = true; input.setAttribute('aria-expanded', 'false');
if (returnFocus) input.focus();
}
input.value = fmt(selected);
input.addEventListener('click', () => (panel.hidden ? open(true) : close()));
input.addEventListener('keydown', e => { if (e.key === 'Enter' || e.key === ' ' || e.key === 'ArrowDown') { e.preventDefault(); open(true); } });
toggle.addEventListener('click', () => (panel.hidden ? open(true) : close(true)));
panel.querySelectorAll('[data-dp]').forEach(b => b.addEventListener('click', () => {
view = new Date(view.getFullYear(), view.getMonth() + Number(b.dataset.dp), 1);
focusDate = view; render();
}));
document.getElementById('dpToday').addEventListener('click', () => { selected = today; input.value = fmt(today); close(true); });
document.getElementById('dpClear').addEventListener('click', () => { selected = null; input.value = ''; focusDate = today; render(); });
days.addEventListener('keydown', e => {
const t = e.target.closest('.dp-day');
if (!t) return;
const d = new Date(Number(t.dataset.t));
const step = { ArrowLeft: -1, ArrowRight: 1, ArrowUp: -7, ArrowDown: 7 }[e.key];
if (step) { e.preventDefault(); focusDay(addDays(d, step)); }
else if (e.key === 'Home') { e.preventDefault(); focusDay(addDays(d, -d.getDay())); }
else if (e.key === 'End') { e.preventDefault(); focusDay(addDays(d, 6 - d.getDay())); }
else if (e.key === 'PageUp' || e.key === 'PageDown') { e.preventDefault(); focusDay(new Date(d.getFullYear(), d.getMonth() + (e.key === 'PageUp' ? -1 : 1), 1)); }
});
document.addEventListener('click', e => { if (!root.contains(e.target)) close(); });
root.addEventListener('keydown', e => { if (e.key === 'Escape' && !panel.hidden) { e.stopPropagation(); close(true); } });
// starts closed so the card stays compact
form.addEventListener('submit', e => {
e.preventDefault();
result.hidden = false;
result.className = 'alert mt-3 mb-0 py-2 ' + (selected ? 'alert-success' : 'alert-danger');
result.textContent = selected ? 'Booked for ' + fmt(selected) + '.' : 'Please select a date first.';
});
}
initDatePicker();
Built on Bootstrap 5.3.8 with plain JavaScript — no jQuery. Supports light and dark mode via data-bs-theme.