我刚好也遇到过类似的问题，分享两个核心问题的解决思路：

一、空网格下触发 Ctrl+V 粘贴回调 #

AG Grid 默认确实需要聚焦到行或单元格范围才会触发内置的粘贴逻辑，空网格时没有可聚焦的行节点，所以得换个思路：手动监听全局快捷键，判断网格状态后触发自定义粘贴逻辑。

具体实现步骤：

• 监听全局的 keydown 事件，判断是否是 Ctrl+V（Mac 下是 Cmd+V），同时确认当前焦点在 AG Grid 容器内，避免影响页面其他区域的粘贴操作。
• 若网格为空，阻止默认粘贴行为，直接调用你的粘贴处理函数。

示例代码：

// 组件挂载时添加监听（React/Vue 等框架里放在对应的生命周期）
document.addEventListener('keydown', (e) => {
  const isPasteShortcut = (e.ctrlKey || e.metaKey) && e.key.toLowerCase() === 'v';
  const gridContainer = document.querySelector('.ag-root-wrapper');
  const isFocusInGrid = gridContainer?.contains(document.activeElement);

  if (isPasteShortcut && isFocusInGrid) {
    const gridApi = window.yourGridInstanceApi; // 替换成你的 AG Grid API 实例
    const hasRows = gridApi.getDisplayedRowCount() > 0;

    if (!hasRows) {
      e.preventDefault(); // 避免浏览器默认粘贴干扰
      // 执行自定义粘贴逻辑
      await handleEmptyGridPaste();
    }
  }
});

如果你想和 AG Grid 内置的粘贴逻辑对齐，也可以在处理函数里复用 gridApi.pasteFromClipboard()，但空网格下这个方法可能不会生效，所以更推荐自己解析剪贴板数据后通过 applyTransaction 添加行。

二、上下文菜单中获取剪贴板内容 #

上下文菜单的粘贴按钮点击时，直接用浏览器的 Clipboard API 读取内容即可，注意处理异步和兼容性：

现代浏览器方案（推荐） #

使用 navigator.clipboard.readText()，它是异步方法，需要确保页面在 HTTPS 环境（localhost 本地开发也支持）：

// 上下文菜单配置项
const contextMenuItems = [
  {
    name: '粘贴',
    async action() {
      try {
        const clipboardContent = await navigator.clipboard.readText();
        // 解析剪贴板内容为 AG Grid 可接受的行数据（比如按制表符/换行分割）
        const rowsToAdd = parseClipboardRows(clipboardContent);
        // 添加到网格
        gridApi.applyTransaction({ add: rowsToAdd });
      } catch (error) {
        console.error('读取剪贴板失败:', error);
        // 降级到旧方案
        fallbackReadClipboard();
      }
    },
    // 可选：只在空网格时显示该菜单
    enabled: () => gridApi.getDisplayedRowCount() === 0
  }
];

兼容性降级方案 #

对于不支持 Clipboard API 的旧浏览器，可以用隐藏的 textarea 模拟粘贴：

function fallbackReadClipboard() {
  const textarea = document.createElement('textarea');
  document.body.appendChild(textarea);
  textarea.focus();
  // 执行粘贴命令
  document.execCommand('paste');
  const clipboardContent = textarea.value;
  document.body.removeChild(textarea);
  
  // 后续处理逻辑和上面一致
  const rowsToAdd = parseClipboardRows(clipboardContent);
  gridApi.applyTransaction({ add: rowsToAdd });
}

补充：剪贴板数据解析 #

通常剪贴板里的表格数据是按换行分隔行，按制表符分隔列，你可以写一个简单的解析函数：

function parseClipboardRows(text) {
  return text.split('\n').map(rowStr => {
    const columns = rowStr.split('\t');
    // 映射到你的列字段，比如 columns[0] 对应 name，columns[1] 对应 age 等
    return {
      name: columns[0],
      age: columns[1]
      // 其他字段...
    };
  }).filter(row => Object.values(row).some(val => val)); // 过滤空行
}

内容的提问来源于stack exchange，提问作者nagabandaru