@7polo/kityminder-core/src/core/shortcut.js

KityMinder Core Implement

/**
 * @fileOverview
 *
 * 添加快捷键支持
 *
 * @author: techird
 * @copyright: Baidu FEX, 2014
 */

define(function(require, exports, module) {
    var kity = require('./kity');
    var utils = require('./utils');
    var keymap = require('./keymap');
    var Minder = require('./minder');
    var MinderEvent = require('./event');

    /**
     * 计算包含 meta 键的 keycode
     *
     * @param  {String|KeyEvent} unknown
     */
    function getMetaKeyCode(unknown) {
        var CTRL_MASK = 0x1000;
        var ALT_MASK = 0x2000;
        var SHIFT_MASK = 0x4000;
        var metaKeyCode = 0;

        if (typeof(unknown) == 'string') {
            // unknown as string
            unknown.toLowerCase().split(/\+\s*/).forEach(function(name) {
                switch(name) {
                    case 'ctrl':
                    case 'cmd':
                        metaKeyCode |= CTRL_MASK;
                        break;
                    case 'alt':
                        metaKeyCode |= ALT_MASK;
                        break;
                    case 'shift':
                        metaKeyCode |= SHIFT_MASK;
                        break;
                    default:
                        metaKeyCode |= keymap[name];
                }
            });
        } else {
            // unknown as key event
            if (unknown.ctrlKey || unknown.metaKey) {
                metaKeyCode |= CTRL_MASK;
            }
            if (unknown.altKey) {
                metaKeyCode |= ALT_MASK;
            }
            if (unknown.shiftKey) {
                metaKeyCode |= SHIFT_MASK;
            }
            metaKeyCode |= unknown.keyCode;
        }

        return metaKeyCode;
    }
    kity.extendClass(MinderEvent, {
        isShortcutKey: function(keyCombine) {
            var keyEvent = this.originEvent;
            if (!keyEvent) return false;

            return getMetaKeyCode(keyCombine) == getMetaKeyCode(keyEvent);
        }
    });

    Minder.registerInitHook(function() {
        this._initShortcutKey();
    });

    kity.extendClass(Minder, {

        _initShortcutKey: function() {
            this._bindShortcutKeys();
        },

        _bindShortcutKeys: function() {
            var map = this._shortcutKeys = {};
            var has = 'hasOwnProperty';
            this.on('keydown', function(e) {
                for (var keys in map) {
                    if (!map[has](keys)) continue;
                    if (e.isShortcutKey(keys)) {
                        var fn = map[keys];
                        if (fn.__statusCondition && fn.__statusCondition != this.getStatus()) return;
                        fn();
                        e.preventDefault();
                    }
                }
            });
        },

        addShortcut: function(keys, fn) {
            var binds = this._shortcutKeys;
            keys.split(/\|\s*/).forEach(function(combine) {
                var parts = combine.split('::');
                var status;
                if (parts.length > 1) {
                    combine = parts[1];
                    status = parts[0];
                    fn.__statusCondition = status;
                }
                binds[combine] = fn;
            });
        },

        addCommandShortcutKeys: function(cmd, keys) {
            var binds = this._commandShortcutKeys || (this._commandShortcutKeys = {});
            var obj = {},
                km = this;
            if (keys) {
                obj[cmd] = keys;
            } else {
                obj = cmd;
            }

            var minder = this;

            utils.each(obj, function(keys, command) {

                binds[command] = keys;

                minder.addShortcut(keys, function execCommandByShortcut() {
                    /**
                     * 之前判断有问题，由 === 0 改为 !== -1
                     * @editor Naixor
                     * @Date 2015-12-2
                     */
                    if (minder.queryCommandState(command) !== -1) {
                        minder.execCommand(command);
                    }
                });
            });
        },

        getCommandShortcutKey: function(cmd) {
            var binds = this._commandShortcutKeys;
            return binds && binds[cmd] || null;
        },
        
        /**
         * @Desc: 添加一个判断是否支持原生Clipboard的变量，用于对ctrl + v和ctrl + c的处理
         * @Editor: Naixor
         * @Date: 2015.9.20
         */
        supportClipboardEvent: (function(window) {
            return !!window.ClipboardEvent;
        })(window)
    });
});