GODRICH
#css애니메이션#버튼#로딩#전환효과#스크롤#대시보드#실전ui#디자인트렌드

calendar ui design 캘린더 UI 9종 — 날짜 계산부터 범위 선택까지

calendar ui design 의 첫걸음은 화면 꾸미기가 아니라 날짜 계산이다. 캘린더는 그려진 표가 아니라 계산이다 — 01번은 첫 요일과 6주를 재어 42칸을 스스로 채우고, 05번은 시작일과 종료일 사이 판정으로 범위를 채우며, 08번은 월 그리드를 주간 열로 다시 배치한다.

캘린더 UI 는 그려 둔 표가 아니라 첫 요일과 그 달의 날 수를 재어 42칸을 채우는 계산이다 — calendar ui design 은 이 계산을 얼마나 매끄럽게 보이게 만드는가에서 시작한다

zip 구성과 여는 법

아홉 장면은 같은 무대에서 돈다. 안쪽 상자는 480×300, 그 안에 날짜 그리드 448×156 과 시간축 차트·읽기줄이 붙는다. 라이브러리·WebGL·CDN 이 0 이고 기준 날짜는 고정값(2026-11-15)이라 재생할 때마다 같은 달력이 나온다 — new Date() 지금 시각을 쓰면 녹화·측정·검수마다 다른 달이 그려지기 때문이다.

프리셋은 장면마다 방향키로 바꾼다. 01 은 2026-11(lead 1)과 2027-02(lead 2) 를 번갈아 보여 주고, 02 는 11월 → 12월 → 1월 → 롤백의 전환 경로를 순환한다. 08 은 셋째 주를 주간 뷰로 떼어 놓았다가 월 그리드로 되돌리는 전환을 되풀이한다. Space·Enter 일시정지와 R 재시작도 붙어 있다.

캘린더 UI 9종 — 기본 월간 그리드·달 전환 슬라이드·날짜 호버 물결·단일 선택 원형 확산·범위 선택 중간일 채움·오늘 링 표시·미니 사이드 패널·주간 뷰 전환·일정 도트 멀티

숫자는 어디까지 실측이고 어디까지 모델인가

인용하는 값을 먼저 가른다. lead 1 · trail 11 · 42칸 배분이나 ω_d ≈ 20.62 같은 산술은 소스 상수에서 계산한 모델이고, 표의 누적면적·강도·움직인 프레임은 렌더 결과의 실측이며, 시간대 오프셋 −540분은 06 의 코드가 실행 환경에서 직접 재 값이다.

측정 판은 2026-11-15 22:34 렌더 본이다. 헤드리스 Chromium 이 무대 480×300 을 24장(2초)으로 찍고 이웃한 두 장의 차 23개로 움직임을 판정했고, 시리즈 통틀어 첫 컷과 달라진 적 있는 화소의 몫이 누적면적, 그 화소들의 색 차 평균(0~255)이 강도다.

장면 누적면적 강도 움직인 프레임
01 기본 월간 그리드 20.3% 52.8 23/23
02 달 전환 슬라이드 39.4% 121.5 23/23
03 날짜 호버 물결 15.8% 58.7 23/23
04 단일 선택 원형 확산 38.2% 105.3 23/23
05 범위 선택 채움 38.9% 105.3 23/23
06 오늘 링 37.2% 94.8 23/23
07 미니 사이드 패널 39.4% 132.4 23/23
08 주간 뷰 FLIP 36.8% 48.5 23/23
09 일정 도트 멀티 38.5% 91.3 23/23

누적면적이 가장 넓은 장면은 07 의 39.4%, 가장 좁은 것은 03 의 15.8%다 — 03 은 눌린 줄의 셀 물결이라 움직이는 면이 원래 좁고 그래서 줄 전체에 위상을 흩는 계산을 얹었다. 강도 평균은 07 의 132.4 가 가장 높고 08 의 48.5 가 가장 낮으며 아홉 장면 전부 23개 차 프레임에서 움직였다.

확인 못 한 것도 적는다. JS 가 꺼진 환경은 확인하지 못했다 — 그리드 자체가 스크립트가 그리는 것이라 낱장 정적 폴백은 이 구조에 없다. 모바일 실기기 렌더도 이번 측정에 없다.

