# Events

Find 93 sy-grid Events entries by name and open their descriptions, types, and examples.

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

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

## Complete list

- [queryComplete](https://grid.syidax.com/docs/events/queryComplete.md) — Emitted when an engine query completes. Read results and actual execution tier from detail for performance and result feedback.
- [sortChanged](https://grid.syidax.com/docs/events/sortChanged.md) — Emitted when sorting changes. Reflect the current model in app query conditions or saved view state.
- [filterChanged](https://grid.syidax.com/docs/events/filterChanged.md) — Emitted when applied filters change. Distinguish from filterModified, which describes input changes.
- [filterModified](https://grid.syidax.com/docs/events/filterModified.md) — Emitted when filter input changes. Filters with an Apply button may not yet have updated result rows.
- [conditionFilterChanged](https://grid.syidax.com/docs/events/conditionFilterChanged.md) — Emitted when the AND/OR condition tree changes. A null model means advanced conditions were cleared.
- [conditionPresetsChanged](https://grid.syidax.com/docs/events/conditionPresetsChanged.md) — Emitted when advanced condition presets change. Connect presets to user preference storage.
- [columnGroupToggled](https://grid.syidax.com/docs/events/columnGroupToggled.md) — Emitted when a column group header expands or collapses. Read groupId and open for its state.
- [rowGroupToggled](https://grid.syidax.com/docs/events/rowGroupToggled.md) — Emitted when a row group expands or collapses. Reuse the actual key in detail, not the display label.
- [treeNodeToggled](https://grid.syidax.com/docs/events/treeNodeToggled.md) — Emitted when tree expansion changes. Inspect the path and expanded state.
- [detailRowToggled](https://grid.syidax.com/docs/events/detailRowToggled.md) — Emitted when a parent row's detail expansion changes.
- [detailRowCreated](https://grid.syidax.com/docs/events/detailRowCreated.md) — Emitted when a detail panel is created. Connect app resources using its row ID and parent data.
- [detailRowDestroyed](https://grid.syidax.com/docs/events/detailRowDestroyed.md) — Emitted when a detail panel is destroyed. Clean up app resources associated with its rowId too.
- [rangeSelectionChanged](https://grid.syidax.com/docs/events/rangeSelectionChanged.md) — Emitted when cell selection ranges change. Use the boundaries for copying or summaries.
- [toolPanelToggled](https://grid.syidax.com/docs/events/toolPanelToggled.md) — Emitted when column/filter tool panel visibility changes.
- [csvImported](https://grid.syidax.com/docs/events/csvImported.md) — Emitted after CSV import completes. Report the actual applied row and column counts to users.
- [clipboardCopied](https://grid.syidax.com/docs/events/clipboardCopied.md) — Emitted after clipboard copying completes. Output text and ranges are available, so avoid logging sensitive values.
- [clipboardPasted](https://grid.syidax.com/docs/events/clipboardPasted.md) — Reports paste results. Inspect applied/skipped counts, starting position, and actual changes together.
- [paginationChanged](https://grid.syidax.com/docs/events/paginationChanged.md) — Emitted when the page or page size changes. Synchronize external page indicators.
- [quickFilterChanged](https://grid.syidax.com/docs/events/quickFilterChanged.md) — Emitted when quick-filter conditions change. Synchronize external search input values if needed.
- [emptyStateActionClicked](https://grid.syidax.com/docs/events/emptyStateActionClicked.md) — Emitted when an empty-state action button is clicked. Connect the app flow appropriate to the action type.
- [activeCellChanged](https://grid.syidax.com/docs/events/activeCellChanged.md) — Emitted when keyboard or pointer input changes the active cell. Separate from range or row selection.
- [cellClicked](https://grid.syidax.com/docs/events/cellClicked.md) — Emitted on a cell click. Read the row, field, and input context from detail.
- [cellDoubleClicked](https://grid.syidax.com/docs/events/cellDoubleClicked.md) — Emitted on a cell double-click. Avoid conflicts between starting editing and opening app details.
- [rowClicked](https://grid.syidax.com/docs/events/rowClicked.md) — Emitted on a row click. Distinguish the click itself from the resulting selection.
- [cellEditingRequested](https://grid.syidax.com/docs/events/cellEditingRequested.md) — Emitted when cell editing is requested. Distinguish later cancellation, commit, and value-change events.
- [cellEditingCancelled](https://grid.syidax.com/docs/events/cellEditingCancelled.md) — Emitted when cell editing is cancelled. Do not treat it as a successful server save.
- [cellEditingCommitted](https://grid.syidax.com/docs/events/cellEditingCommitted.md) — Emitted when cell editing is committed. Also inspect cellValueChanged for actual value changes.
- [formulaEvaluated](https://grid.syidax.com/docs/events/formulaEvaluated.md) — Emitted when a formula result is calculated. Distinguish formula text from its result.
- [formulaError](https://grid.syidax.com/docs/events/formulaError.md) — Emitted when formula evaluation fails. Connect target and error information to a review UI.
- [workbookBindingChanged](https://grid.syidax.com/docs/events/workbookBindingChanged.md) — Emitted when the Grid's workbook/sheet connection changes.
- [workbookBindingError](https://grid.syidax.com/docs/events/workbookBindingError.md) — Emitted when a workbook connection cannot be configured. Inspect identifiers and connection errors.
- [chunkLoading](https://grid.syidax.com/docs/events/chunkLoading.md) — Emitted when feature code starts loading. Separate from row data query events.
- [chunkLoaded](https://grid.syidax.com/docs/events/chunkLoaded.md) — Emitted when feature code has loaded.
- [chunkLoadFailed](https://grid.syidax.com/docs/events/chunkLoadFailed.md) — Emitted when feature code loading fails. Use the error and feature name for retry or fallback guidance.
- [componentError](https://grid.syidax.com/docs/events/componentError.md) — Reports custom component initialization or invocation errors. Handle them by target and phase rather than ignoring them.
- [rowDataChanged](https://grid.syidax.com/docs/events/rowDataChanged.md) — Emitted when source row data changes. Different from a change in display sorting.
- [cellValueChanged](https://grid.syidax.com/docs/events/cellValueChanged.md) — Emitted when an actual cell value changes. Use the row, field, and before/after values for saving or activity history.
- [rowMoved](https://grid.syidax.com/docs/events/rowMoved.md) — Emitted when row order changes. Read the affected row and before/after indices.
- [rowGroupChanged](https://grid.syidax.com/docs/events/rowGroupChanged.md) — Emitted when row grouping changes. Inspect group fields and whether grouping was cleared.
- [pivotPanelChanged](https://grid.syidax.com/docs/events/pivotPanelChanged.md) — Emitted when axes change in the pivot panel. Inspect the changed axis and current pivot state.
- [pivotChanged](https://grid.syidax.com/docs/events/pivotChanged.md) — Reports pivot configuration changes. Avoid duplicate saves from subscribing to both compatibility and panel events.
- [pivotModeChanged](https://grid.syidax.com/docs/events/pivotModeChanged.md) — Emitted when pivot mode is enabled or disabled.
- [contextMenuItemClicked](https://grid.syidax.com/docs/events/contextMenuItemClicked.md) — Emitted when a cell context-menu item runs. Read its item ID and target cell position.
- [remoteEditApplied](https://grid.syidax.com/docs/events/remoteEditApplied.md) — Emitted when a collaborator's edit is applied. Track its origin to avoid resending it as a local edit and creating a loop.
- [presenceChanged](https://grid.syidax.com/docs/events/presenceChanged.md) — Emitted when participant positions or presence change.
- [collabConflictResolved](https://grid.syidax.com/docs/events/collabConflictResolved.md) — Emitted when a concurrent editing conflict is resolved. Read the actual outcome before explaining it to users.
- [collaboratorJoined](https://grid.syidax.com/docs/events/collaboratorJoined.md) — Emitted when a participant joins the collaboration room.
- [collaboratorLeft](https://grid.syidax.com/docs/events/collaboratorLeft.md) — Emitted when a participant leaves. Update the app's participant list by ID.
- [syncStatusChanged](https://grid.syidax.com/docs/events/syncStatusChanged.md) — Emitted when collaboration synchronization changes. Distinguish connection state from completed persistent server saving.
- [cellCommentsChanged](https://grid.syidax.com/docs/events/cellCommentsChanged.md) — Emitted when cell collaboration comments change. Read the row ID, field, and latest comments.
- [commentMentioned](https://grid.syidax.com/docs/events/commentMentioned.md) — Reports a mention in collaboration comments. Connect app notifications using the target cell and comment.
- [auditLogChanged](https://grid.syidax.com/docs/events/auditLogChanged.md) — Emitted when an audit record is added. Read entry to connect your app's retention flow.
- [conditionalFormatsChanged](https://grid.syidax.com/docs/events/conditionalFormatsChanged.md) — Emitted when conditional formatting rules change. Save rules as user preferences.
- [cellValidationFailed](https://grid.syidax.com/docs/events/cellValidationFailed.md) — Emitted when validation fails. Use the target cell, input, and message to guide corrections.
- [snapshotCaptured](https://grid.syidax.com/docs/events/snapshotCaptured.md) — Emitted when a data snapshot is created. Display the saved point using its ID, name, and row count.
- [snapshotRestored](https://grid.syidax.com/docs/events/snapshotRestored.md) — Emitted when snapshot restoration completes. Does not indicate completed server saving.
- [xlsxImported](https://grid.syidax.com/docs/events/xlsxImported.md) — Emits the selected sheet's Grid snapshot after XLSX parsing. Apply snapshot.columnDefs and snapshot.rowData in your app if needed.
- [historyChanged](https://grid.syidax.com/docs/events/historyChanged.md) — Emitted when undo/redo history changes. Update button availability and current depths.
- [columnResized](https://grid.syidax.com/docs/events/columnResized.md) — Emitted when column width changes. Include the current width in saved view state.
- [columnReordered](https://grid.syidax.com/docs/events/columnReordered.md) — Emitted when column order changes.
- [columnVisibilityChanged](https://grid.syidax.com/docs/events/columnVisibilityChanged.md) — Emitted when column visibility changes.
- [selectionChanged](https://grid.syidax.com/docs/events/selectionChanged.md) — Emitted when row selection changes. Use selected IDs to define bulk-operation targets.
- [rowHoverChanged](https://grid.syidax.com/docs/events/rowHoverChanged.md) — Emitted when the stateful hovered row changes. Unlike CSS-only hover, the app can read this state.
- [themeChanged](https://grid.syidax.com/docs/events/themeChanged.md) — Emitted when the Grid theme changes. Check it alongside the surrounding app theme.
- [localeChanged](https://grid.syidax.com/docs/events/localeChanged.md) — Emitted when the Grid locale changes.
- [gridObjectChanged](https://grid.syidax.com/docs/events/gridObjectChanged.md) — Emitted when public objects such as rows and columns change. Read the target and changes from detail.
- [stateUpdated](https://grid.syidax.com/docs/events/stateUpdated.md) — Emitted when combined view state updates. Adjust persistence frequency in your app for frequent events.
- [preDestroyed](https://grid.syidax.com/docs/events/preDestroyed.md) — Provides state and capture issues before the Grid is destroyed. Use for saving view preferences and cleaning up resources.
- [batchEditStart](https://grid.syidax.com/docs/events/batchEditStart.md) — Emitted when batch editing starts. Open a staged-changes UI if needed.
- [batchEditEnd](https://grid.syidax.com/docs/events/batchEditEnd.md) — Emitted when batch editing commits or cancels. Inspect the end reason and results.
- [rowValueChanged](https://grid.syidax.com/docs/events/rowValueChanged.md) — Reports full-row value changes. Use when defining a save unit for an entire row.
- [rowEditStart](https://grid.syidax.com/docs/events/rowEditStart.md) — Emitted when full-row editing starts.
- [rowEditStop](https://grid.syidax.com/docs/events/rowEditStop.md) — Emitted when full-row editing ends. Distinguish commit from cancellation.
- [fillStart](https://grid.syidax.com/docs/events/fillStart.md) — Emitted when range filling starts.
- [fillEnd](https://grid.syidax.com/docs/events/fillEnd.md) — Emitted when range filling ends. Explain applied, skipped, and rejected results to users.
- [pivotCombinationConflict](https://grid.syidax.com/docs/events/pivotCombinationConflict.md) — Emitted when pivot settings conflict with other features. Adjust app options based on the actual compatibility decision.
- [pivotColumnsChanged](https://grid.syidax.com/docs/events/pivotColumnsChanged.md) — Emitted when the pivot result column model changes. Update chart and export code using previous result column IDs.
- [serverStoreUpdated](https://grid.syidax.com/docs/events/serverStoreUpdated.md) — Emitted when a server row store refreshes. Inspect its path and cache state.
- [rowDragEnter](https://grid.syidax.com/docs/events/rowDragEnter.md) — Emitted when a row drag enters a target area.
- [rowDragMove](https://grid.syidax.com/docs/events/rowDragMove.md) — Emitted during row dragging. Avoid expensive save operations on every high-frequency event.
- [rowDragLeave](https://grid.syidax.com/docs/events/rowDragLeave.md) — Emitted when a row drag leaves an area. Different from drag completion.
- [rowDragEnd](https://grid.syidax.com/docs/events/rowDragEnd.md) — Emitted when row dragging ends. Inspect the applied result and drop position.
- [rowDragCancel](https://grid.syidax.com/docs/events/rowDragCancel.md) — Emitted when row dragging is cancelled. Do not run completion actions or save server ordering.
- [rowsTransferred](https://grid.syidax.com/docs/events/rowsTransferred.md) — Reports row transfers between drop areas. Inspect actual move, copy, and rejection results.
- [spanConflict](https://grid.syidax.com/docs/events/spanConflict.md) — Emitted when cell spans conflict with other ranges or layouts.
- [treeReparented](https://grid.syidax.com/docs/events/treeReparented.md) — Reports tree reparenting results. Connect to parent-relationship saving on your app server.
- [pinnedRowsChanged](https://grid.syidax.com/docs/events/pinnedRowsChanged.md) — Emitted when top/bottom pinned row data changes.
- [rowLayoutRefused](https://grid.syidax.com/docs/events/rowLayoutRefused.md) — Emitted when a requested row layout cannot be applied. Adjust the combination according to the rejection reason.
- [workbookValuesPropagated](https://grid.syidax.com/docs/events/workbookValuesPropagated.md) — Emitted after cross-sheet value propagation. Inspect results and generation information.
- [chartCreated](https://grid.syidax.com/docs/events/chartCreated.md) — Emitted when an integrated Grid chart is created. Manage your app's chart list by chart ID.
- [chartRangeChanged](https://grid.syidax.com/docs/events/chartRangeChanged.md) — Emitted when an integrated chart's source range changes.
- [chartOptionsChanged](https://grid.syidax.com/docs/events/chartOptionsChanged.md) — Emitted when integrated chart settings change. Update saved chart models if needed.
- [chartDestroyed](https://grid.syidax.com/docs/events/chartDestroyed.md) — Emitted when an integrated chart is destroyed. Clean up app-held references and external resources.