Electron Kiosk模式无法阻止F11、Alt+Tab等快捷键的问题咨询

Electron 默认的 kiosk: true 配置仅能实现窗口全屏锁定，但无法拦截系统级快捷键（如 Alt+Tab、Win 键）或部分浏览器级快捷键（如 F11、Alt+F4）——这些快捷键属于操作系统或 Chromium 内核的默认行为，基础 Kiosk 模式不会自动屏蔽。

要实现真正的 Kiosk 锁定，需要从窗口配置、网页内快捷键拦截、全局系统快捷键拦截三个层面处理：

1. 强化窗口基础配置 #

创建窗口时添加额外参数，禁用系统菜单、窗口边框，避免用户通过界面操作退出：

const { app, BrowserWindow, globalShortcut } = require('electron');
let win;

app.whenReady().then(() => {
  createWindow();
  registerGlobalShortcuts();
});

function createWindow() {
  win = new BrowserWindow({
    kiosk: true,
    fullscreen: true, // 配合kiosk模式强化全屏锁定
    frame: false, // 移除窗口边框和标题栏
    menu: null, // 禁用系统菜单
    disableAutoHideCursor: true, // 可选：保持光标可见，适配工厂操作场景
    webPreferences: {
      nodeIntegration: true, // 根据Angular项目需求调整，如需Node API则开启
      contextIsolation: false // 配合nodeIntegration使用
    }
  });

  win.loadURL(`file://${__dirname}/dist/index.html`);

  interceptWebContentsShortcuts();

  // 阻止窗口被关闭
  win.on('close', (event) => {
    if (win.kiosk) {
      event.preventDefault(); // Kiosk模式下禁止关闭窗口
    }
  });

  win.on('closed', () => {
    win = null;
  });
}

2. 拦截网页内快捷键 #

通过 webContents 的 before-input-event 事件，屏蔽网页层面的快捷键：

function interceptWebContentsShortcuts() {
  win.webContents.on('before-input-event', (event, input) => {
    // 定义需要屏蔽的快捷键组合
    const forbiddenShortcuts = [
      { key: 'F11' },
      { key: 'F4', modifiers: ['alt'] },
      { key: 'Escape' },
      { key: 'Tab', modifiers: ['alt'] }
    ];

    // 匹配是否触发了禁用的快捷键
    const isForbidden = forbiddenShortcuts.some(shortcut => {
      const keyMatch = input.key === shortcut.key;
      const modifiersMatch = !shortcut.modifiers || 
        shortcut.modifiers.every(mod => input.modifiers.includes(mod));
      return keyMatch && modifiersMatch;
    });

    if (isForbidden) {
      event.preventDefault(); // 阻止快捷键生效
    }
  });
}

3. 全局拦截系统级快捷键 #

使用 globalShortcut 注册全局快捷键拦截，屏蔽系统层面的切换操作：

function registerGlobalShortcuts() {
  // 屏蔽Windows系统快捷键（根据目标平台调整）
  globalShortcut.register('Alt+Tab', () => {});
  globalShortcut.register('Super', () => {}); // Win键
  globalShortcut.register('Super+Tab', () => {});
  globalShortcut.register('Super+D', () => {}); // 显示桌面快捷键
}

// 应用退出时注销全局快捷键，避免残留
app.on('will-quit', () => {
  globalShortcut.unregisterAll();
});

额外注意事项 #

• Windows 权限：部分系统快捷键（如 Win 键）需要应用以管理员权限运行才能完全拦截。
• 退出机制：建议添加隐藏的退出触发方式（如特定密码输入、专用USB触发），方便维护人员退出Kiosk模式。
• 跨平台适配：macOS/Linux的系统快捷键不同，需根据目标平台调整globalShortcut的注册项。

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