이벤트

전체 목록

• queryComplete

  처리 엔진의 조회가 완료되었을 때 발생합니다. 결과와 실제 실행 tier를 detail에서 읽어 성능·결과 안내에 연결합니다.

• sortChanged

  정렬 기준이 바뀌었을 때 발생합니다. 현재 정렬 모델을 앱의 검색 조건이나 화면 저장에 반영합니다.

• filterChanged

  적용된 필터가 바뀌었을 때 발생합니다. 입력 중 변경인 filterModified와 구분합니다.

• filterModified

  필터 입력이 수정되었을 때 발생합니다. 적용 버튼이 있는 필터에서는 아직 결과 행에 반영되기 전일 수 있습니다.

• conditionFilterChanged

  AND·OR 조건 트리가 바뀌었을 때 발생합니다. model이 null이면 고급 조건이 해제된 상태입니다.

• conditionPresetsChanged

  고급 조건 프리셋 목록이 바뀌었을 때 발생합니다. presets를 사용자 설정 저장에 연결합니다.

• columnGroupToggled

  열 그룹 머리글을 펼치거나 접었을 때 발생합니다. groupId와 open으로 현재 상태를 읽습니다.

• rowGroupToggled

  행 그룹을 펼치거나 접었을 때 발생합니다. 표시 라벨 대신 detail의 실제 key를 재사용합니다.

• treeNodeToggled

  트리 노드의 펼침 상태가 바뀌었을 때 발생합니다. 경로와 expanded를 확인합니다.

• detailRowToggled

  부모 행의 상세 패널 펼침 상태가 바뀌었을 때 발생합니다.

• detailRowCreated

  부모 행의 상세 패널이 생성되었을 때 발생합니다. 행 ID와 부모 데이터로 앱 자원을 연결할 수 있습니다.

• detailRowDestroyed

  상세 패널이 해제되었을 때 발생합니다. 앱에서 연결한 자원도 해당 rowId 기준으로 정리합니다.

• rangeSelectionChanged

  셀 선택 범위가 바뀌었을 때 발생합니다. 범위 경계 목록으로 복사·요약 기능을 연결합니다.

• toolPanelToggled

  열·필터 도구 패널의 열림 상태가 바뀌었을 때 발생합니다.

• csvImported

  CSV 가져오기를 마쳤을 때 발생합니다. 실제 적용된 행 수와 열 수를 사용자에게 안내합니다.

• clipboardCopied

  클립보드 복사가 완료되었을 때 발생합니다. 출력 텍스트와 범위를 확인할 수 있으므로 민감 정보 로그를 주의합니다.

• clipboardPasted

  붙여넣기 처리 결과를 알립니다. 적용 수·건너뛴 수·시작 위치·실제 변경 목록을 함께 확인합니다.

• paginationChanged

  페이지 또는 페이지 크기가 바뀌었을 때 발생합니다. 외부 페이지 안내와 동기화합니다.

• quickFilterChanged

  빠른 검색 조건이 바뀌었을 때 발생합니다. 앱 외부 검색 입력과 값을 동기화할 수 있습니다.

• emptyStateActionClicked

  빈 결과 안내 영역의 작업 버튼을 눌렀을 때 발생합니다. 작업 종류에 맞게 앱 흐름을 연결합니다.

• activeCellChanged

  키보드·포인터 조작으로 활성 셀이 바뀌었을 때 발생합니다. 선택 범위나 행 선택과 다른 상태입니다.

• cellClicked

  셀을 한 번 클릭했을 때 발생합니다. 실제 행·필드와 입력 문맥은 detail에서 읽습니다.

• cellDoubleClicked

  셀을 두 번 클릭했을 때 발생합니다. 편집 시작과 앱 상세 열기가 충돌하지 않도록 처리합니다.

• rowClicked

  행을 클릭했을 때 발생합니다. 클릭 자체와 선택 결과는 구분합니다.

• cellEditingRequested

  셀 편집을 요청했을 때 발생합니다. 이후 취소·확정·값 변경 이벤트와 흐름을 구분합니다.

• cellEditingCancelled

  셀 편집이 취소되었을 때 발생합니다. 서버 저장 성공으로 처리하지 마세요.

• cellEditingCommitted

  셀 편집이 확정되었을 때 발생합니다. 실제 값 변경은 cellValueChanged도 함께 확인합니다.

• formulaEvaluated

  수식 계산 결과가 나왔을 때 발생합니다. 원문 수식과 계산 결과를 구분해 읽습니다.

• formulaError

  수식을 계산하지 못했을 때 발생합니다. 대상과 오류 정보를 사용자 검토 화면에 연결합니다.

