BLK-121Blocks
A shop advent calendar with 25 date-locked doors
Choose December 8 in the demo, then open the eighth paper door to read the gift-wrapping notice. Future doors show when they unlock. The calendar remembers opened doors in your browser and lets you share your count on X. Copy the React component and supply your own start date and up to 25 dated announcements.
Preview
12月のおたより
12/1〜12/25、日付の扉を開くとお店のお知らせが読めます。
開けた扉0/25開けた数をXで共有
架空の雑貨店のお知らせです。扉の中身はページ内に含まれるため、先に見られて困る情報は置かないでください。
Read the full description
Choose December 8 in the demo, then open the eighth paper door to read the gift-wrapping notice. Future doors show when they unlock. The calendar remembers opened doors in your browser and lets you share your count on X. Copy the React component and supply your own start date and up to 25 dated announcements.
- Added:
- 2026-11-22
- Dependencies:
- None
- tags
- #advent-calendar #seasonal #christmas #retail #announcement #paper #keyboard
"use client";
import { type KeyboardEvent, useId, useMemo, useRef, useState, useSyncExternalStore } from "react";
// 25枚の扉がそれぞれお知らせの封筒になる。開いた日だけ横幅を広げ、日付と本文を同じ場所に残す。
export type AdventNotice = { date: string; title: string; body: string };
export type AdventProps = {
headingTag?: "h1" | "h2" | "p";
startDate?: string;
notices?: AdventNotice[];
demo?: boolean;
};
// 組み込み例(公開前にソースから読まれてもよい告知だけを登録します)
// <AdventDoorCalendar startDate="2026-12-01" notices={[
// { date: "2026-12-25", title: "12/25の営業時間", body: "10:00〜17:00" }
// ]} />
const defaults: AdventNotice[] = [
["01", "冬のおたより、はじまります", "今日から毎日、冬のお店をのぞいてみてください。"],
["02", "冬のポストカード", "針葉樹を描いた冬の絵はがきが並びました。"],
["03", "ラッピング無料の日", "本日はお選びの品を無料でお包みします。"],
["04", "白いマグカップ", "温かい飲みものに合う、厚手の器が届きました。"],
["05", "木のオーナメント", "星と小鳥の飾りを、窓辺の棚に並べました。"],
["06", "手のひらサイズの贈りもの", "小さな缶と布小物を入口に集めました。"],
["07", "贈りものに添えるカード", "二つ折りのメッセージカードを選べます。"],
["08", "ギフトのラッピング受付", "贈りものを薄紙と赤いリボンでお包みします。"],
["09", "冬色のくつ下", "赤、紺、もみの木色の三色がそろいました。"],
["10", "キャンドルの夕べ", "夕方から窓辺にキャンドルを灯します。"],
["11", "木のスプーン", "形の違う木のスプーンを一本ずつ選べます。"],
["12", "チェックのハンカチ", "包んでも使える大きなハンカチが届きました。"],
["13", "冬の読みもの", "冬の午後に読みたい絵本を棚に並べました。"],
["14", "小箱の包装", "指輪や小さな飾りに合う箱をご用意しています。"],
["15", "松ぼっくりのリース", "店先に手作りの小さなリースが並びます。"],
["16", "真っ白なふきん", "新しい年に使いたい、綿のふきんが入りました。"],
["17", "陶器のブローチ", "コートの襟に合う、小鳥のブローチが届きました。"],
["18", "赤い実の小皿", "小さなお菓子をのせる丸皿を紹介します。"],
["19", "冬の紙袋", "贈りもの用に、雪の柄の手提げを選べます。"],
["20", "ツリーの飾り", "手のひらに乗る小さな木のツリーが並びました。"],
["21", "冬至の食卓", "温かい汁物に合う、深めの器を集めました。"],
["22", "小さな贈りものの相談", "贈る相手に合わせて、店頭で一緒に選びます。"],
["23", "一筆箋と封筒", "手書きのひとことを添える便箋を選べます。"],
["24", "イブのラッピング", "本日も店頭で、贈りものをお包みします。"],
["25", "12/25の営業時間", "10:00〜17:00"],
].map(([day, title, body]) => ({ date: `2026-12-${day}`, title, body }));
const DAY = 86400000;
const DAYS = 25;
const JST = 9 * 3600000;
const dayInJapan = () => Math.floor((Date.now() + JST) / DAY);
const unknownDay = () => -Infinity;
function subscribeClock(update: () => void) {
let timer: ReturnType<typeof setTimeout>;
function schedule() {
clearTimeout(timer);
update();
timer = setTimeout(schedule, DAY - ((Date.now() + JST) % DAY) + 1);
}
schedule();
window.addEventListener("pageshow", schedule);
document.addEventListener("visibilitychange", schedule);
return () => {
clearTimeout(timer);
window.removeEventListener("pageshow", schedule);
document.removeEventListener("visibilitychange", schedule);
};
}
function ordinal(iso: string) {
if (!/^\d{4}-\d{2}-\d{2}$/.test(iso)) return NaN;
const ms = Date.parse(`${iso}T00:00:00Z`);
return Number.isFinite(ms) && new Date(ms).toISOString().slice(0, 10) === iso ? ms / DAY : NaN;
}
function shortDate(day: number) {
const date = new Date(day * DAY);
return `${date.getUTCMonth() + 1}/${date.getUTCDate()}`;
}
export function scheduleAdvent(startDate: string, notices: AdventNotice[]) {
const start = ordinal(startDate);
const byDay = new Map<number, AdventNotice>();
if (!Number.isFinite(start))
return { error: "開始日は実在する日付をYYYY-MM-DD形式で指定してください。" } as const;
if (notices.length > DAYS) return { error: "お知らせは25件まで登録できます。" } as const;
for (const notice of notices) {
const day = ordinal(notice.date) - start;
if (!Number.isInteger(day) || day < 0 || day >= DAYS)
return {
error: `${notice.date} は登録できません。開始日から25日間の日付を指定してください。`,
} as const;
if (byDay.has(day))
return { error: `${notice.date} のお知らせが重複しています。1日1件にまとめてください。` } as const;
byDay.set(day, notice);
}
return { start, byDay } as const;
}
// 保存できないブラウザでは、このページを開いている間だけ履歴を持つ。
function historyStore(startDate: string, demo: boolean) {
let fallback = "";
let memoryOnly = false;
const key = () => `advent-doors:${location.pathname}:${startDate}:${demo ? "demo" : "shop"}`;
const event = "advent-doors-updated";
return {
read() {
if (!memoryOnly) {
try {
fallback = window.localStorage.getItem(key()) ?? "";
} catch {
memoryOnly = true;
}
}
return fallback;
},
write(value: string) {
fallback = value;
if (!memoryOnly) {
try {
window.localStorage.setItem(key(), value);
} catch {
memoryOnly = true;
}
}
window.dispatchEvent(new Event(event));
},
subscribe(update: () => void) {
window.addEventListener("storage", update);
window.addEventListener(event, update);
return () => {
window.removeEventListener("storage", update);
window.removeEventListener(event, update);
};
},
};
}
const emptyHistory = () => "";
function decodeHistory(raw: string): { seen: number[]; active: number | null } {
try {
const data = JSON.parse(raw);
const seen = [
...new Set<number>(data.seen.filter((i: number) => Number.isInteger(i) && i >= 0 && i < DAYS)),
];
return { seen, active: seen.includes(data.active) ? data.active : null };
} catch {
return { seen: [], active: null };
}
}
export function toggleAdventHistory(raw: string, day: number) {
const history = decodeHistory(raw);
if (!history.seen.includes(day)) history.seen.push(day);
history.active = history.active === day ? null : day;
return JSON.stringify(history);
}
const styles = `
.advent-post {
box-sizing: border-box;
--amber: #d97706;
--ink: #332c25;
--border: #d7cbb9;
container-type: inline-size;
width: 100%;
max-width: 48rem;
margin: auto;
background: white;
color: var(--ink);
border: 1px solid var(--border);
box-shadow: 0 3px 0 #ece7de;
font-family: var(--font-noto-sans-jp, sans-serif);
}
.advent-post * {
box-sizing: border-box;
}
.advent-post button,
.advent-post select {
font: inherit;
}
.advent-post :is(button, select, a):focus-visible {
outline: 3px solid #27231f;
outline-offset: 2px;
z-index: 5;
}
.advent-mast {
position: relative;
isolation: isolate;
overflow: hidden;
background: #fffcf7;
border-top: 0.45rem solid #c27821;
border-bottom: 4px double var(--border);
padding: clamp(0.85rem, 3.7cqi, 1.65rem) 5%;
}
.advent-mast .advent-heading {
position: relative;
margin: 0;
width: 75%;
font-family: Georgia, "Yu Mincho", "Hiragino Mincho ProN", serif;
font-size: clamp(1.6rem, 5.5cqi, 2.7rem);
font-weight: 700;
line-height: 1.2;
letter-spacing: 0.025em;
}
.advent-mast .advent-intro {
position: relative;
margin: 0.4rem 0 0;
width: 73%;
font-size: clamp(0.83rem, 2.25cqi, 0.95rem);
line-height: 1.6;
}
.advent-forest {
position: absolute;
inset: 0 0 0 auto;
width: 29%;
z-index: -1;
background: repeating-linear-gradient(
120deg,
#c4a572 0 1px,
transparent 1px 5px
);
clip-path: polygon(
0 100%,
12% 77%,
7% 78%,
21% 56%,
15% 58%,
30% 26%,
43% 58%,
37% 56%,
52% 79%,
46% 77%,
58% 98%,
66% 83%,
62% 84%,
72% 68%,
68% 69%,
78% 46%,
89% 69%,
85% 68%,
96% 85%,
91% 83%,
100% 100%
);
}
.advent-toolbar,
.advent-progress {
display: flex;
align-items: center;
justify-content: space-between;
gap: 0.3rem 0.65rem;
flex-wrap: wrap;
padding: 0.36rem 4%;
font-size: 0.85rem;
}
.advent-date {
font-weight: 650;
}
.advent-date b,
.advent-progress strong {
margin-inline-start: 0.35rem;
font-family: var(--font-montserrat, Arial, sans-serif);
font-size: 1rem;
font-variant-numeric: tabular-nums;
}
.advent-switch,
.advent-toolbar select {
min-height: 44px;
padding: 0.35rem 0.65rem;
border: 1px solid #b5a58c;
border-radius: 2px;
background: #fffdfa;
color: var(--ink);
cursor: pointer;
}
.advent-choice {
display: flex;
align-items: center;
gap: 0.35rem;
}
.advent-board {
overflow: clip;
padding: clamp(0.5rem, 2.6cqi, 1.15rem);
display: grid;
gap: clamp(4px, 1cqi, 8px);
border-block: 1px solid var(--border);
background: #fffcf7;
}
.advent-row {
display: flex;
gap: clamp(4px, 1cqi, 8px);
align-items: stretch;
min-width: 0;
}
.advent-door {
--cover: #fff;
position: relative;
isolation: isolate;
display: grid;
place-items: center;
flex: 1 1 0;
min-width: 0;
min-height: clamp(3.2rem, 10.7cqi, 5.2rem);
padding: 0;
border: 1px solid #c4b9a7;
border-radius: 1px;
background: #fffdfa;
color: var(--ink);
cursor: pointer;
text-align: center;
}
.advent-door[data-ready="yes"] {
--cover: #fff6e6;
}
.advent-door[data-today="yes"] {
--cover: #ffe8be;
border-color: #a86408;
box-shadow: inset 0 0 0 2px var(--amber);
}
.advent-door .advent-flap {
position: absolute;
inset: 0;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
transform: perspective(420px) rotateY(0deg);
transform-origin: left center;
transition: transform 0.46s cubic-bezier(0.2, 0.72, 0.26, 1);
background: var(--cover);
pointer-events: none;
backface-visibility: hidden;
z-index: 1;
}
.advent-door[aria-expanded="true"] .advent-flap {
transform: perspective(420px) rotateY(-105deg);
}
.advent-flap:before {
content: "";
position: absolute;
inset: 3px;
border: 1px dashed #bca88a;
}
.advent-door[data-today="yes"] .advent-flap:before {
border: 2px solid var(--amber);
inset: 1px;
}
.advent-door:hover .advent-flap:before {
border-color: #785321;
}
.advent-flap:after {
content: "";
position: absolute;
right: -1px;
top: calc(50% - 4px);
width: 4px;
height: 8px;
background: #fffcf7;
border: 1px solid #b9aa93;
border-right: 0;
border-radius: 5px 0 0 5px;
}
.advent-door .advent-digit {
color: #913728;
font-family: Georgia, "Times New Roman", serif;
font-size: clamp(1.5rem, 5.25cqi, 2.55rem);
line-height: 1;
font-variant-numeric: lining-nums tabular-nums;
}
.advent-door .advent-hint {
font-size: 0.75rem;
line-height: 1.3;
}
.advent-door[data-today="yes"] .advent-hint {
font-weight: 700;
}
.advent-flap .advent-dot {
position: absolute;
top: 14%;
left: 10%;
width: 12%;
max-width: 10px;
aspect-ratio: 1;
background: #b78946;
clip-path: polygon(
50% 0,
59% 34%,
87% 13%,
66% 42%,
100% 50%,
66% 58%,
87% 87%,
59% 66%,
50% 100%,
41% 66%,
13% 87%,
34% 58%,
0 50%,
34% 42%,
13% 13%,
41% 34%
);
}
.advent-door[aria-expanded="true"] {
flex: 3.3 1 0;
border-left: 3px solid var(--amber);
padding: 0.62rem;
align-content: center;
justify-items: start;
text-align: left;
}
.advent-letter {
min-width: 0;
display: block;
}
.advent-letter-date {
display: block;
font-size: 0.75rem;
color: #654d2e;
}
.advent-close {
float: right;
font-size: 1rem;
line-height: 1;
margin-left: 0.4rem;
}
.advent-letter-title,
.advent-letter-body {
display: block;
overflow-wrap: anywhere;
}
.advent-letter-title {
margin: 0.15rem 0;
font-size: clamp(0.95rem, 2.7cqi, 1.2rem);
font-weight: bold;
line-height: 1.45;
}
.advent-letter-body {
font-size: clamp(0.85rem, 2.2cqi, 0.96rem);
line-height: 1.55;
}
.advent-shake {
animation: advent-shake 0.3s ease-out both;
}
@keyframes advent-shake {
25%,
75% {
transform: translateX(-2px);
}
50% {
transform: translateX(2px);
}
}
.advent-progress a {
display: inline-flex;
min-height: 44px;
align-items: center;
font-weight: 650;
color: #674818;
text-underline-offset: 0.2em;
text-decoration: underline;
}
.advent-foot {
margin: 0;
padding: 0.45rem 4% 0.8rem;
font-size: 0.8rem;
line-height: 1.65;
color: #5c5346;
}
.advent-message {
margin: 0;
padding: 0 4%;
font-size: 0.85rem;
line-height: 1.55;
color: #614316;
}
.advent-message:not(:empty) {
padding-block: 0.4rem;
border-top: 1px solid var(--border);
}
@container (max-width:28rem) {
.advent-door[aria-expanded="true"] {
flex: 4.1 1 0;
}
.advent-row:has([aria-expanded="true"])
.advent-door:not([aria-expanded="true"])
:is(.advent-hint, .advent-dot) {
display: none;
}
.advent-row:has([aria-expanded="true"])
.advent-door:not([aria-expanded="true"])
.advent-digit {
font-size: 1.1rem;
}
.advent-toolbar {
padding-block: 0.25rem;
}
.advent-switch,
.advent-toolbar select {
padding-inline: 0.4rem;
}
}
@media (prefers-reduced-motion: reduce) {
.advent-door .advent-flap {
transition: none;
}
.advent-door[aria-expanded="true"] .advent-flap {
transform: none;
visibility: hidden;
}
.advent-shake {
animation: none;
}
}
`;
export default function AdventDoorCalendar({
startDate = "2026-12-01",
notices = defaults,
demo = false,
headingTag: Heading = "h2",
}: AdventProps) {
const schedule = scheduleAdvent(startDate, notices);
const heading = useId();
const today = useSyncExternalStore(subscribeClock, dayInJapan, unknownDay);
const [demoDay, setDemoDay] = useState<number | null>(null);
const [locked, setLocked] = useState<{ index: number; tryNumber: number } | null>(null);
const doors = useRef<(HTMLButtonElement | null)[]>([]);
const store = useMemo(() => historyStore(startDate, demo), [startDate, demo]);
const saved = useSyncExternalStore(store.subscribe, store.read, emptyHistory);
const history = decodeHistory(saved);
if (schedule.error !== undefined) return <p role="alert">カレンダーの設定エラー:{schedule.error}</p>;
const { start, byDay } = schedule;
const current = demo && demoDay !== null ? start + demoDay : today;
const count = history.seen.length;
const demoDate = shortDate(start + 7);
const dateLabel = Number.isFinite(current) ? shortDate(current) : "…";
const period = `${shortDate(start)}〜${shortDate(start + DAYS - 1)}`;
const share = new URLSearchParams({ text: `お店のアドベントカレンダー、${count}/25の扉を開けました。` });
if (demo) share.set("url", "https://designs.first-ch.com/d/advent-door-calendar");
function chooseDay(day: number | null) {
setDemoDay(day);
setLocked(null);
}
function toggle(i: number) {
if (start + i > current) {
setLocked((last) => ({ index: i, tryNumber: (last?.tryNumber ?? 0) + 1 }));
return;
}
setLocked(null);
store.write(toggleAdventHistory(store.read(), i));
}
function move(event: KeyboardEvent<HTMLButtonElement>, index: number) {
const steps: Record<string, number> = { ArrowLeft: -1, ArrowRight: 1, ArrowUp: -5, ArrowDown: 5 };
const step = steps[event.key];
if (!step) return;
event.preventDefault();
doors.current[Math.max(0, Math.min(DAYS - 1, index + step))]?.focus();
}
return (
<section className="advent-post w-full min-w-0" aria-labelledby={heading}>
<style>{styles}</style>
<header className="advent-mast">
<span className="advent-forest" aria-hidden="true" />
<Heading className="advent-heading" id={heading}>
{new Date(start * DAY).getUTCMonth() + 1}月のおたより
</Heading>
<p className="advent-intro">{period}、日付の扉を開くとお店のお知らせが読めます。</p>
</header>
<div className="advent-toolbar">
<span className="advent-date">
{demo && demoDay !== null ? "デモ日付" : "今日の日付"}
<b>{dateLabel}</b>
</span>
{demo &&
(demoDay === null ? (
<button type="button" className="advent-switch" onClick={() => chooseDay(7)}>
今日を{demoDate}にする
</button>
) : (
<label className="advent-choice">
日付を変更
<select
value={demoDay}
onChange={(e) => chooseDay(e.target.value === "today" ? null : Number(e.target.value))}
>
<option value="today">実際の今日</option>
{Array.from({ length: DAYS }, (_, i) => (
<option key={i} value={i}>
{shortDate(start + i)}
</option>
))}
</select>
</label>
))}
</div>
<div className="advent-board" role="group" aria-label="25日間のお知らせ">
{Array.from({ length: 5 }, (_, row) => (
<div className="advent-row" key={row}>
{Array.from({ length: 5 }, (_, col) => {
const i = row * 5 + col;
const day = start + i;
const isReady = current >= day;
const isToday = current === day;
const seen = isReady && history.seen.includes(i);
const isOpen = seen && history.active === i;
const date = shortDate(day);
const notice = byDay.get(i);
const title = notice?.title ?? "お知らせなし";
const hint = seen ? "開封済" : isToday ? "今日の扉" : isReady ? "開ける" : `${date}から`;
const shaking = locked?.index === i && !isReady;
return (
<button
key={i}
ref={(el) => {
doors.current[i] = el;
}}
className="advent-door"
type="button"
data-ready={isReady ? "yes" : "no"}
data-today={isToday ? "yes" : "no"}
data-seen={seen ? "yes" : "no"}
aria-expanded={isOpen}
aria-current={isToday ? "date" : undefined}
aria-label={
isOpen
? `${date}、${title}。${notice?.body ?? ""} 扉を閉じる`
: `${i + 1}番、${date}の扉、${seen ? "開封済み" : hint}`
}
onClick={() => toggle(i)}
onKeyDown={(event) => move(event, i)}
>
{isOpen ? (
<span className="advent-letter">
<span className="advent-letter-date">
{date} のおたより
<span className="advent-close" aria-hidden="true">
×
</span>
</span>
<strong className="advent-letter-title">{title}</strong>
{notice?.body && <span className="advent-letter-body">{notice.body}</span>}
</span>
) : null}
<span
key={shaking ? locked.tryNumber : "still"}
className={`advent-flap${shaking ? " advent-shake" : ""}`}
aria-hidden="true"
>
<span>
<span className="advent-digit">{i + 1}</span>
<span className="advent-hint" style={{ display: "block" }}>
{hint}
</span>
</span>
{i % 3 !== 2 && <i className="advent-dot" />}
</span>
</button>
);
})}
</div>
))}
</div>
<p className="advent-message" aria-live="polite" aria-atomic="true">
{locked && start + locked.index > current ? `${shortDate(start + locked.index)}から開きます` : ""}
</p>
<div className="advent-progress">
<span aria-live="polite">
開けた扉<strong>{count}/25</strong>
</span>
<a href={`https://x.com/intent/tweet?${share}`} target="_blank" rel="noopener noreferrer">
開けた数をXで共有
</a>
</div>
<p className="advent-foot">
{demo && "架空の雑貨店のお知らせです。"}
扉の中身はページ内に含まれるため、先に見られて困る情報は置かないでください。
</p>
</section>
);
}
Add to your project via shadcn CLI
npx shadcn@latest add https://designs.first-ch.com/r/advent-door-calendar.json