01첫 요일을 재어 42칸을 채우는 기본 월간 그리드

데모와 설명

그 달 1일의 요일로 첫 칸의 빈칸 수를 재고 빈칸 + 그 달 날 수를 42칸에 나눠 담는 산술이 아홉 장면 전부의 뼈대다. 2026년 11월은 1일이 일요일인 30일이라 lead 1 · trail 11 로 첫 칸 하나와 마지막 11칸만 이웃 달에서 오고, 프리셋 2027년 2월은 lead 2 · 28일 · trail 12 — 두 배분을 견주면 산술의 전부가 보인다.

첫 요일을 재어 42칸을 채우는 기본 월간 그리드
전체 코드 새 창에서 열기

01 · 첫 요일을 재어 42칸을 채우는 기본 월간 그리드 — 측정 누적면적 20.283% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

getDay42 cellsleading-trailing

코드에서 볼 곳

    // ── 캘린더 공통 계산 — 달력은 그려 둔 표가 아니라 이 산술이다
    const CELLS = 42; // 6주 고정 — 달마다 그리드 높이가 점프하지 않는다
    const TODAY = { y: 2026, m: 10, d: 15 }; // m: 0-based (10 = 11월)
    // 그 달의 날 수 — 다음 달 0일 = 이번 달 마지막 날 (UTC 생성자로 시간대 영향을 뺀다)
    function daysInMonth(y, m) {
        return new Date(Date.UTC(y, m + 1, 0)).getUTCDate();
    }
    // 첫 요일 오프셋(일요일 시작) — getUTCDay 로 잰다. 로컬 getDay() 는 시간대 오프셋으로 하루 어긋날 수 있다(06 함정)
    function firstWeekday(y, m) {
        return (new Date(Date.UTC(y, m, 1)).getUTCDay() + 1) % 7;
    }

프레임 함수는 lit 인덱스까지의 칸을 점등하는데, c.d.out 인 이웃 달 칸은 옅은 배경만 입히고 점등 개수에서 빼서, 읽기줄의 42 · lead · trail · 이 달 날짜 수가 매 프레임 갱신된다.

02방향을 판별해 넘어가는 달 전환 슬라이드

데모와 설명

목표 월이 현재 월보다 크면 오른쪽으로, 작으면 왼쪽으로 — 방향은 부호 하나로 정해지고 현재 달과 들어오는 달 두 장이 SLIDE_MS 280 동안 반대 방향으로 448px 씩 흐른다. 전환이 매끄러운 건 그리드가 늘 42칸 같은 높이라 30일 달에서 31일 달로 넘어가도 세로 크기가 점프하지 않기 때문이다.

방향을 판별해 넘어가는 달 전환 슬라이드
전체 코드 새 창에서 열기

02 · 방향을 판별해 넘어가는 달 전환 슬라이드 — 측정 누적면적 39.402% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

directionSLIDE_MSdual grid

코드에서 볼 곳

        const wrapEl = make('div', 's2__wrap', scWrap);
        gridA = makeGrid(from.y, from.m, wrapEl);
        gridB = makeGrid(to.y, to.m, wrapEl);
        put(gridA.board, 0, 0, 448, 156);
        put(gridB.board, 0, 0, 448, 156);
        wrapEl.style.overflow = 'hidden';
        put(wrapEl, 0, 0, 448, 156);
        // 이동 시작 전 위치 — dir 쪽에서 들어와 반대쪽으로 나간다
        gridA.board.style.transform = 'translateX(0px)';
        gridB.board.style.transform = 'translateX(' + (dir * 448) + 'px)';

프레임마다 두 장의 translateX 가 이징을 먹고 반대 부호로 좁아지는데, direction = 목표월 − 현재월 의 부호 판별 한 줄이 전환의 문법 전부다.

03줄마다 위상이 어긋나는 날짜 호버 물결

데모와 설명

호버가 한 칸이 아니라 한 줄 전체를 물결치게 한다 — 행 위상 함수가 눌린 줄에서 거리에 따라 위상을 밀고 크기를 줄여 위·아래 줄이 순차적으로 부풀었다 가라앉는다. 진폭 AMP 0.22 에 감쇠 지수 ROW_PHASE_SPAN 1 이라 거리 2 줄의 진폭 배율은 0.018 로 사실상 누른 줄만 움직이는데, 이 값이 변형 절의 물결 폭 실험 기준선이다.