• workbookBindingChanged

  Grid의 워크북·시트 연결이 바뀌었을 때 발생합니다.

• workbookBindingError

  워크북 연결을 구성하지 못했을 때 발생합니다. 식별자와 연결 오류 정보를 확인합니다.

• chunkLoading

  기능 코드 조각의 로딩이 시작되었을 때 발생합니다. 행 데이터 조회 이벤트와 구분합니다.

• chunkLoaded

  기능 코드 조각을 불러왔을 때 발생합니다.

• chunkLoadFailed

  기능 코드 로딩이 실패했을 때 발생합니다. 오류와 대상 기능을 확인해 재시도·대체 안내에 연결합니다.

• componentError

  사용자 컴포넌트 초기화·호출 등에서 오류가 발생했을 때 알립니다. 오류를 무시하지 말고 대상과 단계별로 처리합니다.

• rowDataChanged

  원본 행 데이터가 바뀌었을 때 발생합니다. 화면 정렬 순서 변경과는 다릅니다.

• cellValueChanged

  셀의 실제 값이 바뀌었을 때 발생합니다. 행·필드·변경 전후 값으로 저장이나 활동 내역을 구성합니다.

• rowMoved

  행 순서가 이동되었을 때 발생합니다. 이동 전후 인덱스와 해당 행을 읽습니다.

• rowGroupChanged

  행 그룹 기준이 바뀌었을 때 발생합니다. 기준 필드와 그룹 해제 상태를 확인합니다.

• pivotPanelChanged

  피벗 패널에서 축 구성이 바뀌었을 때 발생합니다. 변경된 축과 현재 피벗 상태를 확인합니다.

• pivotChanged

  피벗 구성이 바뀌었음을 알립니다. 호환 이벤트와 패널 이벤트를 중복 구독해 같은 저장을 반복하지 마세요.

• pivotModeChanged

  피벗 모드의 켜짐·꺼짐이 바뀌었을 때 발생합니다.

• contextMenuItemClicked

  셀 우클릭 메뉴 항목을 실행했을 때 발생합니다. 항목 ID와 대상 셀 위치를 읽습니다.

• remoteEditApplied

  협업 상대의 편집이 적용되었을 때 발생합니다. 이를 다시 로컬 편집으로 전송해 순환하지 않도록 출처를 구분합니다.

• presenceChanged

  협업 참가자의 위치·참여 상태가 바뀌었을 때 발생합니다.

• collabConflictResolved

  동시 편집 충돌을 해결했을 때 발생합니다. 충돌의 실제 결과를 읽어 사용자에게 설명합니다.

• collaboratorJoined

  협업 방에 참가자가 들어왔을 때 발생합니다.

• collaboratorLeft

  협업 방에서 참가자가 나갔을 때 발생합니다. ID로 앱의 참가자 목록을 갱신합니다.

• syncStatusChanged

  협업 동기화 상태가 바뀌었을 때 발생합니다. 연결 상태와 서버 영구 저장 완료를 구분해 안내합니다.

• cellCommentsChanged

  셀의 협업 댓글 목록이 바뀌었을 때 발생합니다. 행 ID·필드·최신 댓글 목록을 읽습니다.

• commentMentioned

  협업 댓글에서 멘션이 발생했을 때 알립니다. 대상 셀과 댓글로 앱 알림을 연결합니다.

• auditLogChanged

  감사 기록이 추가되었을 때 발생합니다. entry를 읽어 앱의 보존 흐름에 연결할 수 있습니다.

• conditionalFormatsChanged

  조건부 서식 규칙 목록이 바뀌었을 때 발생합니다. rules를 사용자 설정으로 저장합니다.

• cellValidationFailed

  입력 검증이 실패했을 때 발생합니다. 대상 셀·입력값·메시지를 읽어 수정할 위치를 안내합니다.

• snapshotCaptured

  데이터 스냅샷이 만들어졌을 때 발생합니다. ID·이름·행 수로 저장 시점을 표시합니다.

• snapshotRestored

  데이터 스냅샷 복원이 완료되었을 때 발생합니다. 앱 서버 저장까지 완료된 의미는 아닙니다.

• xlsxImported

  XLSX 파싱 후 선택한 시트의 Grid용 snapshot을 전달합니다. 필요하면 snapshot.columnDefs와 snapshot.rowData를 앱에서 적용합니다.

• historyChanged

  실행 취소·다시 실행 이력이 바뀌었을 때 발생합니다. 버튼의 활성 여부와 현재 깊이를 갱신합니다.

• columnResized

  열 너비가 바뀌었을 때 발생합니다. 현재 너비를 화면 상태 저장에 반영합니다.

• columnReordered

  열 순서가 바뀌었을 때 발생합니다.

