# 기능별 매뉴얼

사용 목적과 구성 순서부터 조합 사례까지 기능을 하나씩 읽어보세요.

Canonical: https://grid.syidax.com/ko/docs/features/

<a id="columns"></a>

## 열 구성과 값

- [열 크기와 고정](https://grid.syidax.com/ko/docs/features/column-operations.md) — 너비·순서·고정·숨김은 서로 독립적인 열 상태입니다. 주문 번호는 고정하고 보조 정보는 숨기며 긴 제품명만 넓히는 식으로 조합할 수 있습니다.
- [다단 헤더](https://grid.syidax.com/ko/docs/features/column-groups.md) — 다단 헤더는 관련 열을 하나의 상위 제목 아래 배치합니다. 행을 묶는 그룹화와 달리 데이터 개수나 집계값은 바뀌지 않습니다.
- [실시간 열 API](https://grid.syidax.com/ko/docs/features/column-api.md) — 실시간 열 객체는 현재 Grid와 연결된 참조입니다. 저장 가능한 열 상태 배열과 목적이 다릅니다. 특정 열을 조작하는 앱 UI에는 참조가 유용하고 사용자 설정 저장에는 상태 배열이 적합합니다.
- [계산과 표시 분리](https://grid.syidax.com/ko/docs/features/value-getter-formatter.md) — valueGetter는 실제 계산값을 만들고 valueFormatter는 화면에 읽기 좋은 문자열을 만듭니다. 합계·정렬·비교에 숫자가 필요하면 getter는 숫자를 반환해야 합니다.

<a id="rows"></a>

## 행과 데이터 모델

- [데이터 갱신](https://grid.syidax.com/ko/docs/features/data-updates.md) — 조회 결과 전체를 새로 받았다면 rowData를 교체합니다. 일부 주문만 바뀌었다면 applyTransaction에 add·update·remove를 전달합니다. 갱신은 화면 위치가 아니라 getRowId로 연결됩니다.
- [필요한 블록만 요청](https://grid.syidax.com/ko/docs/features/infinite-row-model.md) — 한 번에 모든 주문을 내려받기 어려울 때 스크롤에 필요한 구간만 요청합니다. datasource는 시작·끝 행과 검색 조건을 받아 데이터를 공급하는 연결 객체입니다.
- [서버에서 정렬과 검색](https://grid.syidax.com/ko/docs/features/server-query.md) — 서버 조회는 행 범위·정렬·필터를 하나의 조건으로 서버에 전달하는 방식입니다. 단순 목록 조회에는 Infinite 모델과 함께 사용하고 서버 그룹·피벗은 Server-Side 모델을 검토합니다.
- [서버 측 행 모델](https://grid.syidax.com/ko/docs/features/server-side-row-model.md) — 서버가 그룹·피벗을 계산하고 펼친 그룹 경로별로 행을 공급하는 모델입니다. 이미 받은 로컬 행을 groupBy로 묶는 방식과 데이터 책임이 다릅니다.
- [보이는 구간을 스트리밍](https://grid.syidax.com/ko/docs/features/viewport-row-model.md) — 전체 데이터 개수는 알지만 현재 보이는 행만 지속 갱신하려는 시세·모니터링 화면에 적합합니다. 스크롤 범위에 맞춰 구독 범위를 바꾸는 것이 핵심입니다.
- [행 높이와 고정 행](https://grid.syidax.com/ko/docs/features/row-layout.md) — 행 높이, 상하 고정 행, 전체 너비 행, 병합 셀은 서로 다른 레이아웃 기능입니다. 요약값을 항상 보여 주는 목적과 상세 내용을 넓게 보여 주는 목적을 구분해서 선택합니다.
- [행 드래그](https://grid.syidax.com/ko/docs/features/row-drag.md) — 관리형 행 드래그는 사용자가 정한 순서를 Grid 데이터 순서에 반영합니다. 정렬 조건으로 정해진 표시 순서와 임의 순서 재배치는 충돌할 수 있습니다.
- [페이지 단위 탐색](https://grid.syidax.com/ko/docs/features/pagination.md) — 페이지 나누기는 한 번에 표시하는 행 수와 이동 위치를 제어합니다. 전체 데이터 양과 한 페이지의 크기는 별도 설정입니다.
- [행 번호와 데이터 ID](https://grid.syidax.com/ko/docs/features/row-numbers.md) — 행 번호는 화면에서 순서를 읽는 보조 정보이고 주문 ID는 업무 데이터를 식별하는 값입니다. 정렬 후에도 같은 숫자를 유지할지 현재 표시 순서를 다시 매길지 먼저 정해야 합니다.

<a id="sort-filter"></a>

## 정렬과 검색

- [단일·다중 정렬](https://grid.syidax.com/ko/docs/features/sorting.md) — 정렬은 데이터 값을 수정하지 않고 표시 순서를 바꿉니다. 단일 정렬은 한 기준만, 다중 정렬은 우선순위가 있는 여러 기준을 사용합니다.
- [열마다 다른 조건](https://grid.syidax.com/ko/docs/features/column-filters.md) — 열 필터는 특정 열에 조건을 적용합니다. 텍스트·숫자·날짜별로 입력과 비교 방식이 다르며 여러 열의 조건은 함께 결과를 좁힙니다.
- [모든 열에서 빠르게 찾기](https://grid.syidax.com/ko/docs/features/quick-filter.md) — 빠른 검색은 열을 지정하지 않고 여러 열의 표시 대상에서 문자열을 찾습니다. 사용자가 제품명인지 지역인지 모를 때 진입점으로 적합합니다.
- [업무 조건으로 필터링](https://grid.syidax.com/ko/docs/features/external-filter.md) — Grid 밖의 업무 조건을 행 판정 함수로 연결합니다. 미완료만 보기, 내 담당 건만 보기처럼 외부 UI에 있는 선택이 표의 결과를 제어할 때 사용합니다.
- [목록에서 값 선택](https://grid.syidax.com/ko/docs/features/set-filter.md) — 지역·상태처럼 반복되는 고유 값에서 포함할 항목을 고르게 하는 필터입니다. 이름 일부를 입력하는 Text filter보다 가능한 선택지를 한눈에 보여 주기 좋습니다.
- [여러 필터 조합](https://grid.syidax.com/ko/docs/features/multi-filter.md) — 한 열 안에 텍스트 검색과 값 목록 같은 여러 필터를 함께 구성합니다. 서로 다른 열에 각각 필터를 켜는 방식과 다릅니다.
- [조건 트리](https://grid.syidax.com/ko/docs/features/advanced-filter.md) — 여러 열의 조건을 AND·OR 트리로 조합합니다. 예를 들어 APAC의 대량 주문 또는 특정 제품 주문처럼 업무 규칙을 표현할 수 있습니다.
- [셀 내용 찾기](https://grid.syidax.com/ko/docs/features/find.md) — Find는 목록을 줄이지 않고 일치하는 셀을 강조하며 다음·이전 결과로 이동합니다. 검색 결과 주변의 다른 행을 계속 읽어야 하는 업무에 적합합니다.

<a id="selection"></a>

## 선택과 클립보드

- [행 단위 선택](https://grid.syidax.com/ko/docs/features/row-selection.md) — 행 선택은 승인·내보내기·배정 같은 일괄 작업의 대상을 고릅니다. 셀 범위 선택과 달리 한 주문 전체를 선택합니다.
- [셀 범위 선택](https://grid.syidax.com/ko/docs/features/range-selection.md) — 셀 범위는 여러 행·열에 걸친 직사각형입니다. 복사·붙여넣기·채우기·차트 생성이 사용할 범위를 정하며, 선택 자체는 값을 수정하지 않습니다.
- [값 채우기](https://grid.syidax.com/ko/docs/features/fill-handle.md) — 채우기 핸들은 기준 범위의 값을 복사하거나 규칙을 확장합니다. 손잡이를 드래그하는 UI와 fillRange API는 편집 가능 여부·검증·이력을 함께 고려합니다.
- [셀 복사](https://grid.syidax.com/ko/docs/features/single-cell-copy.md) — 셀 하나의 표시 텍스트를 시스템 클립보드로 복사합니다. 셀 안 편집기의 텍스트를 선택한 상태와 Grid 셀에 포커스가 있는 상태는 서로 다른 복사 대상입니다.
- [행 복사](https://grid.syidax.com/ko/docs/features/row-copy.md) — 한 행의 표시 열을 탭으로 구분해 복사합니다. 스프레드시트에 붙여 넣으면 각 열이 셀로 나뉘므로 한 주문의 여러 값을 옮길 때 유용합니다.
- [범위 복사와 붙여넣기](https://grid.syidax.com/ko/docs/features/range-clipboard.md) — 직사각형 범위의 값을 복사하고 같은 행·열 배치로 붙여넣습니다. 시작 셀을 기준으로 대상이 결정되며 편집 불가·권한·검증 규칙을 함께 적용합니다.

<a id="editing"></a>

## 편집과 검증

- [셀과 행 편집](https://grid.syidax.com/ko/docs/features/cell-editing.md) — 셀 편집은 하나의 값을 즉시 수정하고 전체 행 편집은 여러 필드를 하나의 행 작업으로 확정합니다. editor는 입력 UI를, editable은 쓰기 가능 여부를 지정합니다.
- [일괄 편집](https://grid.syidax.com/ko/docs/features/batch-editing.md) — 배치 편집은 여러 셀의 수정 사항을 임시로 모았다가 한 번에 확정하거나 취소합니다. 임시 값과 확정된 rowData를 구분해야 저장 버튼의 동작이 명확해집니다.
- [검색 가능한 선택 편집기](https://grid.syidax.com/ko/docs/features/rich-select.md) — 후보가 많은 열에서 검색으로 목록을 좁혀 선택하는 Pro 편집기입니다. 기본 Select는 짧은 고정 목록에 적합하고 Rich Select는 많은 후보에서 빠르게 찾을 때 유용합니다.
- [편집 이력](https://grid.syidax.com/ko/docs/features/undo-redo.md) — 기록된 편집 트랜잭션을 되돌리거나 다시 적용합니다. 한 작업에 여러 셀 변경이 포함될 수 있으므로 셀 수와 이력 수를 같다고 가정하지 마세요.
- [데이터 검증](https://grid.syidax.com/ko/docs/features/validation-rules.md) — 선언형 규칙으로 필수값·숫자 범위·문자열 형식·사용자 규칙을 검사합니다. 기본 모드는 잘못된 값을 표시하는 방식일 수 있으므로 저장을 막아야 한다면 invalidEditMode를 명시합니다.
- [셀 메모](https://grid.syidax.com/ko/docs/features/cell-notes.md) — 셀 메모는 값 자체를 바꾸지 않고 검토 이유나 추가 설명을 남깁니다. 독립 셀 메모와 협업 세션의 댓글 스레드는 저장 방식과 API가 다르므로 먼저 원하는 방식을 선택합니다.

<a id="analysis"></a>

## 그룹·분석·수식

- [그룹과 집계](https://grid.syidax.com/ko/docs/features/row-grouping.md) — 행 그룹은 같은 지역이나 팀에 속한 원본 행을 접고 펼칠 수 있게 묶습니다. 열 그룹이 머리글을 묶는 것과 달리, 행 그룹은 표시 행과 집계 결과를 바꿉니다.
- [피벗 분석](https://grid.syidax.com/ko/docs/features/pivot.md) — 피벗은 원본 주문을 행 축·열 축·값 축으로 나누어 교차 집계표를 만듭니다. 지역별 주문 행을 접는 그룹과 달리, 고유한 상태 값 등이 새로운 결과 열로 생깁니다.
- [트리 데이터](https://grid.syidax.com/ko/docs/features/tree-data.md) — 트리는 폴더·조직도처럼 부모와 자식 관계가 있는 데이터를 들여쓰기와 펼침 버튼으로 보여 줍니다. 동일한 값끼리 묶는 행 그룹과 달리 부모 관계가 데이터에 이미 존재합니다.
- [행 상세](https://grid.syidax.com/ko/docs/features/master-detail.md) — 마스터·상세는 주문 목록에서 한 주문의 품목이나 배송 이력을 펼쳐 보는 구성입니다. 상위 행은 요약이고 그 아래 전체 폭의 패널이 상세 내용을 담습니다.
- [수식 계산](https://grid.syidax.com/ko/docs/features/formulas.md) — 수식은 =로 시작하는 문자열을 계산해 셀에 결과를 표시합니다. 예를 들어 =SUM(A1:A3)은 원본 열 정의의 첫 번째 열과 원본 데이터의 첫 세 행을 참조합니다.
- [선택 데이터를 차트로](https://grid.syidax.com/ko/docs/features/integrated-charts.md) — Grid의 범위를 차트로 연결하면 같은 데이터로 표와 그래프를 함께 읽을 수 있습니다. 숫자 값만 고르면 되는 것이 아니라 범주 열과 값 열을 차트 종류에 맞게 선택해야 합니다.

<a id="appearance"></a>

## 표현과 화면 상태

- [셀 표현 바꾸기](https://grid.syidax.com/ko/docs/features/custom-cells.md) — 셀 렌더러는 데이터의 표시 방법을 바꿉니다. 상태 배지·링크·액션 버튼이 필요한 경우 사용하되 정렬·필터에 사용할 원본 값은 별도로 유지합니다.
- [셀 툴팁](https://grid.syidax.com/ko/docs/features/tooltip.md) — 툴팁은 잘린 이름이나 긴 설명을 잠시 확인하는 보조 수단입니다. 사용자가 반드시 알아야 하는 오류나 중요한 안내는 툴팁 안에만 숨기지 않습니다.
- [조건부 서식](https://grid.syidax.com/ko/docs/features/conditional-formats.md) — 조건부 서식은 값의 의미에 따라 배경·글자 등 표시를 바꿉니다. 재고 부족이나 목표 초과를 빠르게 찾는 데 쓰며 원본 값이나 검증 결과를 바꾸지는 않습니다.
- [변경 강조](https://grid.syidax.com/ko/docs/features/cell-change-flash.md) — 값 변경 강조는 편집·붙여넣기·데이터 트랜잭션으로 바뀐 셀을 잠깐 표시합니다. 실시간 가격이나 수량이 많은 표에서 방금 달라진 위치를 찾는 데 유용합니다.
- [행 따라가기](https://grid.syidax.com/ko/docs/features/row-hover.md) — 행 hover는 포인터가 있는 행을 구분해 가로로 긴 표를 읽기 쉽게 합니다. 선택한 행과는 다른 상태이며 업무 처리 대상이 자동으로 선택되는 것은 아닙니다.
- [로딩과 빈 결과](https://grid.syidax.com/ko/docs/features/overlays.md) — 로딩과 빈 데이터 안내는 표가 아무것도 보여 주지 않는 이유를 설명합니다. 요청 중·조회 결과 없음·실패는 서로 다른 상태이므로 같은 빈 화면으로 처리하지 않습니다.

<a id="panels"></a>

## 메뉴와 도구 패널

- [셀 컨텍스트 메뉴](https://grid.syidax.com/ko/docs/features/context-menu.md) — 셀의 우클릭 메뉴는 현재 위치를 대상으로 복사·행 복사·내보내기 같은 작업을 제공합니다. 반복 사용 기능은 툴바나 키보드 접근도 함께 제공하는 것이 좋습니다.
- [열 메뉴](https://grid.syidax.com/ko/docs/features/column-menu.md) — 열 메뉴는 현재 열에 대한 정렬·필터·표시 설정을 가까운 위치에서 제공합니다. 행의 업무 작업은 셀 컨텍스트 메뉴, 전체 열 목록 관리는 도구 패널과 구분합니다.
- [도구 패널](https://grid.syidax.com/ko/docs/features/tool-panels.md) — 도구 패널은 열 표시나 필터 설정처럼 여러 열에 걸친 작업을 한 곳에 모읍니다. 표 안의 데이터 공간과 설정 공간을 나누고 필요할 때만 여는 방식입니다.
- [상태와 집계](https://grid.syidax.com/ko/docs/features/status-bar.md) — 상태 바는 현재 표의 행 수나 범위 계산 결과처럼 작업 결과를 짧게 보여 주는 영역입니다. 데이터를 편집하는 도구가 아니라 사용자가 보고 있는 범위를 이해하도록 돕습니다.

<a id="import-export"></a>

## 파일 가져오기·내보내기

- [CSV 가져오기](https://grid.syidax.com/ko/docs/features/csv-import.md) — CSV 가져오기는 구분자로 나뉜 텍스트를 새 열과 행으로 바꿉니다. 기존 표에 일부 행을 추가하는 트랜잭션과 달리 importCsvText는 columnDefs와 rowData를 교체합니다.
- [Excel 가져오기](https://grid.syidax.com/ko/docs/features/xlsx-import.md) — XLSX 가져오기는 파일을 워크북으로 읽고 선택한 시트를 Grid용 열·행 스냅샷으로 변환합니다. 워크북 전체 파싱 결과와 화면용 스냅샷은 다른 데이터입니다.
- [CSV 내보내기](https://grid.syidax.com/ko/docs/features/csv-export.md) — CSV 내보내기는 표 데이터를 다른 도구로 넘기기 쉬운 텍스트 파일로 만듭니다. 셀 색·열 너비·상세 패널 같은 화면 모양을 보존하는 형식은 아닙니다.
- [Excel 내보내기](https://grid.syidax.com/ko/docs/features/excel-export.md) — Excel 내보내기는 XLSX 바이트를 생성하거나 파일로 내려받습니다. CSV보다 시트 이름과 워크북 형식이 필요한 교환 작업에 적합하며 Pro 기능입니다.
- [PDF 내보내기](https://grid.syidax.com/ko/docs/features/pdf-export.md) — PDF 내보내기는 표를 공유 가능한 문서 형태로 고정합니다. 다른 앱에서 다시 계산하는 것이 목적이면 CSV·XLSX, 읽기와 배포가 목적이면 PDF를 선택합니다.

<a id="application"></a>

## 앱 연결과 성능

- [실시간 협업](https://grid.syidax.com/ko/docs/features/collaboration.md) — 협업은 같은 방에 참여한 사용자 사이에서 편집·커서·참여 상태를 공유합니다. 방 이름만 지정했다고 다른 기기의 데이터가 인터넷을 통해 자동 연결되는 것은 아닙니다.
- [변경 이력 조회](https://grid.syidax.com/ko/docs/features/audit-log.md) — 감사 로그는 행·셀·선택 변경과 실행 취소·다시 실행 전이를 추적합니다. 현재 표의 값만으로 알 수 없는 변경 흐름을 확인하는 데 사용합니다.
- [셀 접근 제어](https://grid.syidax.com/ko/docs/features/rbac.md) — 셀 읽기와 편집 정책은 사용자 역할에 따라 보이는 값과 수정 가능한 값을 제한합니다. 열을 숨기는 UI 설정과 데이터 접근 정책은 다릅니다.
- [데이터 스냅샷](https://grid.syidax.com/ko/docs/features/snapshots.md) — 스냅샷은 특정 시점의 rowData를 보관하고 현재 데이터 또는 다른 스냅샷과 비교합니다. 열 너비·필터·포커스를 저장하는 화면 상태 API와는 목적이 다릅니다.
- [대량 데이터](https://grid.syidax.com/ko/docs/features/virtualization.md) — 가상화는 전체 데이터 중 화면 주변에 필요한 행·열 DOM만 렌더링합니다. 데이터 자체를 서버에서 일부만 가져오는 행 모델과는 다른 성능 기능입니다.
- [처리 엔진 선택](https://grid.syidax.com/ko/docs/features/wasm-acceleration.md) — Pro 처리 엔진은 지원하는 정렬·필터·집계 작업에 가속 경로를 사용합니다. 브라우저·패키지·라이선스·현재 기능 조합에 따라 실제 실행 경로가 결정됩니다.
- [JavaScript 처리 엔진](https://grid.syidax.com/ko/docs/features/js-processing.md) — JavaScript 처리 엔진은 브라우저에서 표 데이터를 정렬·필터·가공하는 표준 실행 경로입니다. 배포 환경과 기능 조합을 단순하게 확인하는 출발점으로 사용할 수 있습니다.
- [기본 로고의 표시](https://grid.syidax.com/ko/docs/features/fixed-logo.md) — 기본 로고는 Community를 포함해 Grid 하단의 전용 공간에 표시됩니다. 데이터를 가리키는 워터마크가 아니라 표의 구성 요소로 공간을 확보합니다.