줄마다 위상이 어긋나는 날짜 호버 물결
전체 코드 새 창에서 열기

03 · 줄마다 위상이 어긋나는 날짜 호버 물결 — 측정 누적면적 15.753% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

rowPhaseROW_PHASE_SPANhover

코드에서 볼 곳

    const ROW_PHASE_SPAN = 1; // 변형2: 1 → 2.5 (이웃 줄까지 물결이 넘어간다)
    const RIPPLE_MS = 1600;
    const AMP = 0.22;
    let g3 = null;
    let cap3 = null;
    let focusI = 0;
    // 행 위상 — 눌린 줄(r0) 기준 거리에 따라 위상이 밀리고 크기가 줄어든다
    function rowPhase(row, r0, tt) {
        const dist = Math.abs(row - r0);
        const fall = Math.exp(-(dist * dist) / (ROW_PHASE_SPAN * ROW_PHASE_SPAN));
        return 1 + AMP * fall * Math.sin(tt * 2 * Math.PI - dist * 1.25);
    }

반환값은 그대로 각 줄 셀의 scale 이 되고 span 을 2.5 로 올리면 거리 2 줄이 0.47 배까지 살아나 이웃 줄까지 번진다.

04선택 지점에서 원형으로 확산되는 단일 선택

데모와 설명

날짜를 고르면 그 칸 중심으로 확산 원이 목표 크기를 한 번 넘겼다 되돌아오는데, 감쇠비 ζ 0.35 · 고유 진동수 ω 22 의 감쇠 진동이라 감쇠 진동수는 ω_d = ω√(1−ζ²) ≈ 20.62 다. 이전 선택 칸은 같은 파동으로 줄어들며 사라져 11월 6일 → 10일 → 18일 → 26일 순서로 선택이 옮겨 다니는 인상이 된다.

선택 지점에서 원형으로 확산되는 단일 선택
전체 코드 새 창에서 열기

04 · 선택 지점에서 원형으로 확산되는 단일 선택 — 측정 누적면적 38.183% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

scaledampedOscstate class

코드에서 볼 곳

    // 감쇠 진동 — x(t) = 1 + e^(−ζωt)·cos(ω_d t) (ω_d = ω√(1−ζ²))
    function dampedOsc(tt) {
        const wd = DW * Math.sqrt(1 - DZ * DZ);
        return 1 + 0.35 * Math.exp(-DZ * DW * tt) * Math.cos(wd * tt);
    }
    function ringAt(i) {
        const p = cellXY(i);
        return { x: p.x + (CW2 - 4) / 2, y: p.y + (CH2 - 3) / 2 };
    }

반환값은 확산 원의 scale 이 되고 is-picked 상태 클래스가 같은 프레임에 셀 배경을 바꿔 애니메이션과 상태가 짝을 이룬다.

05시작일과 종료일 사이를 판정해 채우는 범위 선택

데모와 설명

각 셀의 날짜가 시작일 이상 종료일 이하인지 부등호로 검사해 통과한 칸에 is-in-range 를 FILL_STEP_MS 40 간격으로 순차 붙이면 11월 6일부터 21일까지 16칸이 잉크가 번지듯 차오른다. 시작일은 왼쪽이 둥근 알약, 종료일은 오른쪽이 둥근 알약으로 모양이 갈라 양 끝이 한눈에 읽힌다.

시작일과 종료일 사이를 판정해 채우는 범위 선택
전체 코드 새 창에서 열기

05 · 시작일과 종료일 사이를 판정해 채우는 범위 선택 — 측정 누적면적 38.858% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

between testFILL_STEP_MSis-in-range

코드에서 볼 곳

    // 05 범위 선택 중간일 채움 — 각 셀의 날짜가 시작일 이상 종료일 이하인지 부등호(between test)로 검사해 is-in-range 를 순차 붙인다
    const FILL_STEP_MS = 40; // 변형3: 40 → 16 (프레임 단위 잉크 번짐)
    const RANGE_START = 6; // 2026-11-06
    const RANGE_END = 21; // 2026-11-21
    const HOLD5 = 500;
    let g5 = null;
    let cap5 = null;
    let daysInRange = 0;
    // between test — 시작일 ≤ d ≤ 종료일 (같은 날도 범위 안). 이웃 달 날짜는 m 이 다르므로 자동으로 탈락한다
    function betweenTest(d, s, e) {
        return d >= s && d <= e;
    }

