Skip to content

配置快捷键

sunsonliu edited this page Sep 3, 2024 · 3 revisions

注:

只在v0.8.47及以上版本中支持

new Cherry({
    toolbars: {
        shortcutKeySettings: {
            /** 是否替换已有的快捷键, true: 替换默认快捷键; false: 会追加到默认快捷键里,相同的shortcutKey会覆盖默认的 */
            isReplace: false,
            shortcutKeyMap: {
                'Alt-Digit0': {
                    hookName: 'fullScreen',
                    aliasName: '全屏',
                },
                'Control-Shift-KeyB': {
                    hookName: 'bold',
                    aliasName: '加粗',
                },
            },
        },
    }
});

支持的按键

Control、Shift、Alt、Meta、[a-z]、[0-9]

其中,字母[a-z]需要加上Key前缀;数字[0-9]需要加上Digit前缀

快捷键优先级

缓存的快捷键配置(用户变更) > 配置项传递的快捷键 > 系统默认快捷键

API更新快捷键

/**
 * 更新快捷键映射
 * @param {string} oldShortcutKey 旧的快捷键
 * @param {string} newShortcutKey 新的快捷键
 */
cherry.toolbar.updateShortcutKeyMap(oldShortcutKey, newShortcutKey)

例:

cherry.toolbar.updateShortcutKeyMap('Control-KeyB', 'Alt-KeyB')