# 이벤트

sy-grid의 이벤트 93개를 이름으로 찾고 설명·타입·예제로 이동할 수 있습니다.

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

<a id="index"></a>

## 전체 목록

- [queryComplete](https://grid.syidax.com/ko/docs/events/queryComplete.md) — 처리 엔진의 조회가 완료되었을 때 발생합니다. 결과와 실제 실행 tier를 detail에서 읽어 성능·결과 안내에 연결합니다.
- [sortChanged](https://grid.syidax.com/ko/docs/events/sortChanged.md) — 정렬 기준이 바뀌었을 때 발생합니다. 현재 정렬 모델을 앱의 검색 조건이나 화면 저장에 반영합니다.
- [filterChanged](https://grid.syidax.com/ko/docs/events/filterChanged.md) — 적용된 필터가 바뀌었을 때 발생합니다. 입력 중 변경인 filterModified와 구분합니다.
- [filterModified](https://grid.syidax.com/ko/docs/events/filterModified.md) — 필터 입력이 수정되었을 때 발생합니다. 적용 버튼이 있는 필터에서는 아직 결과 행에 반영되기 전일 수 있습니다.
- [conditionFilterChanged](https://grid.syidax.com/ko/docs/events/conditionFilterChanged.md) — AND·OR 조건 트리가 바뀌었을 때 발생합니다. model이 null이면 고급 조건이 해제된 상태입니다.
- [conditionPresetsChanged](https://grid.syidax.com/ko/docs/events/conditionPresetsChanged.md) — 고급 조건 프리셋 목록이 바뀌었을 때 발생합니다. presets를 사용자 설정 저장에 연결합니다.
- [columnGroupToggled](https://grid.syidax.com/ko/docs/events/columnGroupToggled.md) — 열 그룹 머리글을 펼치거나 접었을 때 발생합니다. groupId와 open으로 현재 상태를 읽습니다.
- [rowGroupToggled](https://grid.syidax.com/ko/docs/events/rowGroupToggled.md) — 행 그룹을 펼치거나 접었을 때 발생합니다. 표시 라벨 대신 detail의 실제 key를 재사용합니다.
- [treeNodeToggled](https://grid.syidax.com/ko/docs/events/treeNodeToggled.md) — 트리 노드의 펼침 상태가 바뀌었을 때 발생합니다. 경로와 expanded를 확인합니다.
- [detailRowToggled](https://grid.syidax.com/ko/docs/events/detailRowToggled.md) — 부모 행의 상세 패널 펼침 상태가 바뀌었을 때 발생합니다.
- [detailRowCreated](https://grid.syidax.com/ko/docs/events/detailRowCreated.md) — 부모 행의 상세 패널이 생성되었을 때 발생합니다. 행 ID와 부모 데이터로 앱 자원을 연결할 수 있습니다.
- [detailRowDestroyed](https://grid.syidax.com/ko/docs/events/detailRowDestroyed.md) — 상세 패널이 해제되었을 때 발생합니다. 앱에서 연결한 자원도 해당 rowId 기준으로 정리합니다.
- [rangeSelectionChanged](https://grid.syidax.com/ko/docs/events/rangeSelectionChanged.md) — 셀 선택 범위가 바뀌었을 때 발생합니다. 범위 경계 목록으로 복사·요약 기능을 연결합니다.
- [toolPanelToggled](https://grid.syidax.com/ko/docs/events/toolPanelToggled.md) — 열·필터 도구 패널의 열림 상태가 바뀌었을 때 발생합니다.
- [csvImported](https://grid.syidax.com/ko/docs/events/csvImported.md) — CSV 가져오기를 마쳤을 때 발생합니다. 실제 적용된 행 수와 열 수를 사용자에게 안내합니다.
- [clipboardCopied](https://grid.syidax.com/ko/docs/events/clipboardCopied.md) — 클립보드 복사가 완료되었을 때 발생합니다. 출력 텍스트와 범위를 확인할 수 있으므로 민감 정보 로그를 주의합니다.
- [clipboardPasted](https://grid.syidax.com/ko/docs/events/clipboardPasted.md) — 붙여넣기 처리 결과를 알립니다. 적용 수·건너뛴 수·시작 위치·실제 변경 목록을 함께 확인합니다.
- [paginationChanged](https://grid.syidax.com/ko/docs/events/paginationChanged.md) — 페이지 또는 페이지 크기가 바뀌었을 때 발생합니다. 외부 페이지 안내와 동기화합니다.
- [quickFilterChanged](https://grid.syidax.com/ko/docs/events/quickFilterChanged.md) — 빠른 검색 조건이 바뀌었을 때 발생합니다. 앱 외부 검색 입력과 값을 동기화할 수 있습니다.
- [emptyStateActionClicked](https://grid.syidax.com/ko/docs/events/emptyStateActionClicked.md) — 빈 결과 안내 영역의 작업 버튼을 눌렀을 때 발생합니다. 작업 종류에 맞게 앱 흐름을 연결합니다.
- [activeCellChanged](https://grid.syidax.com/ko/docs/events/activeCellChanged.md) — 키보드·포인터 조작으로 활성 셀이 바뀌었을 때 발생합니다. 선택 범위나 행 선택과 다른 상태입니다.
- [cellClicked](https://grid.syidax.com/ko/docs/events/cellClicked.md) — 셀을 한 번 클릭했을 때 발생합니다. 실제 행·필드와 입력 문맥은 detail에서 읽습니다.
- [cellDoubleClicked](https://grid.syidax.com/ko/docs/events/cellDoubleClicked.md) — 셀을 두 번 클릭했을 때 발생합니다. 편집 시작과 앱 상세 열기가 충돌하지 않도록 처리합니다.
- [rowClicked](https://grid.syidax.com/ko/docs/events/rowClicked.md) — 행을 클릭했을 때 발생합니다. 클릭 자체와 선택 결과는 구분합니다.
- [cellEditingRequested](https://grid.syidax.com/ko/docs/events/cellEditingRequested.md) — 셀 편집을 요청했을 때 발생합니다. 이후 취소·확정·값 변경 이벤트와 흐름을 구분합니다.
- [cellEditingCancelled](https://grid.syidax.com/ko/docs/events/cellEditingCancelled.md) — 셀 편집이 취소되었을 때 발생합니다. 서버 저장 성공으로 처리하지 마세요.
- [cellEditingCommitted](https://grid.syidax.com/ko/docs/events/cellEditingCommitted.md) — 셀 편집이 확정되었을 때 발생합니다. 실제 값 변경은 cellValueChanged도 함께 확인합니다.
- [formulaEvaluated](https://grid.syidax.com/ko/docs/events/formulaEvaluated.md) — 수식 계산 결과가 나왔을 때 발생합니다. 원문 수식과 계산 결과를 구분해 읽습니다.
- [formulaError](https://grid.syidax.com/ko/docs/events/formulaError.md) — 수식을 계산하지 못했을 때 발생합니다. 대상과 오류 정보를 사용자 검토 화면에 연결합니다.
- [workbookBindingChanged](https://grid.syidax.com/ko/docs/events/workbookBindingChanged.md) — Grid의 워크북·시트 연결이 바뀌었을 때 발생합니다.
- [workbookBindingError](https://grid.syidax.com/ko/docs/events/workbookBindingError.md) — 워크북 연결을 구성하지 못했을 때 발생합니다. 식별자와 연결 오류 정보를 확인합니다.
- [chunkLoading](https://grid.syidax.com/ko/docs/events/chunkLoading.md) — 기능 코드 조각의 로딩이 시작되었을 때 발생합니다. 행 데이터 조회 이벤트와 구분합니다.
- [chunkLoaded](https://grid.syidax.com/ko/docs/events/chunkLoaded.md) — 기능 코드 조각을 불러왔을 때 발생합니다.
- [chunkLoadFailed](https://grid.syidax.com/ko/docs/events/chunkLoadFailed.md) — 기능 코드 로딩이 실패했을 때 발생합니다. 오류와 대상 기능을 확인해 재시도·대체 안내에 연결합니다.
- [componentError](https://grid.syidax.com/ko/docs/events/componentError.md) — 사용자 컴포넌트 초기화·호출 등에서 오류가 발생했을 때 알립니다. 오류를 무시하지 말고 대상과 단계별로 처리합니다.
- [rowDataChanged](https://grid.syidax.com/ko/docs/events/rowDataChanged.md) — 원본 행 데이터가 바뀌었을 때 발생합니다. 화면 정렬 순서 변경과는 다릅니다.
- [cellValueChanged](https://grid.syidax.com/ko/docs/events/cellValueChanged.md) — 셀의 실제 값이 바뀌었을 때 발생합니다. 행·필드·변경 전후 값으로 저장이나 활동 내역을 구성합니다.
- [rowMoved](https://grid.syidax.com/ko/docs/events/rowMoved.md) — 행 순서가 이동되었을 때 발생합니다. 이동 전후 인덱스와 해당 행을 읽습니다.
- [rowGroupChanged](https://grid.syidax.com/ko/docs/events/rowGroupChanged.md) — 행 그룹 기준이 바뀌었을 때 발생합니다. 기준 필드와 그룹 해제 상태를 확인합니다.
- [pivotPanelChanged](https://grid.syidax.com/ko/docs/events/pivotPanelChanged.md) — 피벗 패널에서 축 구성이 바뀌었을 때 발생합니다. 변경된 축과 현재 피벗 상태를 확인합니다.
- [pivotChanged](https://grid.syidax.com/ko/docs/events/pivotChanged.md) — 피벗 구성이 바뀌었음을 알립니다. 호환 이벤트와 패널 이벤트를 중복 구독해 같은 저장을 반복하지 마세요.
- [pivotModeChanged](https://grid.syidax.com/ko/docs/events/pivotModeChanged.md) — 피벗 모드의 켜짐·꺼짐이 바뀌었을 때 발생합니다.
- [contextMenuItemClicked](https://grid.syidax.com/ko/docs/events/contextMenuItemClicked.md) — 셀 우클릭 메뉴 항목을 실행했을 때 발생합니다. 항목 ID와 대상 셀 위치를 읽습니다.
- [remoteEditApplied](https://grid.syidax.com/ko/docs/events/remoteEditApplied.md) — 협업 상대의 편집이 적용되었을 때 발생합니다. 이를 다시 로컬 편집으로 전송해 순환하지 않도록 출처를 구분합니다.
- [presenceChanged](https://grid.syidax.com/ko/docs/events/presenceChanged.md) — 협업 참가자의 위치·참여 상태가 바뀌었을 때 발생합니다.
- [collabConflictResolved](https://grid.syidax.com/ko/docs/events/collabConflictResolved.md) — 동시 편집 충돌을 해결했을 때 발생합니다. 충돌의 실제 결과를 읽어 사용자에게 설명합니다.
- [collaboratorJoined](https://grid.syidax.com/ko/docs/events/collaboratorJoined.md) — 협업 방에 참가자가 들어왔을 때 발생합니다.
- [collaboratorLeft](https://grid.syidax.com/ko/docs/events/collaboratorLeft.md) — 협업 방에서 참가자가 나갔을 때 발생합니다. ID로 앱의 참가자 목록을 갱신합니다.
- [syncStatusChanged](https://grid.syidax.com/ko/docs/events/syncStatusChanged.md) — 협업 동기화 상태가 바뀌었을 때 발생합니다. 연결 상태와 서버 영구 저장 완료를 구분해 안내합니다.
- [cellCommentsChanged](https://grid.syidax.com/ko/docs/events/cellCommentsChanged.md) — 셀의 협업 댓글 목록이 바뀌었을 때 발생합니다. 행 ID·필드·최신 댓글 목록을 읽습니다.
- [commentMentioned](https://grid.syidax.com/ko/docs/events/commentMentioned.md) — 협업 댓글에서 멘션이 발생했을 때 알립니다. 대상 셀과 댓글로 앱 알림을 연결합니다.
- [auditLogChanged](https://grid.syidax.com/ko/docs/events/auditLogChanged.md) — 감사 기록이 추가되었을 때 발생합니다. entry를 읽어 앱의 보존 흐름에 연결할 수 있습니다.
- [conditionalFormatsChanged](https://grid.syidax.com/ko/docs/events/conditionalFormatsChanged.md) — 조건부 서식 규칙 목록이 바뀌었을 때 발생합니다. rules를 사용자 설정으로 저장합니다.
- [cellValidationFailed](https://grid.syidax.com/ko/docs/events/cellValidationFailed.md) — 입력 검증이 실패했을 때 발생합니다. 대상 셀·입력값·메시지를 읽어 수정할 위치를 안내합니다.
- [snapshotCaptured](https://grid.syidax.com/ko/docs/events/snapshotCaptured.md) — 데이터 스냅샷이 만들어졌을 때 발생합니다. ID·이름·행 수로 저장 시점을 표시합니다.
- [snapshotRestored](https://grid.syidax.com/ko/docs/events/snapshotRestored.md) — 데이터 스냅샷 복원이 완료되었을 때 발생합니다. 앱 서버 저장까지 완료된 의미는 아닙니다.
- [xlsxImported](https://grid.syidax.com/ko/docs/events/xlsxImported.md) — XLSX 파싱 후 선택한 시트의 Grid용 snapshot을 전달합니다. 필요하면 snapshot.columnDefs와 snapshot.rowData를 앱에서 적용합니다.
- [historyChanged](https://grid.syidax.com/ko/docs/events/historyChanged.md) — 실행 취소·다시 실행 이력이 바뀌었을 때 발생합니다. 버튼의 활성 여부와 현재 깊이를 갱신합니다.
- [columnResized](https://grid.syidax.com/ko/docs/events/columnResized.md) — 열 너비가 바뀌었을 때 발생합니다. 현재 너비를 화면 상태 저장에 반영합니다.
- [columnReordered](https://grid.syidax.com/ko/docs/events/columnReordered.md) — 열 순서가 바뀌었을 때 발생합니다.
- [columnVisibilityChanged](https://grid.syidax.com/ko/docs/events/columnVisibilityChanged.md) — 열 표시·숨김 상태가 바뀌었을 때 발생합니다.
- [selectionChanged](https://grid.syidax.com/ko/docs/events/selectionChanged.md) — 행 선택 결과가 바뀌었을 때 발생합니다. 선택 ID를 사용해 일괄 작업 대상을 구성합니다.
- [rowHoverChanged](https://grid.syidax.com/ko/docs/events/rowHoverChanged.md) — 상태형 hover 행이 바뀌었을 때 발생합니다. CSS 전용 hover와 달리 앱에서 상태를 읽을 수 있습니다.
- [themeChanged](https://grid.syidax.com/ko/docs/events/themeChanged.md) — Grid 테마가 바뀌었을 때 발생합니다. 앱 바깥 영역의 테마와 함께 확인합니다.
- [localeChanged](https://grid.syidax.com/ko/docs/events/localeChanged.md) — Grid 언어 설정이 바뀌었을 때 발생합니다.
- [gridObjectChanged](https://grid.syidax.com/ko/docs/events/gridObjectChanged.md) — 현재 행·열 등 공개 객체의 상태가 바뀌었을 때 발생합니다. detail의 대상과 변경 내용을 읽습니다.
- [stateUpdated](https://grid.syidax.com/ko/docs/events/stateUpdated.md) — 통합 화면 상태가 갱신되었을 때 발생합니다. 잦은 이벤트는 앱에서 저장 주기를 조절하세요.
- [preDestroyed](https://grid.syidax.com/ko/docs/events/preDestroyed.md) — Grid가 해제되기 전에 상태와 캡처 문제를 전달합니다. 화면 설정 저장과 자원 정리에 사용합니다.
- [batchEditStart](https://grid.syidax.com/ko/docs/events/batchEditStart.md) — 일괄 편집이 시작되었을 때 발생합니다. 대기 변경 UI를 열 수 있습니다.
- [batchEditEnd](https://grid.syidax.com/ko/docs/events/batchEditEnd.md) — 일괄 편집이 확정되거나 취소되었을 때 발생합니다. 종료 이유와 처리 결과를 확인합니다.
- [rowValueChanged](https://grid.syidax.com/ko/docs/events/rowValueChanged.md) — 전체 행 편집의 값 변경 결과를 알립니다. 한 행에 대한 저장 단위를 구성할 때 사용합니다.
- [rowEditStart](https://grid.syidax.com/ko/docs/events/rowEditStart.md) — 전체 행 편집이 시작되었을 때 발생합니다.
- [rowEditStop](https://grid.syidax.com/ko/docs/events/rowEditStop.md) — 전체 행 편집이 끝났을 때 발생합니다. 확정과 취소를 구분합니다.
- [fillStart](https://grid.syidax.com/ko/docs/events/fillStart.md) — 범위 채우기가 시작되었을 때 발생합니다.
- [fillEnd](https://grid.syidax.com/ko/docs/events/fillEnd.md) — 범위 채우기가 끝났을 때 발생합니다. 적용·건너뜀·거절 결과를 사용자에게 안내합니다.
- [pivotCombinationConflict](https://grid.syidax.com/ko/docs/events/pivotCombinationConflict.md) — 피벗과 다른 기능의 설정이 충돌했을 때 발생합니다. 실제 조합 결정을 보고 앱의 옵션을 조정합니다.
- [pivotColumnsChanged](https://grid.syidax.com/ko/docs/events/pivotColumnsChanged.md) — 피벗 결과 열 모델이 바뀌었을 때 발생합니다. 기존 결과 열 ID를 쓰는 차트·출력 코드를 갱신합니다.
- [serverStoreUpdated](https://grid.syidax.com/ko/docs/events/serverStoreUpdated.md) — 서버 행 저장소가 갱신되었을 때 발생합니다. 경로와 캐시 상태를 확인합니다.
- [rowDragEnter](https://grid.syidax.com/ko/docs/events/rowDragEnter.md) — 행 드래그가 대상 영역에 진입했을 때 발생합니다.
- [rowDragMove](https://grid.syidax.com/ko/docs/events/rowDragMove.md) — 행 드래그가 이동 중일 때 발생합니다. 고빈도 이벤트이므로 무거운 저장 작업을 매번 실행하지 마세요.
- [rowDragLeave](https://grid.syidax.com/ko/docs/events/rowDragLeave.md) — 행 드래그가 영역을 벗어났을 때 발생합니다. 드래그 완료와는 다른 상태입니다.
- [rowDragEnd](https://grid.syidax.com/ko/docs/events/rowDragEnd.md) — 행 드래그가 끝났을 때 발생합니다. 실제 반영 결과와 드롭 위치를 확인합니다.
- [rowDragCancel](https://grid.syidax.com/ko/docs/events/rowDragCancel.md) — 행 드래그가 취소되었을 때 발생합니다. 완료 처리나 서버 순서 저장을 실행하지 마세요.
- [rowsTransferred](https://grid.syidax.com/ko/docs/events/rowsTransferred.md) — 드롭 영역 간 행 전달 결과를 알립니다. 실제 이동·복사·거절 결과를 확인합니다.
- [spanConflict](https://grid.syidax.com/ko/docs/events/spanConflict.md) — 셀 병합이 다른 범위나 레이아웃과 충돌했을 때 발생합니다.
- [treeReparented](https://grid.syidax.com/ko/docs/events/treeReparented.md) — 트리 행의 부모 변경 결과를 알립니다. 앱 서버의 부모 관계 저장과 연결할 수 있습니다.
- [pinnedRowsChanged](https://grid.syidax.com/ko/docs/events/pinnedRowsChanged.md) — 위·아래 고정 행 데이터가 바뀌었을 때 발생합니다.
- [rowLayoutRefused](https://grid.syidax.com/ko/docs/events/rowLayoutRefused.md) — 요청한 행 레이아웃을 적용할 수 없을 때 발생합니다. 거절 이유에 맞춰 조합을 수정합니다.
- [workbookValuesPropagated](https://grid.syidax.com/ko/docs/events/workbookValuesPropagated.md) — 시트 사이에 값 전파가 처리되었을 때 발생합니다. 전파 결과와 세대 정보를 확인합니다.
- [chartCreated](https://grid.syidax.com/ko/docs/events/chartCreated.md) — Grid 연결 차트가 생성되었을 때 발생합니다. 차트 식별자로 앱의 차트 목록을 관리합니다.
- [chartRangeChanged](https://grid.syidax.com/ko/docs/events/chartRangeChanged.md) — 연결 차트의 소스 범위가 바뀌었을 때 발생합니다.
- [chartOptionsChanged](https://grid.syidax.com/ko/docs/events/chartOptionsChanged.md) — 연결 차트의 설정이 바뀌었을 때 발생합니다. 저장한 차트 모델을 갱신할 수 있습니다.
- [chartDestroyed](https://grid.syidax.com/ko/docs/events/chartDestroyed.md) — 연결 차트가 해제되었을 때 발생합니다. 앱에서 유지하던 참조와 외부 자원을 정리합니다.