Cheatsheets and messagesMessages
Clipboard, layout, and plugin messages
Look up the warnings about the clipboard, the layout, plugins, and column groups, and fix their cause.
Most console warnings print only in a development build, and most print once. A word in angle brackets, such as <id>, stands for a value that the grid fills in. A message that ends in ... continues past the text that the table quotes. The tables leave out the backticks that some messages put around prop names.
Clipboard warnings
These warnings come from copy and paste.
| Message | What to do | Page |
|---|---|---|
[data-grid] copy truncated to <n> of <total> rows (MAX_COPY_CELLS) | A copy covers at most 200,000 cells. Copy a smaller range. | Clipboard |
[data-grid] paste truncated to <n> of <total> rows (MAX_PASTE_CELLS) | A paste covers at most 200,000 cells. Paste a smaller block. | Clipboard |
[data-grid] processPaste rejected, so the paste is cancelled: <error> | Fix the error in processPaste, or catch it inside the function. | Clipboard |
[data-grid] processCellFromClipboard rejected, so the paste is cancelled: <error> | Fix the error in processCellFromClipboard, or catch it inside the function. | Clipboard |
[data-grid] processCellFromClipboard threw, so the paste is cancelled: <error> | Fix the error in processCellFromClipboard. | Clipboard |
[data-grid] resolveTexts rejected, so the paste is cancelled: <error> | Fix the error in the resolveTexts of the cell type, or catch it inside the function. The lookup type calls resolveLabels from it. | Lookup cell |
[data-grid] processFill rejected, so the fill is cancelled: <error> | Fix the error in processFill, or catch it inside the function. | Fill handle |
[data-grid] validateMany is ignored on a column whose validate is a Standard Schema; move the rule into the schema or use a function validate. | Use a function validate, or put the rule in the schema. | Validation |
validateMany must return one answer per cell: expected <n> | Return an array with one entry per cell, null for a cell that passes. The grid rejects every cell of the write with this text. | Validation |
Layout warnings
These warnings come from the size of the grid.
| Message | What to do | Page |
|---|---|---|
[data-grid] <rowCount> rows at <rowHeight>px need <height>px of scroll height, which is above the browser height limit ... | Show fewer rows at once. Page them with server pagination, or narrow the view with a filter. | Row limits |
[data-grid] rendered row count (<n>) does not match the expected window size (<expected>) — start=<start> end=<end> activeRowOffWindow=<flag>. | Report this as a bug with the values in the text. | Virtualization |
[data-grid] pin: "left" is now "start" and pin: "right" is now "end"; "<value>" is read as "<name>" | Rename the pin value to "start" or "end". The grid still reads the old value. | Column order and pinning |
Plugin warnings
These warnings come from the plugins prop. A plugin comes from an add-on hook.
| Message | What to do | Page |
|---|---|---|
[data-grid] plugin "<name>" is already attached to another grid; a plugin instance attaches to one grid — pass a fresh plugin object (the add-on hook's result) to each grid | Call the add-on hook once per grid and pass each result to its own grid. | Plugin API |
[data-grid] two plugins named "<name>"; the later one is ignored — the name is the plugin's React key and its identity | Give each plugin its own name. | Plugin model |
[data-grid] plugin "<name>"'s Overlay component identity changed; the overlay remounts and loses its state | Keep the Overlay component the same function between renders. | Plugin overlays |
[data-grid] plugin "<name>"'s Mount component identity changed; the mount remounts and loses its state | Keep the Mount component the same function between renders. | Plugin overlays |
[data-grid] plugins "<first>" and "<second>" both define command "<name>"; the first plugin keeps it and the later command is dropped | Rename one of the commands. | Plugin commands and shortcuts |
[data-grid] [data-grid] plugin cellMenuItems threw: | Fix the error in the plugin. The grid prints the error object after the text. | Plugin API |
[data-grid] plugin "<name>"'s command "<command>" names a built-in action and is dropped — plugins cannot replace core behavior | Rename the command. A plugin command cannot take the name of a core action. | Plugin commands and shortcuts |
[data-grid] plugin "<name>"'s keymap binds "<command>", which is a built-in action; the entry is dropped — a plugin keymap binds the plugin's own commands | Bind the core action through your own keymap prop. A plugin keymap binds the commands that the plugin defines. | Plugin commands and shortcuts |
[data-grid] plugin "<name>"'s keymap binds "<command>" but the plugin defines no such command; the entry is dropped — a plugin keymap binds the plugin's own commands only | Add the command to the plugin or remove the keymap entry. | Plugin commands and shortcuts |
[data-grid] plugin "<name>"'s binding for "<command>" repeats a key that another action, the default keymap, or the consumer's keymap already binds; the colliding binding is dropped | Pick another key in the plugin keymap. The first owner of a key keeps it. | Plugin commands and shortcuts |
[data-grid] plugin "<name>"'s binding for "<command>" takes the focusSearch key, so the key no longer focuses the toolbar search; set keymap.focusSearch to keep a search key or to [] to hand the key over | Set keymap.focusSearch in your keymap prop: another key keeps the toolbar search, [] hands the key to the plugin. | Plugin commands and shortcuts |
Column group warnings
These warnings come from the columnGroups prop.
| Message | What to do | Page |
|---|---|---|
[data-grid] columnGroups is larger than <max> entries; the rest is ignored | Define fewer groups. | Column headers and groups |
[data-grid] a columnGroups entry needs a string id and a children array; it is ignored | Give each group a string id and a children array. | Column headers and groups |
[data-grid] column group "<id>" appears twice in the tree; the second place is ignored | List each group once. | Column headers and groups |
[data-grid] column group id "<id>" is not unique across groups and columns; the group is ignored | Give the group an id that no column or group uses. | Column headers and groups |
[data-grid] column group "<id>" nests deeper than <max> levels; it is ignored | Nest the group less deep. | Column headers and groups |
[data-grid] column group "<id>" lists unknown column "<columnId>"; it is ignored | List column ids that exist. | Column headers and groups |
[data-grid] column "<columnId>" is listed in more than one group; the first group wins | List the column in one group. | Column headers and groups |
Related
- Message index: all message pages
- Labels and i18n: change the text the grid shows
- Troubleshoot server data: fix a server data problem