어느 셀이 범위 안인지는 산술로 정해져 있고 채워지는 순서까지 계산에 들어 있다 — interval 이 곧 채움 애니메이션이다.

06기준 날짜와 대조해 둘러지는 오늘 링

데모와 설명

42칸 각각의 연·월·일을 기준 날짜와 완전 일치 비교해 맞는 정확히 1칸 — 기준일 2026-11-15 — 에만 링이 둘러지고 PULSE_MS 1200 주기로 살짝 커졌다 작아진다. 화면 위 붉은 줄에는 두 생성자 비교 결과가 매 순간 찍히는데, 이 값은 보는 환경의 시간대를 따라 달라지지만 판정 방식이 같으니 어떤 환경에서도 링은 같은 칸에 둘러진다.

기준 날짜와 대조해 둘러지는 오늘 링
전체 코드 새 창에서 열기

06 · 기준 날짜와 대조해 둘러지는 오늘 링 — 측정 누적면적 37.25% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

date matchy/m/dtimezone safe

코드에서 볼 곳

        // 시간대 함정 — 같은 날을 두 생성자로 만들어 비교한다 (timezone safe 대조)
        const localD = new Date(2026, 10, 15); // 로컬 자정 생성 — 실행 환경 시간대를 따른다
        const utcD = new Date(Date.UTC(2026, 10, 14, 23, 0, 0)); // UTC 11-14 23시 = UTC+9 기준 11-15 자정
        const sameByUTC = localD.getUTCFullYear() === utcD.getUTCFullYear() && localD.getUTCMonth() === utcD.getUTCMonth() && localD.getUTCDate() === utcD.getUTCDate();
        if (trapEl) {
            trapEl.textContent = 'new Date(2026,10,15) vs Date.UTC(2026,10,14,23h) — ' + (sameByUTC ? 'getUTC* 판정: 같은 날' : 'getUTC* 판정: 다른 날');
        }

링을 두르는 쪽은 matchDate 의 완전 일치고, 읽기줄의 오프셋 분 수는 localD.getTimezoneOffset() 을 찍은 것으로 이 환경에서는 −540 즉 UTC+9 다.

07선택일을 크게 읽어 주는 미니 사이드 패널

데모와 설명

하나의 월 계산으로 두 크기의 캘린더를 동시에 그린다 — 큰 판 scale 0.62 와 미니 판 scale 0.30 이 같은 선택 상태를 나눠 쓰고 선택이 옮기면 두 판의 같은 칸이 같은 프레임에 바뀐다. 옆 큰 숫자는 count-up 가산 보간으로 이전 날짜에서 다음 날짜로 흘러 숫자가 통째로 뛰지 않고 요일 문장도 같이 갱신된다.

선택일을 크게 읽어 주는 미니 사이드 패널
전체 코드 새 창에서 열기

07 · 선택일을 크게 읽어 주는 미니 사이드 패널 — 측정 누적면적 39.439% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

shared statecount-upmini grid

코드에서 볼 곳

    const PICK7_MS = 900;
    const SEQ7 = [19, 26, 33, 12, 5, 19]; // 11-06 → 13 → 20 → 12 → 31(이전달) → 06
    const BIG = 0.62;
    const SMALL = 0.30;
    let big7 = null;
    let mini7 = null;
    let numEl7 = null;
    let senEl7 = null;
    let dowEl7 = null;
    // count-up — 이전 숫자에서 다음 숫자로 가산 보간 (문자가 통째로 바뀌지 않게 한다)
    function countUp(from, to, p01) {
        return from + (to - from) * p01;
    }

강도 평균 132.4 는 이 편에서 가장 높다 — 두 판이 동시에 움직이는 만큼 변화 화소가 많고, 미니 판은 DOM 을 다시 짜지 않는 transform: scale(0.30) 판이라 상태 복제 비용이 0 이다.

08월 그리드가 주간 열로 재배치되는 뷰 전환

데모와 설명

