선택 & 클립보드

라이브 데모

셀 선택

마우스 선택

동작	결과
셀 클릭	단일 셀 선택
셀에서 드래그	범위 선택 (파란 하이라이트)
더블 클릭	해당 셀 편집 모드 진입

키보드 단축키

키	동작
↑ ↓ ← →	선택 셀 이동
Shift + 방향키	범위 선택 확장
Enter	편집 모드 진입
Esc	편집 취소 / 선택 해제
Backspace / Delete	선택 셀 값 삭제
알파벳/숫자 키	즉시 편집 시작
Ctrl+C / Cmd+C	선택 범위 복사 (TSV 형식)
Ctrl+V / Cmd+V	클립보드 내용 붙여넣기
Shift + 헤더 클릭	다중 정렬 컬럼 추가

TIP

그리드가 포커스를 받아야 키보드 단축키가 동작합니다. 셀 클릭 후 사용하세요.

Excel 복사/붙여넣기

Grid → Excel:

1. 마우스로 셀 범위 드래그
2. Ctrl+C
3. Excel에 붙여넣기

Excel → Grid:

1. Excel에서 셀 범위 복사
2. 그리드에서 시작 셀 클릭
3. Ctrl+V

• 내부적으로 TSV(Tab-Separated Values) 형식 사용
• 붙여넣기 시 시작 셀 위치부터 오른쪽/아래로 순서대로 입력
• 그리드 범위를 벗어나는 데이터는 무시
• 편집 불가 컬럼(badge, progress, image, button, link, tag, sparkline)에는 붙여넣기가 자동으로 차단됨

편집 모드에서의 붙여넣기

셀을 더블 클릭하거나 Enter로 편집 모드 진입 후 Ctrl+V를 누르면 input 안에 텍스트가 직접 붙여넣어집니다. 그리드 선택 모드(Ctrl+V)와 편집 모드(Ctrl+V) 붙여넣기는 자동으로 구분됩니다.

체크박스

useCheckbox prop을 true로 설정하면 첫 번째 컬럼에 체크박스가 추가됩니다.

<WZGrid
  :useCheckbox="true"
  @update:checked="checkedRows = $event"
/>

요소	동작
헤더 체크박스	전체 선택 / 해제 토글
헤더 (일부 선택 시)	indeterminate(—) 상태 표시
행 체크박스	해당 행 선택 / 해제

• 체크 기준은 전체 rows (페이지 관계없이 유지)
• rows prop이 교체되면 체크 상태 자동 초기화