기간 이동

달·주·날 단위로 보는 화면에서 이전·다음 기간으로 넘기는 링크와 지금 기간으로 돌아가는 링크를 한 줄에 둔다. 모두 href 링크라 상태가 없고 서버에서 렌더된다. 기간 계산과 주소 생성은 호출자가 맡고, 지금 기간을 보고 있을 때는 currentHref 를 주지 않아 되돌아가기 링크가 사라진다.

상태

지금 기간

다른 기간

활용 방법

단위

unit 에 따라 이전·다음 링크의 접근 가능한 이름과 되돌아가기 문구(이번 달 · 이번 주 · 오늘)가 바뀐다.

Preview

tsx

<PeriodNav
  unit="달"
  label="2026년 9월"
  prevHref="?month=2026-08"
  nextHref="?month=2026-10"
  currentHref={isCurrentMonth ? undefined : "?"}
/>

속성

이름	타입	기본값	설명
unit	"달" \| "주" \| "날"	-	넘기는 단위. 링크 이름과 되돌아가기 문구가 따른다
label	string	-	지금 보고 있는 기간 이름
prevHref	string	-	이전 기간 주소
nextHref	string	-	다음 기간 주소
currentHref	string	-	지금 기간 주소. 지금 기간이 아닐 때만 준다
aria-label	string	"<unit> 이동"	nav 접근 가능한 이름
className	string	-	root nav 클래스
ref	Ref<HTMLElement>	-	root nav