월간 뷰에서 선택 주의 7칸만 남고 나머지 35칸은 잦아들며, 살아남은 7칸이 가운데 한 줄로 모여 주간 뷰가 된다 — 이동은 FLIP 방식이라 이동 전후 좌표 차이만 transform 으로 옮겨 레이아웃 재계산이 없다. 칸 자리는 열 7 + (i%7)×62 · 행 26 + ⌊i/7⌋×21 의 상수 산술로 미리 잡고 데모는 셋째 주를 골라 월 ↔ 주 전환을 되풀이한다.

월 그리드가 주간 열로 재배치되는 뷰 전환
전체 코드 새 창에서 열기

08 · 월 그리드가 주간 열로 재배치되는 뷰 전환 — 측정 누적면적 36.769% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

FLIPgrid coordsview switch

코드에서 볼 곳

    // grid coords — 칸 i 의 월 뷰 좌표
    function gridCoords(i) {
        return cellXY(i);
    }
    // FLIP — First(월 좌표) Last(주 좌표) Invert(transform) Play(보간). transform 만 움직이므로 레이아웃 재계산이 없다
    function flipTo(i, fx, fy, lx, ly, p01) {
        void i;
        const dx = fx + (lx - fx) * p01;
        const dy = fy + (ly - fy) * p01;
        tgt8[i].style.transform = 'translate(' + dx.toFixed(1) + 'px,' + dy.toFixed(1) + 'px) scale(' + (1 + 0.55 * p01).toFixed(3) + ')';
    }

프레임에서 선택 주 칸은 lx = 26 + col×56, ly = 62 의 주간 좌표를 Last 로 받고 나머지는 scale 과 opacity 로 잦아들며, 되돌아올 때는 같은 보간을 거꾸로 돌아 42칸이 제자리 좌표로 복귀한다.

09날짜별 매핑으로 늘어서는 일정 도트 멀티

데모와 설명

일정을 「월-일 → 색 배열」 맵으로 두고 각 셀이 자기 키로 조회해 최대 3개 도트를 놓는다 — 키 12개 · 도트 23개이고 4건 이상인 날은 초과분을 세는 뱃지로 보인다(11-12 는 4건 → +1, 11-21 은 5건 → +2). 초점이 FOCUS_MS 800마다 일정 있는 날을 순회하며 오른쪽 위 라벨에 21일: 5건 · +2 같은 요약이 붙는다.

날짜별 매핑으로 늘어서는 일정 도트 멀티
전체 코드 새 창에서 열기

09 · 날짜별 매핑으로 늘어서는 일정 도트 멀티 — 측정 누적면적 38.478% · 움직인 프레임 23/23GODRICH 원작 · zip 에 SCSS·React 포함 · 비밀번호 보기

map lookupmax 3 dots+N badge

코드에서 볼 곳

    // map lookup — 셀의 키로 일정 배열을 찾는다. 없으면 빈 배열
    function eventsOf(d) {
        const k = f0(d.m + 1) + '-' + f0(d.d);
        return EVENTS[k] || [];
    }
        // max 3 dots — 도트는 셀마다 미리 다 만들어 두고 보인다
        for (let i2 = 0; i2 < CELLS; i2 += 1) {
            const c = g9.cells[i2];
            const evs = eventsOf(c.d);
            const n = Math.min(evs.length, 3);
            for (let k = 0; k < n; k += 1) {
                const dot = make('i', 's9__dot', c.el);
                put(dot, 10 + k * 11, CH2 - 9, DOT_R * 2, DOT_R * 2);
                dot.style.background = evs[k];
            }
            if (evs.length > 3) {
                const b = make('b', 's9__more', c.el);
                put(b, 44, CH2 - 11, 14, 11);
                b.textContent = '+N'.replace('N', f0(evs.length - 3)); // +N badge — 초과분 개수
            }
        }

초과 개수까지 Math.min 자르기와 '+N'.replace 글자 만들기의 한 줄 매핑에서 나온다.

어디에 붙이나 — 예약 폼·대시보드·여행 계획에서 캘린더가 사는 자리

숙박 예약 폼이 가장 먼저다. 체크인과 체크아웃을 하루씩 고르는 대신 05 의 범위 선택처럼 시작일을 누르고 종료일까지 쓸면 두 번의 클릭으로 며칠의 숙박이 정해지고, 중간일이 채워지는 모양이 곧 예약 기간의 길이를 보여 준다. 항공·숙소 검색 폼의 날짜 칸이 거의 다 이 판정을 쓴다.

