Table

대량의 데이터를 행과 열의 그리드 형식으로 정리하여 보여주는 요소입니다. 구조화된 정보를 통해 사용자가 데이터 간의 관계를 쉽게 비교하고 패턴을 파악할 수 있도록 돕습니다. 화면 너비를 확보할 수 있는 데스크톱 환경에서만 사용합니다.

Anatomy

  1. 1Table head
  2. 2Table head cell
  3. 3Table body
  4. 4Table cell
  5. 5Pagination

Variants

HeadHead
CellCell
CellCell
CellCell
CellCell
CellCell
Content
Pagination

Table head size

높이와 좌측 여백을 고정해 사용합니다.

Table cell size

최소 높이를 가지며, 내용이 많아지면 상하단 여백을 유지한 채 높이가 가변합니다.

Interaction

테이블의 각 행은 데이터를 보여주는 역할을 하며 별도의 인터랙션을 가지지 않는 것이 기본입니다. 필요할 경우 인터랙션을 추가하여 행 전체 선택이 가능하도록 사용할 수 있습니다.

Scroll

많은 데이터 목록을 표시할 때 화면에 보이는 영역만 그려주어 스크롤 성능을 최적화합니다. 스크롤 시 Table head는 상단에 고정됩니다.

Selection

Table 내 특정 항목을 선택하거나, 여러 항목을 한 번에 선택할 수 있습니다.

  • Text: 가장 기본적인 형태로, 해당 열이 무엇을 의미하는지 단순히 제목만 표시합니다.
  • Order: 해당 열의 데이터를 정렬하는 기능을 제공합니다. 클릭 시 데이터를 오름차순 또는 내림차순으로 정렬할 수 있습니다.
  • Filter: 해당 열의 데이터를 필터링하는 기능을 제공합니다. 클릭 시 특정 조건을 선택하거나 입력하여 원하는 데이터만 걸러볼 수 있습니다.

Cell

  • Text: 가장 기본적인 형태로, 텍스트 기반의 정보를 표시하기 위해 사용됩니다. 텍스트 기반의 간단한 정보부터, 부연 설명을 포함하는 형태 등을 표현할 수 있습니다.
  • Action: 사용자가 클릭하여 특정 동작을 수행하도록 하는 인터랙티브 요소를 포함합니다. 버튼을 통해 행과 관련된 다양한 기능을 실행할 수 있습니다.
  • Content: 시각적 요소를 통해 정보의 식별을 돕습니다. 사용자를 나타내는 아바타(Avatar), 상태를 나타내는 배지(Badges), 의미를 함축하는 아이콘(Icons) 등을 활용합니다.

Align

좌측 정렬을 기본으로 하며, 가격과 같은 숫자 데이터의 경우 자릿수를 비교하기 쉽게 우측 정렬로 표시합니다.

How to use

Do

각 열이 어떤 데이터를 의미하는지 알 수 있도록 헤더를 항상 표시합니다.

Don’t

사용자가 정보를 한 눈에 파악할 수 없을 정도로 너무 많은 내용을 포함하지 않습니다.

Customize

Head Content
rowAlignItems
cellPadding
typography
contentColor
Body Content
rowAlignItems
cellPadding
typography
contentColor

© 2026 Wanted Lab, Inc.