Props

필수 Props

Prop	타입	설명
columns	Column[]	컬럼 정의 배열
rows	any[]	행 데이터 배열. 각 객체는 id 필드 필요

Props

Prop	타입	기본값	설명
height	number	500	그리드 전체 높이(px)
rowHeight	number	40	각 행의 높이(px). 가상 스크롤 계산에 사용
usePaging	boolean	false	페이징 활성화 여부
pageSize	number	20	페이지당 표시 행 수 (v-model:pageSize 지원)
currentPage	number	1	현재 페이지 번호 (v-model:currentPage 지원)
useCheckbox	boolean	false	첫 번째 컬럼에 체크박스 활성화
showAdd	boolean	false	툴바에 추가 버튼 표시
showDelete	boolean	false	툴바에 삭제 버튼 표시
useFilter	boolean	false	컬럼별 필터 입력 행 표시
showFooter	boolean	false	하단 집계 행 표시. 컬럼 footer 속성으로 집계 방식 지정
useTree	boolean	false	트리(계층) 구조 모드. rows에 children 배열을 중첩해 사용
treeKey	string	''	트리 인덴트·토글을 표시할 컬럼 key. 미지정 시 첫 번째 컬럼
childrenKey	string	'children'	자식 행 배열 필드명
rowClass	(row, rowIndex) => any	null	행에 동적 CSS 클래스를 적용하는 함수
cellClass	(row, column, rowIndex) => any	null	셀에 동적 CSS 클래스를 적용하는 함수
showColumnSettings ⚠️	boolean	false	컬럼 표시/숨기기 설정 버튼 표시. useColumnSettings 사용 권장
useColumnSettings	boolean	false	컬럼 표시/숨기기 설정 버튼 표시 (showColumnSettings의 권장 alias)
useContextMenu	boolean	false	우클릭 컨텍스트 메뉴 사용
useRowDrag	boolean	false	행 드래그 재배치 활성화
groupBy	string	''	그룹핑 기준 컬럼 key
autoMergeCols	string[]	[]	인접한 동일 값 셀을 자동 병합할 컬럼 key 목록
mergeCells	(row, colKey) => \{ rowspan?, colspan? \} | null	null	셀별 병합 규칙을 반환하는 함수. 병합하지 않을 경우 null 반환
showExcelExport ⚠️	boolean	false	툴바에 Excel 내보내기 버튼 표시. useExcelExport 사용 권장
useExcelExport	boolean	false	툴바에 Excel 내보내기 버튼 표시 (showExcelExport의 권장 alias)
excelFilename	string	'export.xlsx'	Excel 저장 파일명
serverSide ⚠️	boolean	false	서버사이드 모드. useServerSide 사용 권장
useServerSide	boolean	false	서버사이드 모드. 정렬/필터/페이징을 서버에 위임 (serverSide의 권장 alias)
totalRows	number	0	서버사이드 모드에서 전체 행 수. 페이징 UI 계산에 사용
debug	boolean	false	개발 시 데이터 유효성 경고 활성화. 프로덕션에서는 false로 설정

TIP

⚠️ 표시된 prop은 deprecated이며, 권장 이름으로 대체 예정입니다. 두 이름 모두 동작하며, 둘 중 하나라도 true이면 기능이 활성화됩니다.

deprecated prop 대체 목록

기존 이름	권장 이름
showColumnSettings	useColumnSettings
showExcelExport	useExcelExport
serverSide	useServerSide

자세한 내용은 마이그레이션 가이드를 참고하세요.