请求修改JS代码实现Excel Add-ins快捷键在任务窗格未激活时生效

你之前的代码思路存在错误：Excel单元格不属于任务窗格的DOM结构，document.getElementById('excelCell')根本无法获取到Excel的单元格元素，自然无法监听其键盘事件。要实现无论焦点在任务窗格还是Excel单元格都能触发的快捷键，需要使用Office JS提供的文档级键盘事件。

正确实现代码 #

Office.initialize = function () {
    // 注册文档级键盘按下事件
    Office.context.document.addHandlerAsync(
        Office.EventType.DocumentKeyDown,
        handleCustomShortcut,
        (result) => {
            if (result.status !== Office.AsyncResultStatus.Succeeded) {
                console.error(`注册快捷键失败: ${result.error.message}`);
            }
        }
    );
};

function handleCustomShortcut(eventArgs) {
    // 替换成你需要的快捷键组合，示例为Ctrl+K
    if (eventArgs.ctrlKey && eventArgs.key === 'k') {
        // 阻止Excel默认的Ctrl+K行为（插入超链接）
        eventArgs.preventDefault();

        // 这里编写你的自定义逻辑
        Excel.run(async (context) => {
            const activeSheet = context.workbook.worksheets.getActiveWorksheet();
            const selectedRange = activeSheet.getActiveRange();
            // 示例：给选中区域填充黄色背景
            selectedRange.format.fill.color = '#FFFF00';
            await context.sync();
        }).catch((error) => {
            console.error(`执行操作失败: ${error.message}`);
        });
    }
}

关键说明 #

• 事件注册时机：必须在Office.initialize回调内注册事件，确保Office JS环境已完全加载初始化。
• 文档级事件：DocumentKeyDown是Excel文档的全局事件，无论焦点在任务窗格还是Excel单元格编辑区域，只要当前文档处于激活状态，就会触发该事件。
• 快捷键判断：通过eventArgs对象的ctrlKey/altKey/shiftKey和key属性组合判断快捷键，注意key值为小写字母。
• 阻止默认行为：调用eventArgs.preventDefault()可以覆盖Excel原生的快捷键功能（按需使用）。

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