---
{"id":"pagination","title":"페이지 나누기","category":"컴포넌트","order":44,"summary":"큰 목록을 여러 페이지로 탐색의 사용·상태·접근성 계약.","status":"문서 기준 · UI 미검증","references":["components/pagination/usage"]}
---

# 페이지 나누기

## 목적과 사용

큰 목록을 여러 페이지로 탐색에 사용합니다. 주문 진행 단계나 데이터 처리 진행률 표시가 아닙니다.

## 구성과 변형

현재 범위, 전체 수 또는 알 수 없음, 이전/다음, 페이지 크기. 변형의 외형은 각 제품의 기존 [토큰](tokens.md)을 사용합니다. Carbon의 크기·색·모서리·아이콘을 가져오지 않습니다.

## 동작 규칙

- PAG-01 MUST: 첫·마지막 페이지의 불가능한 이동을 명확히 표시합니다.
- PAG-02 MUST: 전체 수를 모르면 추측한 전체 페이지를 표시하지 않습니다.
- PAG-03 SHOULD: 필터·정렬 변경 시 유효한 페이지로 이동합니다.
- PAG-04 MUST: 현재 표시 범위와 실제 API 범위를 맞춥니다.

## 접근성

페이지 이동 이름, 현재 페이지 상태와 이동 후 결과 문맥을 알립니다. 공통 [접근성 기준](accessibility.md)도 함께 적용합니다.

## 콘텐츠 예시

좋음: ‘21–40 / 126개’ / 피함: 현재 위치 없는 화살표만.

## 우리 구현과 연결

제품별 서버 페이지네이션 계약을 유지합니다.

제품별 소유 경로는 [WICKEDVPS](product-vps.md), [Panel](product-panel.md), [Blesta](product-blesta.md)와 [소스 근거](source-evidence.md)를 확인합니다. 코드 존재와 모든 사용처의 준수는 다르며, 별도 표시가 없는 제품별 준수 상태는 미검증입니다.

## 상태와 검증

첫·마지막·빈 목록·항목 삭제로 페이지가 없어짐·크기 변경을 확인합니다.

일반·hover·focus·실행 중·실패·성공·disabled·read-only 중 해당하는 상태를 기록합니다. 해당하지 않는 상태를 임의로 만들지 말고 이유를 남깁니다. [검증 체크리스트](testing.md)에 증거를 연결합니다.