feat: add pagination component

packages/core/lib/components/Pagination.tsx

@@ -0,0 +1,238 @@
+import React, { useState } from 'react';
+import { Label } from './Label';
+import { Button } from './Button';
+
+function generateSequence(current: number, count: number): number[] {
+  const result: number[] = [];
+  const start = current - Math.floor((count - 1) / 2);
+
+  for (let i = 0; i < count; i++) {
+    result.push(start + i);
+  }
+
+  return result;
+}
+
+function generateRangeGuaranteedSequence(
+  current: number,
+  count: number,
+  min: number,
+  max: number
+): (number | string)[] {
+  const initialSequence = generateSequence(current, count);
+  const filteredSequence = initialSequence.filter(
+    (num) => num >= min && num <= max
+  );
+  const result: (number | 'ellipsis')[] = [...filteredSequence];
+
+  if (!filteredSequence.includes(min)) {
+    if (filteredSequence[0] - min > 1) {
+      result.unshift(min, 'ellipsis');
+    } else {
+      result.unshift(min);
+    }
+  }
+
+  if (!filteredSequence.includes(max)) {
+    if (max - filteredSequence[filteredSequence.length - 1] > 1) {
+      result.push('ellipsis', max);
+    } else {
+      result.push(max);
+    }
+  }
+
+  return result;
+}
+
+export const PrevIcon: React.FC = () => (
+  <svg
+    width="24"
+    height="24"
+    viewBox="0 0 24 24"
+    fill="none"
+    xmlns="http://www.w3.org/2000/svg"
+  >
+    <path
+      d="M15 18L9 12L15 6"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    />
+  </svg>
+);
+
+export const NextIcon: React.FC = () => (
+  <svg
+    width="24"
+    height="24"
+    viewBox="0 0 24 24"
+    fill="none"
+    xmlns="http://www.w3.org/2000/svg"
+  >
+    <path
+      d="M9 18L15 12L9 6"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    />
+  </svg>
+);
+
+export const EllipsisIcon: React.FC = () => (
+  <svg
+    width="24"
+    height="24"
+    viewBox="0 0 24 24"
+    fill="none"
+    xmlns="http://www.w3.org/2000/svg"
+    aria-hidden="true"
+  >
+    <circle cx="5" cy="12" r="2" fill="currentColor" />
+    <circle cx="12" cy="12" r="2" fill="currentColor" />
+    <circle cx="19" cy="12" r="2" fill="currentColor" />
+  </svg>
+);
+
+interface PaginationProps {
+  totalPages: number;
+  currentPage: number;
+  onPageChange: (page: number) => void;
+  visiblePages?: number;
+  allowDirectInput?: boolean;
+  twoLines?: boolean;
+}
+
+export const Pagination: React.FC<PaginationProps> = ({
+  totalPages,
+  currentPage,
+  onPageChange,
+  visiblePages: propVisiblePages = 5,
+  allowDirectInput = false,
+  twoLines = false,
+}) => {
+  const [inputPage, setInputPage] = useState<number>(currentPage);
+  const visiblePages = Math.max(
+    propVisiblePages % 2 === 0 ? propVisiblePages + 1 : propVisiblePages,
+    1
+  );
+  const showTwoLines = twoLines && !allowDirectInput;
+  const pageNumbers = generateRangeGuaranteedSequence(
+    currentPage,
+    visiblePages,
+    1,
+    totalPages
+  );
+
+  const handleDirectInput = () => {
+    if (inputPage >= 1 && inputPage <= totalPages) {
+      onPageChange(inputPage);
+    } else {
+      onPageChange(currentPage);
+    }
+  };
+
+  const renderPageNumbers = () => (
+    <ul className="flex gap-2">
+      {pageNumbers.map((page, index) => (
+        <li key={index}>
+          {page === 'ellipsis' ? (
+            <span className="w-8 h-8 flex items-center justify-center text-gray-70">
+              <EllipsisIcon />
+            </span>
+          ) : (
+            <button
+              onClick={() => onPageChange(page as number)}
+              className={`w-8 h-8 rounded-2 focus:outline-none focus:ring-2 focus:ring-primary-50 ${
+                currentPage === page
+                  ? 'bg-primary text-white font-bold'
+                  : 'text-gray-70 hover:bg-gray-20'
+              }`}
+              aria-current={currentPage === page ? 'page' : undefined}
+              aria-label={`페이지 ${page}`}
+            >
+              {page}
+            </button>
+          )}
+        </li>
+      ))}
+    </ul>
+  );
+
+  const prevButton = (
+    <button
+      onClick={() => onPageChange(currentPage - 1)}
+      disabled={currentPage === 1}
+      className="flex items-center text-gray-70 justify-center p-2 pr-4 rounded-full focus:outline-none focus:ring-2 focus:ring-primary-50 disabled:opacity-50 hover:bg-gray-20"
+      aria-label="이전 페이지"
+    >
+      <PrevIcon />
+      이전
+    </button>
+  );
+
+  const nextButton = (
+    <button
+      onClick={() => onPageChange(currentPage + 1)}
+      disabled={currentPage === totalPages}
+      className="flex items-center text-gray-70 justify-center p-2 pl-4 rounded-full focus:outline-none focus:ring-2 focus:ring-primary-50 disabled:opacity-50 hover:bg-gray-20"
+      aria-label="다음 페이지"
+    >
+      다음
+      <NextIcon />
+    </button>
+  );
+
+  const inputPageNumber = (e: React.KeyboardEvent<HTMLInputElement>) => {
+    if (e.key === ' ' || e.key === 'Enter') {
+      e.preventDefault();
+      onPageChange(inputPage);
+      return;
+    }
+  };
+
+  return (
+    <nav
+      aria-label={'페이지 네비게이션'}
+      className={`${'flex items-center gap-6 flex-col'}`}
+    >
+      {showTwoLines && (
+        <div className={`flex items-center gap-2`}>
+          {prevButton}
+          {nextButton}
+        </div>
+      )}
+      <div className={`flex items-center gap-2`}>
+        {!showTwoLines && prevButton}
+        {renderPageNumbers()}
+        {!showTwoLines && nextButton}
+      </div>
+      {allowDirectInput && (
+        <div className="flex items-center gap-2">
+          <input
+            type="number"
+            value={inputPage}
+            onChange={(e) => setInputPage(parseInt(e.target.value, 10))}
+            onKeyDown={inputPageNumber}
+            min={1}
+            max={totalPages}
+            className="w-14 px-2 py-1 border border-gray-50 rounded-2 focus:outline-none focus:ring-2 focus:ring-primary-50 text-right"
+            aria-label="페이지 직접 입력"
+          />
+          <Label size="s" color="gray-60">
+            / {totalPages}
+          </Label>
+          <Button
+            onClick={handleDirectInput}
+            size="x-small"
+            variant="secondary"
+            className="focus:outline-none focus:ring-2 focus:ring-primary-50 ml-4"
+          >
+            이동
+          </Button>
+        </div>
+      )}
+    </nav>
+  );
+};

