Date Input

사용자가 특정 날짜 또는 기간을 입력하거나 선택하는 컴포넌트입니다. 단일 필드, 다중 필드(년/월/일 분리), 범위 필드 세 가지 유형을 제공합니다.

개요

YYYY-MM-DD 형식으로 입력해주세요

설치

사용법

DateInput, DateInputMultiple, DateInputRange를 import하여 사용합니다.

예제

단일 필드

하나의 입력 필드에 전체 날짜를 입력합니다. 사용자가 이미 알고 있는 날짜를 입력받을 때 유용합니다.

달력 버튼

showCalendarButton으로 달력 아이콘 버튼을 표시합니다. 클릭하면 내장 달력이 나타납니다.

다중 필드

년, 월, 일 정보를 개별 입력 필드를 통해 입력합니다.

여권에 표기된 만료일을 입력해주세요

년/월만 입력

hideDay를 사용하여 일 필드를 숨기고 년/월만 입력받습니다.

범위 필드 (달력으로 범위 선택)

시작일과 종료일을 입력합니다. 달력 아이콘을 클릭하면 범위 선택 달력이 나타나며, 첫 번째 클릭으로 시작일, 두 번째 클릭으로 종료일을 선택할 수 있습니다.

조회하고자 하는 기간을 선택해주세요

~

필수 입력

required 속성으로 필수 입력 필드임을 표시합니다.

예약 날짜는 필수입니다

에러 상태

hasError와 errorMessage를 함께 사용하여 유효성 검사 실패를 표시합니다.

올바른 날짜 형식을 입력해주세요 (YYYY-MM-DD)

비활성화 상태

disabled 속성으로 입력을 비활성화합니다.

~

접근성

Date Input은 WCAG 2.1 / KWCAG 2.2 기준을 준수합니다.

  • aria-label: 각 입력 필드에 명확한 레이블 제공
  • inputMode: 모바일에서 숫자 키패드 활성화
  • 키보드 탐색: Tab/Shift+Tab으로 필드 간 이동
  • 달력 접근성: 화살표 키로 날짜 이동, Enter로 선택, Escape로 닫기
  • 에러 상태: 아이콘과 색상으로 명확하게 표시