관리자·대시보드에서는 07 처럼 큰 그리드 옆에 미니 캘린더와 요약 숫자를 두는 구조가 많다 — 왼쪽에서 기간을 훑고 오른쪽에서 선택일의 상세를 읽는 두 시선을 한 화면에 묶는다. 하루에 일정이 몇 개나 몰리는지는 09 의 도트 표기가 그대로 쓰이고, 주 단위로 보고하는 팀 화면은 08 의 월↔주 전환이 들어간다.

여행 계획이나 근무표 같이 날마다 항목이 다른 화면에서는 이 계산들이 겹쳐 돌아간다. 6주 고정 그리드 위에 오늘 링과 선택 상태와 일정 도트가 같이 얹히는 것인데, 이 편의 아홉 장면은 그 겹침을 하나씩 떼어 낸 시연이라 보면 된다.

왜 6주로 고정할까 — 달마다 높이가 점프하지 않는 그리드

달마다 실제 주 수는 4~6주로 다르다. 날 수에 맞춰 그리드를 줄이면 28일 달과 31일 달 사이에서 세로 크기가 점프하고 아래 붙은 요약 판·버튼이 매달 제자리에서 밀려나며, 02 의 전환이 겹쳐 흐르려면 두 그리드의 높이가 같아야 한다는 조건도 깨진다.

그래서 CELLS 를 42, 즉 6주로 고정하고 남는 칸은 이웃 달 날짜로 채운다 — 2026-11 은 lead 1 + 30일 + trail 11, 2027-02 는 lead 2 + 28일 + trail 12. 둘 다 합이 42 다. 그리드 끝에 보이는 "다음 달 11일" 은 버그가 아니라 6주 고정의 검산값이고, 이웃 달에서 온 칸은 cal__cell--leading-trailing 클래스로 숫자가 옅어 "이 달 아님" 이 한눈에 읽힌다.

실사용에서는 이 옅은 칸을 클릭하면 그 달로 넘어가게 하는 것이 보통이다 — 여백을 눌러 달이 바뀌는 쪽이 빈 칸을 누르는 쪽보다 손이 덜 간다. 이 편의 데모는 시연 장면이라 그 상태까지는 만들지 않았다.

오늘·선택일은 어떻게 강조하나 — 상태 클래스와 범위 판정이 만나는 지점

날짜 하나의 강조는 상태 클래스 하나로 끝난다. is-picked 가 붙으면 배경이 잉크로 뒤집히고 숫자가 크림색으로 바뀌는데, 04·07 이 이 상태를 쓴다. 오늘은 s6__today 링이라는 별도 표식이 칸을 둘러 선택과 오늘이 같은 날에 겹쳐도 둘 다 읽힌다.

범위는 강조 대상이 한 칸에서 여러 칸으로 늘어난다는 점만 다르다. 어느 칸이 범위 안인지 between 판정이 정하고(05 절), 시작일과 종료일은 알약 모서리로, 중간일은 배경 채움으로 모양이 갈라진다. 세 상태가 각자 다른 시각 장치를 쓰는 건 같은 배경색으로 겹치면 어느 상태인지 못 읽기 때문이다.

아래 SCSS 가 이 상태 문법의 핵심이다 — 이웃 달 칸의 숫자 투명도와 선택 배경 반전, 채움용 배경 요소 세 조각이면 그리드의 읽기 규칙이 정해진다.

// leading-trailing — 이웃 달에서 온 날짜. 색이 옅어 "이 달 아님" 이 한눈에 읽힌다
.cal__cell--leading-trailing .cal__num { opacity: .45; }

.cal__cell.is-picked {
  background: $subject-ink;
}

.cal__bg {
  position: absolute;
  left: 0;
  top: 0;
  display: block;
  width: 100%;
  height: 100%;
  border-radius: $r-xs;
  background: $stroke-blue;
  opacity: 0;
}

키보드로도 되나 — 그리드 탐색과 role=grid·aria-selected 접근성

