Skip to content

Jitsi Meet - Secure, Simple and Scalable Video Conferences that you use as a standalone app or embed in your web application.

2.7 KB
Raw Blame
/**
 * Prefer keyboard handling of these elements over global shortcuts.
 * If a button is triggered using the Spacebar it should not trigger PTT.
 * If an input element is focused and M is pressed it should not mute audio.
 */
const _elementsBlacklist = [
    'input',
    'textarea',
    'button',
    '[role=button]',
    '[role=menuitem]',
    '[role=radio]',
    '[role=tab]',
    '[role=option]',
    '[role=switch]',
    '[role=range]',
    '[role=log]'
];

/**
* Returns the currently focused element if it is not blacklisted.
*
* @returns {HTMLElement|null} - The currently focused element.
*/
export const getPriorityFocusedElement = (): HTMLElement | null =>
    document.querySelector(`:focus:is(${_elementsBlacklist.join(',')})`);

export const getShortcutKey = (character: string, alt?: boolean, ctrl?: boolean): string => {
    if (ctrl && alt) {
        return `-:${character}`;
    } else if (alt) {
        return `:${character}`;
    } else if (ctrl) {
        return `-${character}`;
    }

    return character;
};

/**
* Returns the keyboard key from a KeyboardEvent.
*
* @param {KeyboardEvent} e - The KeyboardEvent.
* @returns {string} - The keyboard key.
*/
export const getKeyboardKey = (e: KeyboardEvent): string => {
    // @ts-ignore
    const { altKey, code, key, shiftKey, type, which, ctrlKey } = e;

    // If alt is pressed a different char can be returned so this takes
    // the char from the code. It also prefixes with a colon to differentiate
    // alt combo from simple keypress.

    const replacedKey = code.replace('Key', '');

    if (altKey) {
        return getShortcutKey(replacedKey, altKey, ctrlKey);
    }

    // If e.key is a string, then it is assumed it already plainly states
    // the key pressed. This may not be true in all cases, such as with Edge
    // and "?", when the browser cannot properly map a key press event to a
    // keyboard key. To be safe, when a key is "Unidentified" it must be
    // further analyzed by jitsi to a key using e.which.
    if (typeof key === 'string' && key !== 'Unidentified') {
        if (ctrlKey) {
            return getShortcutKey(key, false, ctrlKey);
        }

        if (code.startsWith('Key')) {
            return replacedKey;
        }

        return key;
    }

    if (type === 'keypress'
            && ((which >= 32 && which <= 126)
                || (which >= 160 && which <= 255))) {
        return String.fromCharCode(which);
    }

    // try to fallback (0-9A-Za-z and QWERTY keyboard)
    switch (which) {
    case 27:
        return 'Escape';
    case 191:
        return shiftKey ? '?' : '/';
    }

    if (shiftKey || type === 'keypress') {
        return String.fromCharCode(which);
    }

    return String.fromCharCode(which).toLowerCase();
};