packages/core/lib/index.ts

@@ -24,6 +24,7 @@ import { Tabs } from './components/Tab';
 import { Modal } from './components/Modal';
 import { Accordion } from './components/Accordion';
 import { Disclosure } from './components/Disclosure';
+import { Pagination } from './components/Pagination';
 
 export { Display, Heading, Title, Body, Detail, Label, Link, colors };
 export {
@@ -43,4 +44,5 @@ export {
   Modal,
   Accordion,
   Disclosure,
+  Pagination,
 };

stories/core/Pagination.stories.ts

@@ -0,0 +1,92 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { fn } from '@storybook/test';
+import { Pagination } from '../../packages/core/lib';
+
+const meta = {
+  title: 'Components/Pagination',
+  component: Pagination,
+  parameters: {
+    layout: 'centered',
+  },
+  tags: ['autodocs'],
+  argTypes: {
+    totalPages: {
+      control: {
+        type: 'number',
+      },
+    },
+    currentPage: {
+      control: {
+        type: 'number',
+      },
+    },
+    onPageChange: { action: 'clicked' },
+    visiblePages: {
+      control: {
+        type: 'number',
+      },
+      description:
+        '페이지 번호 중 표시할 페이지 수: 항상 홀수개로 표시됩니다. 짝수를 넣으면 +1로 계산됩니다.',
+    },
+    allowDirectInput: {
+      control: 'boolean',
+    },
+    twoLines: {
+      control: 'boolean',
+      description: '직접 입력 버튼을 표시하면 적용되지 않습니다.',
+    },
+  },
+} satisfies Meta<typeof Pagination>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  args: {
+    totalPages: 20,
+    currentPage: 9,
+    onPageChange: (page: number) => console.log(`Clicked page ${page}`),
+    visiblePages: 5,
+    allowDirectInput: false,
+    twoLines: false,
+  },
+};
+
+export const TwoLines: Story = {
+  args: {
+    totalPages: 20,
+    currentPage: 9,
+    onPageChange: (page: number) => console.log(`Clicked page ${page}`),
+    visiblePages: 5,
+    allowDirectInput: false,
+    twoLines: true,
+  },
+};
+
+export const WithInput: Story = {
+  args: {
+    totalPages: 20,
+    currentPage: 9,
+    onPageChange: (page: number) => console.log(`Clicked page ${page}`),
+    visiblePages: 5,
+    allowDirectInput: true,
+  },
+};
+
+export const Short: Story = {
+  args: {
+    totalPages: 20,
+    currentPage: 4,
+    onPageChange: (page: number) => console.log(`Clicked page ${page}`),
+    visiblePages: 5,
+  },
+};
+
+export const All: Story = {
+  args: {
+    totalPages: 10,
+    currentPage: 4,
+    onPageChange: (page: number) => console.log(`Clicked page ${page}`),
+    visiblePages: 10,
+  },
+};