feat: 작업본·게시 기록 목록을 번호로 오간다

「다음」 버튼 하나뿐이라 뒤로 넘어가면 앞쪽으로 돌아올 수 없었다. 커서
페이지네이션이라 앞으로만 갈 수 있었기 때문이다.

서버가 총 쪽수를 주고(StudioPageMetadata) 목록은 `‹ 1 2 3 ›` 을 그린다.
쪽이 많으면 현재 쪽 좌우 2개씩만 그리고 첫·끝은 늘 남긴다 — 어디에
있든 처음과 끝으로 한 번에 갈 수 있다.

게시 기록은 페이지 이동이 아예 없었다(limit 100 으로 한 번에 다 가져왔다).
작업본과 같은 20개 단위로 맞춘다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
This commit is contained in:
DongHyeonka
2026-08-29 22:07:54 +09:00
co-authored by Claude Opus 5
parent 77125d1c7c
commit df371d38bd
14 changed files with 285 additions and 42 deletions
@@ -5,6 +5,7 @@ import type { DocumentPage } from "../../../contracts/studio/contract.ts";
import { managementFailureMessage } from "../../../application/ports/management-gateway-error.ts";
import { useStudio } from "../use-studio.ts";
import { GuardedStudioLink } from "./guarded-studio-link.tsx";
import { StudioPagination } from "./studio-pagination.tsx";
const kindLabel = {
CASE: "Case",
@@ -55,7 +56,7 @@ export function DocumentList() {
const [kind, setKind] = useState<ListDocumentsQuery["kind"]>();
const [status, setStatus] =
useState<ListDocumentsQuery["publicationStatus"]>();
const [cursor, setCursor] = useState<string>();
const [pageNumber, setPageNumber] = useState(1);
const [page, setPage] = useState<DocumentPage | null>(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState("");
@@ -119,7 +120,7 @@ export function DocumentList() {
...(q ? { q } : {}),
...(kind ? { kind } : {}),
...(status ? { publicationStatus: status } : {}),
...(cursor ? { cursor } : {}),
page: pageNumber,
limit: 20,
},
{ signal: controller.signal },
@@ -136,7 +137,7 @@ export function DocumentList() {
},
);
return () => controller.abort();
}, [cursor, gateway, kind, q, retryGeneration, status]);
}, [gateway, kind, pageNumber, q, retryGeneration, status]);
const changeFilter = (next: {
kind?: ListDocumentsQuery["kind"];
@@ -144,12 +145,13 @@ export function DocumentList() {
}) => {
if ("kind" in next) setKind(next.kind);
if ("status" in next) setStatus(next.status);
setCursor(undefined);
// 3쪽에 있던 채로 필터를 좁히면 결과가 그보다 적어 빈 화면이 나온다.
setPageNumber(1);
};
const submitSearch = (event: FormEvent) => {
event.preventDefault();
setQ(searchDraft.trim());
setCursor(undefined);
setPageNumber(1);
};
return (
@@ -240,8 +242,15 @@ export function DocumentList() {
해서, 28건 중 20건이 보이는 동안 무엇을 지워도 "20개" 가 그대로였다.
*/}
<p className="studio-result-count">
<span>{page.items.length}개 표시 중</span>
{page.nextCursor ? <span> · 더 있습니다</span> : null}
<span>
{page.page.totalElements}개 중 {page.items.length}개 표시 중
</span>
{page.page.totalPages > 1 ? (
<span>
{" "}
· {page.page.number} / {page.page.totalPages} 쪽
</span>
) : null}
</p>
{deleteError ? (
<p className="studio-screen-error" role="alert">
@@ -311,15 +320,11 @@ export function DocumentList() {
</GuardedStudioLink>
</section>
)}
{page.nextCursor ? (
<button
className="studio-secondary-button"
type="button"
onClick={() => setCursor(page.nextCursor ?? undefined)}
>
다음 작업본
</button>
) : null}
<StudioPagination
page={page.page}
label="작업본 페이지"
onChange={setPageNumber}
/>
</>
) : null}
</div>
@@ -17,6 +17,7 @@ import {
} from "./publication-flow-classes.ts";
import { UnpublishDialog } from "./unpublish-dialog.tsx";
import { useStudio } from "../use-studio.ts";
import { StudioPagination } from "./studio-pagination.tsx";
const eventLabels = {
PUBLISHED: "게시",
@@ -57,7 +58,7 @@ export function PublicationList({
classes: styles = defaultPublicationFlowClasses,
}: { classes?: PublicationFlowClasses } = {}) {
const studio = useStudio();
const [query, setQuery] = useState<ListPublicationsQuery>({ limit: 100 });
const [query, setQuery] = useState<ListPublicationsQuery>({ page: 1, limit: 20 });
const [queryDraft, setQueryDraft] = useState("");
const [typeDraft, setTypeDraft] =
useState<ListPublicationsQuery["type"]>();
@@ -273,6 +274,13 @@ export function PublicationList({
})}
</ol>
) : null}
{state.status === "READY" ? (
<StudioPagination
page={state.page.page}
label="게시 기록 페이지"
onChange={(next) => setQuery((current) => ({ ...current, page: next }))}
/>
) : null}
<UnpublishDialog
item={selected}
@@ -0,0 +1,88 @@
import type { components } from "../../../contracts/studio/generated.ts";
type PageMetadata = components["schemas"]["StudioPageMetadata"];
/**
* 페이지가 많아지면 번호를 다 그릴 수 없다. 현재 쪽 좌우로 이만큼씩만 그리고 나머지는 생략한다 —
* 첫 쪽과 끝 쪽은 늘 남긴다. 목록 어디에 있든 처음과 끝으로 한 번에 갈 수 있어야 한다.
*/
const AROUND = 2;
function pageNumbers(current: number, total: number): ReadonlyArray<number | "gap"> {
if (total <= 1) return total === 1 ? [1] : [];
const shown = new Set<number>([1, total]);
for (let n = current - AROUND; n <= current + AROUND; n += 1) {
if (n >= 1 && n <= total) shown.add(n);
}
const sorted = [...shown].sort((left, right) => left - right);
const out: (number | "gap")[] = [];
let previous = 0;
for (const n of sorted) {
if (previous && n - previous > 1) out.push("gap");
out.push(n);
previous = n;
}
return out;
}
/**
* Studio 목록의 페이지 이동.
*
* <p>예전에는 「다음」 하나뿐이었다 — 목록이 커서 페이지네이션이라 앞으로만 갈 수 있었고, 뒤로
* 넘어간 뒤 앞쪽으로 돌아올 방법이 없었다. 지금은 서버가 총 쪽수를 주므로 번호를 그린다.
*/
export function StudioPagination({
page,
onChange,
label,
}: {
page: PageMetadata;
onChange: (next: number) => void;
/** 이 목록이 무엇인지 — 화면에 목록이 둘 이상일 때 보조 기술이 구분한다. */
label: string;
}) {
if (page.totalPages <= 1) return null;
const numbers = pageNumbers(page.number, page.totalPages);
return (
<nav className="studio-pagination" aria-label={label}>
<button
type="button"
onClick={() => onChange(page.number - 1)}
disabled={!page.hasPrevious}
aria-label="이전 페이지"
>
‹
</button>
<ol>
{numbers.map((entry, index) =>
entry === "gap" ? (
// 생략된 구간. 읽어 줄 것이 없으므로 보조 기술에서는 숨긴다.
<li key={`gap-${index}`} aria-hidden="true" className="studio-pagination__gap">
…
</li>
) : (
<li key={entry}>
<button
type="button"
onClick={() => onChange(entry)}
aria-label={`${entry} 페이지`}
aria-current={entry === page.number ? "page" : undefined}
>
{entry}
</button>
</li>
),
)}
</ol>
<button
type="button"
onClick={() => onChange(page.number + 1)}
disabled={!page.hasNext}
aria-label="다음 페이지"
>
›
</button>
</nav>
);
}
@@ -189,3 +189,15 @@
.studio-app .studio-document-tools form { grid-column: 1; }
.studio-app .studio-document-row dl { grid-template-columns: minmax(0, 1fr); }
}
/*
목록의 페이지 이동. 예전에는 「다음」 버튼 하나뿐이라 뒤로 넘어간 뒤 앞쪽으로 돌아올 방법이
없었다. 번호는 현재 쪽 좌우로만 그리고 나머지는 생략하되 첫 쪽과 끝 쪽은 늘 남긴다.
*/
.studio-app .studio-pagination { display: flex; align-items: center; gap: 6px; margin-top: 32px; }
.studio-app .studio-pagination ol { display: flex; align-items: center; gap: 4px; margin: 0; padding: 0; list-style: none; }
.studio-app .studio-pagination button { min-width: 40px; min-height: 40px; padding-inline: 10px; border: 1px solid var(--line-strong); border-radius: 5px; background: var(--paper); color: var(--ink); font: inherit; font-size: 14px; font-weight: 550; }
.studio-app .studio-pagination button:disabled { opacity: 0.4; }
/* 지금 보고 있는 쪽. 눌러도 같은 자리라는 것이 보여야 한다. */
.studio-app .studio-pagination button[aria-current="page"] { border-color: var(--signal); background: var(--signal); color: #fff; }
.studio-app .studio-pagination__gap { min-width: 24px; color: var(--faint); text-align: center; }