장면마다 탭이 닿는 무대 패드가 있고 Space·Enter 일시정지·R 재시작·←→ 프리셋이 된다. 일시정지 버튼은 aria-pressed 로 눌림 상태를 알리고 장면 상자는 role="img" 와 aria-label 로 무엇이 보이는지를 문장으로 적어 둔다 — 01 의 라벨은 "첫 요일 오프셋을 재어 42칸이 순서대로 점등되며 이웃 달 날짜까지 채워지는 장면"이다.

실제 서비스의 캘린더에서는 날짜 셀을 role=grid 의 gridcell 로 두고 화살표 키로 칸을 옮기며 aria-selected 로 선택을 알리는 것이 WAI-ARIA 1.1 의 정석이다. 05 의 is-in-range 도 클래스만이 아니라 aria-selected 로 함께 알리면 스크린리더 사용자에게 범위가 전달되며, role=grid 와 aria-selected 는 네 브라우저 스크린리더 지원 전부에 있다(caniuse 2026-11-15 확인).

알림 문장은 아껴 쓴다. 매 프레임 바뀌는 상태 줄은 aria-live="off" 로 읽지 않고 완료 문장만 role="status" aria-live="polite" 로 한 번 알린다 — 달력이 매 초 낭독되면 오히려 못 쓴다.

함정 — new Date() 시간대 오프셋과 getDay() 첫 요일 로케일 차이

오늘 링이 어제에 그려진다 — 시간대 오프셋

new Date(2026, 10, 15) 는 로컬 자정이고 new Date(Date.UTC(2026, 10, 14, 23)) 는 UTC 기준 시각이라, 둘을 로컬 getDay()·getDate() 로 비교하면 UTC±N 환경에서 하루 어긋나 "오늘" 링이 어제 칸에 그려진다. 캘린더에서 오늘이 하루 밀리면 그대로 신뢰를 잃는데, 06 의 실측에서 localD.getTimezoneOffset() 은 이 환경에서 −540분(UTC+9)이었고 getUTC* 비교로는 "같은 날" 판정이 나왔다. 해법은 년·월·일 세 값을 따로 비교하거나 UTC 생성자와 getUTC* 로 판정하는 것이다.

첫 요일이 로케일·시간대에서 밀린다

첫 요일 오프셋을 로컬 new Date(y, m, 1).getDay() 로 재면 월 초 자정이 시간대에 따라 전날로 밀려 요일이 어긋날 수 있다. 이 편의 배치는 getUTCDay 로 재고 01 에는 대조용 로컬 getDay 판(localDow)을 함께 두었으며, 일요일 시작과 월요일 시작은 (getDay()+1) % 7 의 상수 하나 차이로 흡수된다.

월 경계 날짜가 같은 번호로 오답 채워진다

범위 판정을 날짜 번호만으로 하면 이웃 달 칸이 같은 번호로 통과한다 — 이 달의 21일과 다음 달의 21일. 데모는 이웃 달 셀을 판정 전에 탈락시켜 막았지만 실제 서비스에서는 (y, m, d) 튜플이나 타임스탬프로 비교하는 것이 안전하다.

FLIP 은 이동 전 좌표를 먼저 기록해야 한다

FLIP 은 transform 만 움직이지만 먼저 클래스를 바꿔 재배치하면 "이동 전" 좌표가 사라진다. 08 은 getBoundingClientRect 대신 gridCoords 상수 산술로 좌표를 미리 잡아 이 전제를 아예 없앴다 — 고정 그리드에서는 계산이 곧 좌표다.

아홉 장면의 소스와 편집용 파일은 아래 상자의 zip 으로 내려받을 수 있고, 여는 비밀번호는 wkyppue8 다.

슬라이드 속도와 물결 폭과 채움 간격을 바꾸면 느낌은 얼마나 달라질까 — 세 상수를 바꿔 본 차이

이름 바꾼 값 느낌
전환 시간을 늘려 02 SLIDE_MS 280 → 600 448px 이동거리는 그대로고 시간이 길어져 속도가 2.14배 느려진다 — 가·감속이 눈에 읽혀 종이책을 넘기는 촉감이 되고 280 은 스냅처럼 즉각 바뀐다
호버 물결 폭을 넓혀 03 ROW_PHASE_SPAN 1 → 2.5 감쇠가 e^(−dist²/6.25) 로 완만해져 거리 2 줄의 진폭 배율이 0.018 → 0.47 로 오른다 — 이웃 줄까지 훑듯이 번지는 물결이 된다
범위 채움 속도를 다르게 05 FILL_STEP_MS 40 → 16 16칸 채움이 640ms → 256ms 로 끝나 프레임 단위 잉크 번짐이 된다 — 40 은 칸칸이 끊어져 읽히는 계단형이다

