如何在React+TypeScript版PowerPoint Add-in中逐单元格提取表格文本？

核心问题在于原逻辑直接获取选中区域的全部文本，未区分表格单元格结构。需要通过Office.js API识别表格选中状态，逐个提取单元格文本并单独翻译，再精准插回对应单元格。

1. 替换选中内容获取函数 #

替换原Getslectedbodytext，实现表格与普通形状的区分处理：

// 新的选中内容获取函数，支持区分表格单元格和普通文本
const getSelectedContent = async (callback: (content: Array<{text: string, range: Office.Range}>) => void) => {
  try {
    // 先尝试获取表格类型的选中内容
    await Office.context.document.getSelectedDataAsync(Office.CoercionType.Table, async (tableResult) => {
      if (tableResult.status === Office.AsyncResultStatus.Succeeded && tableResult.value) {
        const table = tableResult.value;
        const cellContents: Array<{text: string, range: Office.Range}> = [];
        
        // 遍历表格的每一行和每个单元格
        for (let rowIdx = 0; rowIdx < table.rows.length; rowIdx++) {
          const row = table.rows[rowIdx];
          for (let cellIdx = 0; cellIdx < row.cells.length; cellIdx++) {
            const cell = row.cells[cellIdx];
            cellContents.push({
              text: cell.text,
              range: cell.getRange() // 保存单元格范围，用于后续替换文本
            });
          }
        }
        callback(cellContents);
        return;
      }

      // 非表格情况，获取普通文本范围
      await Office.context.document.getSelectedDataAsync(Office.CoercionType.Text, (textResult) => {
        if (textResult.status === Office.AsyncResultStatus.Succeeded && textResult.value) {
          callback([{text: textResult.value, range: null}]);
        } else {
          callback([]);
        }
      });
    });
  } catch (error) {
    console.error('获取选中内容失败:', error);
    callback([]);
  }
};

2. 修改翻译与插入逻辑 #

更新handleFetchData支持批量处理单元格，并行翻译后精准插回：

// 批量处理每个单元格的翻译与插入
const handleFetchData = async (sourceLang: string, targetLang: string, contents: Array<{text: string, range: Office.Range}>) => {
  setLoading(true);
  try {
    // 并行翻译所有单元格文本，提升效率
    const translationTasks = contents.map(async (item) => {
      if (!item.text.trim()) return {...item, translation: ''};
      const translation = await fetchTranslation(sourceLang, targetLang, item.text);
      return {...item, translation};
    });

    const translatedResults = await Promise.all(translationTasks);
    
    // 逐个将翻译结果插入对应位置
    for (const result of translatedResults) {
      if (result.range) {
        // 表格单元格：直接通过Range对象设置文本
        await result.range.setSelectedDataAsync(result.translation, {
          coercionType: Office.CoercionType.Text
        });
      } else {
        // 普通形状文本：沿用原有插入逻辑
        insertProcessedText(result.translation);
      }
    }

    // 重置语言选择下拉框
    setSourceLanguage('');
    setTargetLanguage('');
  } catch (error) {
    console.error('翻译或插入操作失败:', error);
  } finally {
    setLoading(false);
  }
};

3. 更新选中触发函数 #

修改handleGetSelection调用新的获取函数：

const handleGetSelection = () => {
  getSelectedContent((contents) => {
    // 检查是否有有效文本
    const hasValidText = contents.some(item => item.text.trim());
    if (!hasValidText) {
      toast.error('未选中有效文本！');
      return;
    }

    // 若需要展示选中文本，可按需处理（比如拼接表格单元格文本）
    // setSelectedText(contents.map(item => item.text).join('\n'));
    
    handleFetchData(sourceLanguage, targetLanguage, contents);
  });
};

关键说明 #

• 表格识别：通过Office.CoercionType.Table先尝试获取选中内容，判断是否为表格结构。
• 精准替换：保存每个单元格的Range对象，翻译完成后直接对该范围设置文本，避免合并问题。
• 并行处理：使用Promise.all并行翻译所有单元格文本，减少等待时间。

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