기능별 매뉴얼

너비·순서·고정·숨김은 서로 독립적인 열 상태입니다. 주문 번호는 고정하고 보조 정보는 숨기며 긴 제품명만 넓히는 식으로 조합할 수 있습니다.

다단 헤더는 관련 열을 하나의 상위 제목 아래 배치합니다. 행을 묶는 그룹화와 달리 데이터 개수나 집계값은 바뀌지 않습니다.

실시간 열 객체는 현재 Grid와 연결된 참조입니다. 저장 가능한 열 상태 배열과 목적이 다릅니다. 특정 열을 조작하는 앱 UI에는 참조가 유용하고 사용자 설정 저장에는 상태 배열이 적합합니다.

valueGetter는 실제 계산값을 만들고 valueFormatter는 화면에 읽기 좋은 문자열을 만듭니다. 합계·정렬·비교에 숫자가 필요하면 getter는 숫자를 반환해야 합니다.

조회 결과 전체를 새로 받았다면 rowData를 교체합니다. 일부 주문만 바뀌었다면 applyTransaction에 add·update·remove를 전달합니다. 갱신은 화면 위치가 아니라 getRowId로 연결됩니다.

한 번에 모든 주문을 내려받기 어려울 때 스크롤에 필요한 구간만 요청합니다. datasource는 시작·끝 행과 검색 조건을 받아 데이터를 공급하는 연결 객체입니다.

서버 조회는 행 범위·정렬·필터를 하나의 조건으로 서버에 전달하는 방식입니다. 단순 목록 조회에는 Infinite 모델과 함께 사용하고 서버 그룹·피벗은 Server-Side 모델을 검토합니다.

서버가 그룹·피벗을 계산하고 펼친 그룹 경로별로 행을 공급하는 모델입니다. 이미 받은 로컬 행을 groupBy로 묶는 방식과 데이터 책임이 다릅니다.

전체 데이터 개수는 알지만 현재 보이는 행만 지속 갱신하려는 시세·모니터링 화면에 적합합니다. 스크롤 범위에 맞춰 구독 범위를 바꾸는 것이 핵심입니다.

행 높이, 상하 고정 행, 전체 너비 행, 병합 셀은 서로 다른 레이아웃 기능입니다. 요약값을 항상 보여 주는 목적과 상세 내용을 넓게 보여 주는 목적을 구분해서 선택합니다.

관리형 행 드래그는 사용자가 정한 순서를 Grid 데이터 순서에 반영합니다. 정렬 조건으로 정해진 표시 순서와 임의 순서 재배치는 충돌할 수 있습니다.

페이지 나누기는 한 번에 표시하는 행 수와 이동 위치를 제어합니다. 전체 데이터 양과 한 페이지의 크기는 별도 설정입니다.

행 번호는 화면에서 순서를 읽는 보조 정보이고 주문 ID는 업무 데이터를 식별하는 값입니다. 정렬 후에도 같은 숫자를 유지할지 현재 표시 순서를 다시 매길지 먼저 정해야 합니다.

정렬은 데이터 값을 수정하지 않고 표시 순서를 바꿉니다. 단일 정렬은 한 기준만, 다중 정렬은 우선순위가 있는 여러 기준을 사용합니다.

열 필터는 특정 열에 조건을 적용합니다. 텍스트·숫자·날짜별로 입력과 비교 방식이 다르며 여러 열의 조건은 함께 결과를 좁힙니다.

빠른 검색은 열을 지정하지 않고 여러 열의 표시 대상에서 문자열을 찾습니다. 사용자가 제품명인지 지역인지 모를 때 진입점으로 적합합니다.

Grid 밖의 업무 조건을 행 판정 함수로 연결합니다. 미완료만 보기, 내 담당 건만 보기처럼 외부 UI에 있는 선택이 표의 결과를 제어할 때 사용합니다.

지역·상태처럼 반복되는 고유 값에서 포함할 항목을 고르게 하는 필터입니다. 이름 일부를 입력하는 Text filter보다 가능한 선택지를 한눈에 보여 주기 좋습니다.

한 열 안에 텍스트 검색과 값 목록 같은 여러 필터를 함께 구성합니다. 서로 다른 열에 각각 필터를 켜는 방식과 다릅니다.

여러 열의 조건을 AND·OR 트리로 조합합니다. 예를 들어 APAC의 대량 주문 또는 특정 제품 주문처럼 업무 규칙을 표현할 수 있습니다.

Find는 목록을 줄이지 않고 일치하는 셀을 강조하며 다음·이전 결과로 이동합니다. 검색 결과 주변의 다른 행을 계속 읽어야 하는 업무에 적합합니다.