셋 다 소스의 상수 한 줄을 바꾸는 것으로 끝난다. 값의 뜻을 알면 받은 기본값을 바로 자기 톤으로 조정할 수 있고, 이 데모 무대는 프리셋 전환으로 그 차이를 그 자리에서 보여 준다.

바꿀 때 지켜 볼 것도 정해져 있다. SLIDE_MS 를 올리면 전환 중 입력을 잠그는 시간도 같이 길어지니 600 을 넘기면 연달아 넘기는 손이 멈춘 것처럼 느껴지고, FILL_STEP_MS 를 16 아래로 내리면 채움이 한 프레임에 몰려 순차감이 사라진다. 어느 쪽이든 움직임은 줄이기 설정에서는 전부 즉시 끝나니 값 실험은 안심하고 해도 된다.

움직임 줄이기에서는 완성 상태 한 장 — 날짜 계산은 그대로 알려 주는 접근성

움직임 줄이기가 켜지면 SCSS 의 reduce 블록이 .ez * 애니메이션을 전부 끄고 JS 는 완성 상태 한 장을 그린다 — 42칸 전부 점등된 그리드, 선택이 끝난 범위, 오늘 링이 둘러진 칸. 달력은 계산 결과가 곧 내용이라 정적 한 장으로도 정보가 다 전달된다.

prefers-reduced-motion 은 Safari 10.1+ · Chrome 74+ · Firefox 63+ 부터 지원되고 미지원 환경에서는 애니메이션이 그대로 돌아가 기능이 사라지지 않는다(caniuse 2026-11-15 확인). 상태 문장은 "움직임 줄이기 켜짐 · 완성 상태 한 장" 로 갈라 읽는 사람이 무엇을 보고 있는지 알게 한다.

캘린더 UI FAQ — css만 되나 / 첫 요일 일요일로 바꾸려면 / 범위 선택은 어떻게

calendar ui html css 구조만으로 달력을 만들 수 있나요?

42칸의 자리를 잡는 것까지는 html css 로 됩니다 — grid 로 7열 6행을 두면 배치는 끝납니다. 다만 어느 칸에 몇 일이 들어가는지는 날짜 계산이라 js 가 필요하고, 이 편의 calendar ui css 장면들도 그리드 좌표는 스타일이 맡고 날짜는 계산이 맡았습니다. 숫자까지 정적 html 에 박으면 매달 손으로 고쳐야 합니다.

첫 요일을 일요일 대신 월요일로 바꾸려면 어떻게 하나요?

오프셋 식의 상수 하나를 바꿉니다 — 일요일 시작이 (getDay() + 1) % 7 이면 월요일 시작은 (getDay() + 0) % 7 로 바꾸고, 머리 요일 줄의 순서만 같이 돌리면 됩니다. 이 달 앞의 빈칸 수(lead)가 하루씩 밀릴 뿐 42칸 배분 산술은 그대로입니다.

범위 선택은 어떻게 구현하나요?

시작일과 종료일 사이 판정 — 각 칸의 날짜가 시작일 이상 종료일 이하인지 부등호로 검사하는 것으로 끝납니다(05 절). 이웃 달 칸을 걸러 내기 위해 날짜 번호가 아니라 (y, m, d) 로 비교하는 점만 주의하면 채움 애니메이션은 interval 순차 적용으로 얹습니다.

날짜 계산의 다른 축이 궁금하면 달력 그리드 모음이 같은 42칸을 다른 장면으로 풀었고, 날짜 선택 UI 패턴은 포커스와 키보드 축을, 좌석 선택 UI는 범위와 묶음 선택이 겹치는 이웃 패턴을 다룬다.

출처: Date.prototype.getDay·Date.prototype.getTimezoneOffset·ARIA grid role·prefers-reduced-motion

압축 비밀번호를 입력하세요

비밀번호는 이 글 본문 안에 있습니다. 읽다 보면 나옵니다.