• columnVisibilityChanged

  열 표시·숨김 상태가 바뀌었을 때 발생합니다.

• selectionChanged

  행 선택 결과가 바뀌었을 때 발생합니다. 선택 ID를 사용해 일괄 작업 대상을 구성합니다.

• rowHoverChanged

  상태형 hover 행이 바뀌었을 때 발생합니다. CSS 전용 hover와 달리 앱에서 상태를 읽을 수 있습니다.

• themeChanged

  Grid 테마가 바뀌었을 때 발생합니다. 앱 바깥 영역의 테마와 함께 확인합니다.

• localeChanged

  Grid 언어 설정이 바뀌었을 때 발생합니다.

• gridObjectChanged

  현재 행·열 등 공개 객체의 상태가 바뀌었을 때 발생합니다. detail의 대상과 변경 내용을 읽습니다.

• stateUpdated

  통합 화면 상태가 갱신되었을 때 발생합니다. 잦은 이벤트는 앱에서 저장 주기를 조절하세요.

• preDestroyed

  Grid가 해제되기 전에 상태와 캡처 문제를 전달합니다. 화면 설정 저장과 자원 정리에 사용합니다.

• batchEditStart

  일괄 편집이 시작되었을 때 발생합니다. 대기 변경 UI를 열 수 있습니다.

• batchEditEnd

  일괄 편집이 확정되거나 취소되었을 때 발생합니다. 종료 이유와 처리 결과를 확인합니다.

• rowValueChanged

  전체 행 편집의 값 변경 결과를 알립니다. 한 행에 대한 저장 단위를 구성할 때 사용합니다.

• rowEditStart

  전체 행 편집이 시작되었을 때 발생합니다.

• rowEditStop

  전체 행 편집이 끝났을 때 발생합니다. 확정과 취소를 구분합니다.

• fillStart

  범위 채우기가 시작되었을 때 발생합니다.

• fillEnd

  범위 채우기가 끝났을 때 발생합니다. 적용·건너뜀·거절 결과를 사용자에게 안내합니다.

• pivotCombinationConflict

  피벗과 다른 기능의 설정이 충돌했을 때 발생합니다. 실제 조합 결정을 보고 앱의 옵션을 조정합니다.

• pivotColumnsChanged

  피벗 결과 열 모델이 바뀌었을 때 발생합니다. 기존 결과 열 ID를 쓰는 차트·출력 코드를 갱신합니다.

• serverStoreUpdated

  서버 행 저장소가 갱신되었을 때 발생합니다. 경로와 캐시 상태를 확인합니다.

• rowDragEnter

  행 드래그가 대상 영역에 진입했을 때 발생합니다.

• rowDragMove

  행 드래그가 이동 중일 때 발생합니다. 고빈도 이벤트이므로 무거운 저장 작업을 매번 실행하지 마세요.

• rowDragLeave

  행 드래그가 영역을 벗어났을 때 발생합니다. 드래그 완료와는 다른 상태입니다.

• rowDragEnd

  행 드래그가 끝났을 때 발생합니다. 실제 반영 결과와 드롭 위치를 확인합니다.

• rowDragCancel

  행 드래그가 취소되었을 때 발생합니다. 완료 처리나 서버 순서 저장을 실행하지 마세요.

• rowsTransferred

  드롭 영역 간 행 전달 결과를 알립니다. 실제 이동·복사·거절 결과를 확인합니다.

• spanConflict

  셀 병합이 다른 범위나 레이아웃과 충돌했을 때 발생합니다.

• treeReparented

  트리 행의 부모 변경 결과를 알립니다. 앱 서버의 부모 관계 저장과 연결할 수 있습니다.

• pinnedRowsChanged

  위·아래 고정 행 데이터가 바뀌었을 때 발생합니다.

• rowLayoutRefused

  요청한 행 레이아웃을 적용할 수 없을 때 발생합니다. 거절 이유에 맞춰 조합을 수정합니다.

• workbookValuesPropagated

  시트 사이에 값 전파가 처리되었을 때 발생합니다. 전파 결과와 세대 정보를 확인합니다.

• chartCreated

  Grid 연결 차트가 생성되었을 때 발생합니다. 차트 식별자로 앱의 차트 목록을 관리합니다.

• chartRangeChanged

  연결 차트의 소스 범위가 바뀌었을 때 발생합니다.

• chartOptionsChanged

  연결 차트의 설정이 바뀌었을 때 발생합니다. 저장한 차트 모델을 갱신할 수 있습니다.

• chartDestroyed

  연결 차트가 해제되었을 때 발생합니다. 앱에서 유지하던 참조와 외부 자원을 정리합니다.