행 선택은 승인·내보내기·배정 같은 일괄 작업의 대상을 고릅니다. 셀 범위 선택과 달리 한 주문 전체를 선택합니다.

셀 범위는 여러 행·열에 걸친 직사각형입니다. 복사·붙여넣기·채우기·차트 생성이 사용할 범위를 정하며, 선택 자체는 값을 수정하지 않습니다.

채우기 핸들은 기준 범위의 값을 복사하거나 규칙을 확장합니다. 손잡이를 드래그하는 UI와 fillRange API는 편집 가능 여부·검증·이력을 함께 고려합니다.

셀 하나의 표시 텍스트를 시스템 클립보드로 복사합니다. 셀 안 편집기의 텍스트를 선택한 상태와 Grid 셀에 포커스가 있는 상태는 서로 다른 복사 대상입니다.

한 행의 표시 열을 탭으로 구분해 복사합니다. 스프레드시트에 붙여 넣으면 각 열이 셀로 나뉘므로 한 주문의 여러 값을 옮길 때 유용합니다.

직사각형 범위의 값을 복사하고 같은 행·열 배치로 붙여넣습니다. 시작 셀을 기준으로 대상이 결정되며 편집 불가·권한·검증 규칙을 함께 적용합니다.

셀 편집은 하나의 값을 즉시 수정하고 전체 행 편집은 여러 필드를 하나의 행 작업으로 확정합니다. editor는 입력 UI를, editable은 쓰기 가능 여부를 지정합니다.

배치 편집은 여러 셀의 수정 사항을 임시로 모았다가 한 번에 확정하거나 취소합니다. 임시 값과 확정된 rowData를 구분해야 저장 버튼의 동작이 명확해집니다.

후보가 많은 열에서 검색으로 목록을 좁혀 선택하는 Pro 편집기입니다. 기본 Select는 짧은 고정 목록에 적합하고 Rich Select는 많은 후보에서 빠르게 찾을 때 유용합니다.

기록된 편집 트랜잭션을 되돌리거나 다시 적용합니다. 한 작업에 여러 셀 변경이 포함될 수 있으므로 셀 수와 이력 수를 같다고 가정하지 마세요.

선언형 규칙으로 필수값·숫자 범위·문자열 형식·사용자 규칙을 검사합니다. 기본 모드는 잘못된 값을 표시하는 방식일 수 있으므로 저장을 막아야 한다면 invalidEditMode를 명시합니다.

셀 메모는 값 자체를 바꾸지 않고 검토 이유나 추가 설명을 남깁니다. 독립 셀 메모와 협업 세션의 댓글 스레드는 저장 방식과 API가 다르므로 먼저 원하는 방식을 선택합니다.

행 그룹은 같은 지역이나 팀에 속한 원본 행을 접고 펼칠 수 있게 묶습니다. 열 그룹이 머리글을 묶는 것과 달리, 행 그룹은 표시 행과 집계 결과를 바꿉니다.

피벗은 원본 주문을 행 축·열 축·값 축으로 나누어 교차 집계표를 만듭니다. 지역별 주문 행을 접는 그룹과 달리, 고유한 상태 값 등이 새로운 결과 열로 생깁니다.

트리는 폴더·조직도처럼 부모와 자식 관계가 있는 데이터를 들여쓰기와 펼침 버튼으로 보여 줍니다. 동일한 값끼리 묶는 행 그룹과 달리 부모 관계가 데이터에 이미 존재합니다.

마스터·상세는 주문 목록에서 한 주문의 품목이나 배송 이력을 펼쳐 보는 구성입니다. 상위 행은 요약이고 그 아래 전체 폭의 패널이 상세 내용을 담습니다.

수식은 =로 시작하는 문자열을 계산해 셀에 결과를 표시합니다. 예를 들어 =SUM(A1:A3)은 원본 열 정의의 첫 번째 열과 원본 데이터의 첫 세 행을 참조합니다.

Grid의 범위를 차트로 연결하면 같은 데이터로 표와 그래프를 함께 읽을 수 있습니다. 숫자 값만 고르면 되는 것이 아니라 범주 열과 값 열을 차트 종류에 맞게 선택해야 합니다.

셀 렌더러는 데이터의 표시 방법을 바꿉니다. 상태 배지·링크·액션 버튼이 필요한 경우 사용하되 정렬·필터에 사용할 원본 값은 별도로 유지합니다.

툴팁은 잘린 이름이나 긴 설명을 잠시 확인하는 보조 수단입니다. 사용자가 반드시 알아야 하는 오류나 중요한 안내는 툴팁 안에만 숨기지 않습니다.

조건부 서식은 값의 의미에 따라 배경·글자 등 표시를 바꿉니다. 재고 부족이나 목표 초과를 빠르게 찾는 데 쓰며 원본 값이나 검증 결과를 바꾸지는 않습니다.

