gridcn2.0.0
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.

MessageWhat to doPage
[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.

MessageWhat to doPage
[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.

MessageWhat to doPage
[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 gridCall 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 identityGive each plugin its own name.Plugin model
[data-grid] plugin "<name>"'s Overlay component identity changed; the overlay remounts and loses its stateKeep 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 stateKeep 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 droppedRename 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 behaviorRename 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 commandsBind 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 onlyAdd 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 droppedPick 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 overSet 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.

MessageWhat to doPage
[data-grid] columnGroups is larger than <max> entries; the rest is ignoredDefine fewer groups.Column headers and groups
[data-grid] a columnGroups entry needs a string id and a children array; it is ignoredGive 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 ignoredList each group once.Column headers and groups
[data-grid] column group id "<id>" is not unique across groups and columns; the group is ignoredGive 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 ignoredNest the group less deep.Column headers and groups
[data-grid] column group "<id>" lists unknown column "<columnId>"; it is ignoredList column ids that exist.Column headers and groups
[data-grid] column "<columnId>" is listed in more than one group; the first group winsList the column in one group.Column headers and groups

On this page