스타일
styles는 캘린더의 어떤 CSS 클래스든 덮어쓸 수 있는 기능을 제공합니다. 각 값을 CSS 클래스 목록으로 교체할 수 있습니다.
모듈별 CSS
기존 styles/index.css, styles/layout.css, styles/themes/*.css는 모든 기능의 스타일을 계속 제공하며 호환성을 유지합니다. CSS 크기를 줄이려면 필요한 부분만 가져오세요. JavaScript 확장을 등록해도 CSS가 자동으로 로드되지는 않습니다.
각 그룹에는 core, motion, time, annotations, weeks, months가 있습니다. core와 사용하는 모든 확장의 스타일을 가져오세요. 나중에 set()으로 활성화할 기능도 포함해야 합니다.
| 경로 | 내용 |
|---|---|
styles/index.css | 전체 레이아웃과 밝은/어두운 테마 |
styles/{part}.css | 선택한 부분의 레이아웃과 밝은/어두운 테마 |
styles/layout/{part}.css | 선택한 부분의 레이아웃만 포함, 테마 제외 |
styles/themes/{theme}/{part}.css | 선택한 테마에서 해당 부분의 스타일만 포함 |
시간 선택과 자동 밝은/어두운 테마 전환을 사용하는 달력:
import { Calendar, time } from 'vanilla-calendar-pro';
import 'vanilla-calendar-pro/styles/core.css';
import 'vanilla-calendar-pro/styles/time.css';
new Calendar('#calendar', {
extensions: [time],
selectionTimeMode: 24,
}).init();테마를 별도로 선택하려면 레이아웃 부분과 해당 테마 부분을 가져오세요. 시간 선택을 사용하는 밝은 달력의 예:
import { Calendar, time } from 'vanilla-calendar-pro';
import 'vanilla-calendar-pro/styles/layout/core.css';
import 'vanilla-calendar-pro/styles/layout/time.css';
import 'vanilla-calendar-pro/styles/themes/light/core.css';
import 'vanilla-calendar-pro/styles/themes/light/time.css';
new Calendar('#calendar', {
extensions: [time],
selectionTimeMode: 24,
selectedTheme: 'light',
}).init();light 대신 dark 또는 slate-light를 사용할 수 있습니다. 사용자 정의 테마에는 해당 레이아웃 부분과 직접 작성한 CSS만 필요합니다. 테마 감지와 selectedTheme는 기존과 동일하게 동작합니다. 달력이 전환할 수 있는 모든 테마를 가져오세요.
각 계층에서 전체 파일 또는 모듈 파일 중 하나를 선택하여 규칙이 중복 로드되지 않게 하세요. CSS 클래스, 선택자, 브라우저 지원과 공개 --vc-* 재정의는 유지됩니다. motion, months와 같이 테마별 규칙이 없는 부분은 유효한 빈 CSS 파일입니다.
모든 확장을 사용한다면 전체 스타일시트를 유지하세요. 여섯 부분을 모두 가져오는 것보다 압축 효율이 좋습니다.
다운로드 가능한 package.zip에는 다섯 개의 전체 스타일시트가 포함됩니다. 모듈별 CSS는 npm 패키지와 직접 CDN URL로 제공됩니다.
CSS 클래스
아래는 모든 기본 클래스 목록입니다.
new Calendar('#calendar', {
styles: {
// 기본
calendar: 'vc',
controls: 'vc-controls',
grid: 'vc-grid',
column: 'vc-column',
// 헤더
header: 'vc-header',
headerContent: 'vc-header__content',
month: 'vc-month',
year: 'vc-year',
arrowPrev: 'vc-arrow vc-arrow_prev',
arrowNext: 'vc-arrow vc-arrow_next',
// 월 / 연도 선택기
wrapper: 'vc-wrapper',
content: 'vc-content',
months: 'vc-months',
monthsRow: 'vc-months__row',
monthsCell: 'vc-months__cell',
monthsMonth: 'vc-months__month',
years: 'vc-years',
yearsRow: 'vc-years__row',
yearsCell: 'vc-years__cell',
yearsYear: 'vc-years__year',
// 주 행 / 주 번호
week: 'vc-week',
weekDay: 'vc-week__day',
weekDayBtn: 'vc-week__day-btn',
weekNumbers: 'vc-week-numbers',
weekNumbersTitle: 'vc-week-numbers__title',
weekNumbersContent: 'vc-week-numbers__content',
weekNumber: 'vc-week-number',
// 날짜
collapse: 'vc-collapse',
dates: 'vc-dates',
datesRow: 'vc-dates__row',
date: 'vc-date',
dateBtn: 'vc-date__btn',
// 팝업 및 툴팁
datePopup: 'vc-date__popup',
dateRangeTooltip: 'vc-date-range-tooltip',
// 시간 컨트롤
time: 'vc-time',
timeContent: 'vc-time__content',
timeHour: 'vc-time__hour',
timeMinute: 'vc-time__minute',
timeKeeping: 'vc-time__keeping',
timeRanges: 'vc-time__ranges',
timeRange: 'vc-time__range',
},
});CSS 변수
내장 테마(light, dark, slate-light)의 모든 색상은 CSS custom property로 정의되어 있으며, 기본값(fallback)은 각 테마의 원래 색상입니다. 즉, CSS 클래스를 건드리거나 테마 오버라이드가 제대로 적용되길 기다릴 필요 없이 몇 개의 변수만 설정하면 캘린더 스타일을 바꿀 수 있습니다.
:root {
--vc-date-selected-bg: #7c3aed;
--vc-date-selected-color: #fff;
}변수를 설정하지 않으면 캘린더는 이전과 완전히 동일하게 렌더링됩니다 — 변수를 명시적으로 설정하기 전까지는 아무것도 바뀌지 않습니다.
:root에 변수를 설정하면 모든 테마에 한 번에 적용됩니다(light/dark/slate-light 모두 동일한 변수 이름을 사용합니다). 특정 테마 하나만 재정의하려면, 해당 테마의 셀렉터로 범위를 제한하세요. 예: [data-vc-theme='dark'] { --vc-date-selected-bg: #7c3aed; }.기본
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-bg | white | slate-900 | slate-100 |
--vc-color | slate-900 | white | gray-800 |
--vc-focus-outline-color | orange-300 | orange-300 | blue-300 |
헤더 / 타이틀
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-header-color | slate-900 | white | gray-800 |
--vc-title-color | slate-900 | white | gray-800 |
--vc-title-color-hover | slate-500 | slate-500 | gray-600 |
--vc-title-color-disabled | slate-300 | slate-700 | gray-400 |
월 / 연도 선택
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-months-years-bg | white | slate-900 | slate-100 |
--vc-months-years-color | slate-500 | white | gray-600 |
--vc-months-years-bg-hover | slate-100 | slate-800 | slate-200 |
--vc-months-years-color-disabled | slate-300 | slate-700 | gray-400 |
--vc-months-years-bg-selected | cyan-500 | slate-500 | blue-500 |
--vc-months-years-color-selected | white | white | white |
접기 컨트롤
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-collapse-color | slate-300 | slate-600 | slate-300 |
요일 행 / 주 번호
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-week-numbers-title-color | slate-500 | white | gray-600 |
--vc-week-number-color | slate-500 | white | gray-600 |
--vc-week-number-color-hover | slate-600 | slate-300 | gray-800 |
--vc-week-day-color | slate-500 | white | gray-600 |
--vc-week-day-color-hover | slate-600 | slate-300 | gray-800 |
--vc-week-day-off-color | rose-500 | rose-500 | red-500 |
--vc-week-day-off-color-hover | rose-600 | rose-600 | red-600 |
날짜
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-date-bg | white | slate-900 | slate-100 |
--vc-date-color | slate-900 | slate-400 | gray-800 |
--vc-date-color-hover dark only | — | slate-200 | — |
--vc-date-bg-hover | slate-100 | slate-800 | slate-200 |
--vc-date-hover-bg | slate-100 | slate-800 | slate-200 |
--vc-date-hover-edge-bg | slate-200 | slate-700 | slate-300 |
--vc-date-disabled-color | slate-300 | slate-700 | gray-400 |
--vc-date-outside-color | slate-400 | slate-600 | gray-400 |
--vc-date-today-bg | slate-100 | slate-800 | slate-200 |
--vc-date-today-color | cyan-500 | cyan-500 | blue-500 |
--vc-date-today-outside-color | slate-500 | slate-600 | gray-600 |
--vc-date-selected-bg | cyan-500 | cyan-500 | blue-500 |
--vc-date-selected-color | white | white | white |
--vc-date-selected-outside-bg | slate-300 | slate-700 | slate-300 |
--vc-date-selected-outside-color | slate-500 | slate-300 | gray-600 |
주말 / 공휴일
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-date-weekend-color | rose-500 | rose-500 | red-500 |
--vc-date-weekend-bg-hover | rose-50 | slate-800 | slate-200 |
--vc-date-weekend-hover-bg | rose-50 | slate-800 | slate-200 |
--vc-date-weekend-hover-edge-bg | rose-100 | slate-700 | slate-300 |
--vc-date-weekend-disabled-color | slate-300 | slate-700 | gray-400 |
--vc-date-weekend-today-color | rose-500 | rose-500 | red-500 |
--vc-date-weekend-today-disabled-color | slate-300 | slate-700 | gray-400 |
--vc-date-weekend-outside-bg | white | slate-900 | slate-100 |
--vc-date-weekend-outside-color | slate-400 | slate-600 | gray-400 |
--vc-date-weekend-outside-color-hover dark only | — | slate-300 | — |
--vc-date-weekend-outside-bg-hover | slate-100 | slate-800 | slate-200 |
--vc-date-weekend-outside-hover-bg | slate-100 | slate-800 | slate-200 |
--vc-date-weekend-today-outside-color | slate-400 | slate-400 | gray-400 |
--vc-date-weekend-disabled-outside-color | slate-300 | slate-700 | gray-400 |
--vc-date-weekend-selected-bg | rose-500 | rose-500 | red-500 |
--vc-date-weekend-selected-color | white | white | white |
선택된 범위 (multiple-ranged)
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-date-range-middle-bg | cyan-500 at 70% | cyan-500 at 80% | blue-500 at 80% |
--vc-date-range-middle-color | white | white | white |
--vc-date-range-middle-outside-bg | slate-200 | slate-800 | slate-200 |
--vc-date-range-middle-outside-color | slate-500 | slate-300 | gray-600 |
--vc-date-range-middle-weekend-bg | rose-500 at 70% | rose-500 at 80% | red-500 at 80% |
--vc-date-range-middle-weekend-color | white | white | white |
팝업 & 툴팁
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-date-popup-bg | white | slate-800 | white |
--vc-date-popup-color | slate-900 | white | gray-800 |
--vc-date-range-tooltip-bg | slate-50 | slate-800 | slate-50 |
--vc-date-range-tooltip-color | slate-500 | slate-400 | slate-500 |
시간 컨트롤
| 변수 | light | dark | slate-light |
|---|---|---|---|
--vc-time-border-color | slate-300 | slate-800 | gray-300 |
--vc-time-separator-color | slate-900 | white | gray-800 |
--vc-time-input-bg | white | slate-900 | slate-100 |
--vc-time-input-color | slate-900 | white | gray-800 |
--vc-time-input-bg-hover | orange-100 | slate-700 | blue-100 |
--vc-time-keeping-color | slate-500 | slate-500 | gray-600 |
--vc-time-keeping-color-hover dark only | — | slate-400 | — |
--vc-time-range-bg | white | slate-900 | slate-100 |
--vc-time-range-track-color | slate-300 | slate-600 | slate-300 |
--vc-time-range-thumb-bg | white | slate-800 | slate-100 |
--vc-time-range-thumb-border | slate-300 | slate-600 | gray-300 |
--vc-time-range-thumb-border-hover | slate-400 | slate-400 | gray-400 |
"dark only"로 표시된 세 변수는 dark 테마에만 light/slate-light 테마에는 없는 추가 hover 상태가 있기 때문에 존재합니다 — 다른 테마에서는 이 변수들을 재정의할 대상 자체가 없습니다.
크기
캘린더는 거의 모든 크기를 rem 단위로 지정하므로 루트 폰트 크기(root font-size)에 따라 함께 스케일됩니다. 페이지에서 이를 브라우저 기본값인 16px에서 다른 값으로 재설정한 경우(오래된 프레임워크인 Bootstrap 3 등에서 흔하며, 보통 10px), 캘린더가 잘못된 비율로 렌더링됩니다. transform 하나로 원래 크기를 복원할 수 있습니다:
[data-vc='calendar'] {
transform: scale(16 / <루트 폰트 크기, px 단위>);
}예를 들어 루트가 10px인 경우: transform: scale(1.6);.