값 변경 강조는 편집·붙여넣기·데이터 트랜잭션으로 바뀐 셀을 잠깐 표시합니다. 실시간 가격이나 수량이 많은 표에서 방금 달라진 위치를 찾는 데 유용합니다.

행 hover는 포인터가 있는 행을 구분해 가로로 긴 표를 읽기 쉽게 합니다. 선택한 행과는 다른 상태이며 업무 처리 대상이 자동으로 선택되는 것은 아닙니다.

로딩과 빈 데이터 안내는 표가 아무것도 보여 주지 않는 이유를 설명합니다. 요청 중·조회 결과 없음·실패는 서로 다른 상태이므로 같은 빈 화면으로 처리하지 않습니다.

셀의 우클릭 메뉴는 현재 위치를 대상으로 복사·행 복사·내보내기 같은 작업을 제공합니다. 반복 사용 기능은 툴바나 키보드 접근도 함께 제공하는 것이 좋습니다.

열 메뉴는 현재 열에 대한 정렬·필터·표시 설정을 가까운 위치에서 제공합니다. 행의 업무 작업은 셀 컨텍스트 메뉴, 전체 열 목록 관리는 도구 패널과 구분합니다.

도구 패널은 열 표시나 필터 설정처럼 여러 열에 걸친 작업을 한 곳에 모읍니다. 표 안의 데이터 공간과 설정 공간을 나누고 필요할 때만 여는 방식입니다.

상태 바는 현재 표의 행 수나 범위 계산 결과처럼 작업 결과를 짧게 보여 주는 영역입니다. 데이터를 편집하는 도구가 아니라 사용자가 보고 있는 범위를 이해하도록 돕습니다.

CSV 가져오기는 구분자로 나뉜 텍스트를 새 열과 행으로 바꿉니다. 기존 표에 일부 행을 추가하는 트랜잭션과 달리 importCsvText는 columnDefs와 rowData를 교체합니다.

XLSX 가져오기는 파일을 워크북으로 읽고 선택한 시트를 Grid용 열·행 스냅샷으로 변환합니다. 워크북 전체 파싱 결과와 화면용 스냅샷은 다른 데이터입니다.

CSV 내보내기는 표 데이터를 다른 도구로 넘기기 쉬운 텍스트 파일로 만듭니다. 셀 색·열 너비·상세 패널 같은 화면 모양을 보존하는 형식은 아닙니다.

Excel 내보내기는 XLSX 바이트를 생성하거나 파일로 내려받습니다. CSV보다 시트 이름과 워크북 형식이 필요한 교환 작업에 적합하며 Pro 기능입니다.

PDF 내보내기는 표를 공유 가능한 문서 형태로 고정합니다. 다른 앱에서 다시 계산하는 것이 목적이면 CSV·XLSX, 읽기와 배포가 목적이면 PDF를 선택합니다.

협업은 같은 방에 참여한 사용자 사이에서 편집·커서·참여 상태를 공유합니다. 방 이름만 지정했다고 다른 기기의 데이터가 인터넷을 통해 자동 연결되는 것은 아닙니다.

감사 로그는 행·셀·선택 변경과 실행 취소·다시 실행 전이를 추적합니다. 현재 표의 값만으로 알 수 없는 변경 흐름을 확인하는 데 사용합니다.

셀 읽기와 편집 정책은 사용자 역할에 따라 보이는 값과 수정 가능한 값을 제한합니다. 열을 숨기는 UI 설정과 데이터 접근 정책은 다릅니다.

스냅샷은 특정 시점의 rowData를 보관하고 현재 데이터 또는 다른 스냅샷과 비교합니다. 열 너비·필터·포커스를 저장하는 화면 상태 API와는 목적이 다릅니다.

가상화는 전체 데이터 중 화면 주변에 필요한 행·열 DOM만 렌더링합니다. 데이터 자체를 서버에서 일부만 가져오는 행 모델과는 다른 성능 기능입니다.

Pro 처리 엔진은 지원하는 정렬·필터·집계 작업에 가속 경로를 사용합니다. 브라우저·패키지·라이선스·현재 기능 조합에 따라 실제 실행 경로가 결정됩니다.

JavaScript 처리 엔진은 브라우저에서 표 데이터를 정렬·필터·가공하는 표준 실행 경로입니다. 배포 환경과 기능 조합을 단순하게 확인하는 출발점으로 사용할 수 있습니다.

기본 로고는 Community를 포함해 Grid 하단의 전용 공간에 표시됩니다. 데이터를 가리키는 워터마크가 아니라 표의 구성 요소로 공간을 확보합니다.