Blame toolkit/modules/ShortcutUtils.jsm

Packit f0b94e
/* This Source Code Form is subject to the terms of the Mozilla Public
Packit f0b94e
 * License, v. 2.0. If a copy of the MPL was not distributed with this
Packit f0b94e
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
Packit f0b94e
Packit f0b94e
"use strict";
Packit f0b94e
Packit f0b94e
var EXPORTED_SYMBOLS = ["ShortcutUtils"];
Packit f0b94e
Packit f0b94e
ChromeUtils.import("resource://gre/modules/Services.jsm");
Packit f0b94e
ChromeUtils.import("resource://gre/modules/XPCOMUtils.jsm");
Packit f0b94e
Packit f0b94e
XPCOMUtils.defineLazyGetter(this, "PlatformKeys", function() {
Packit f0b94e
  return Services.strings.createBundle(
Packit f0b94e
    "chrome://global-platform/locale/platformKeys.properties");
Packit f0b94e
});
Packit f0b94e
Packit f0b94e
XPCOMUtils.defineLazyGetter(this, "Keys", function() {
Packit f0b94e
  return Services.strings.createBundle(
Packit f0b94e
    "chrome://global/locale/keys.properties");
Packit f0b94e
});
Packit f0b94e
Packit f0b94e
var ShortcutUtils = {
Packit f0b94e
  /**
Packit f0b94e
    * Prettifies the modifier keys for an element.
Packit f0b94e
    *
Packit f0b94e
    * @param Node aElemKey
Packit f0b94e
    *        The key element to get the modifiers from.
Packit f0b94e
    * @param boolean aNoCloverLeaf
Packit f0b94e
    *        Pass true to use a descriptive string instead of the cloverleaf symbol. (OS X only)
Packit f0b94e
    * @return string
Packit f0b94e
    *         A prettified and properly separated modifier keys string.
Packit f0b94e
    */
Packit f0b94e
  prettifyShortcut(aElemKey, aNoCloverLeaf) {
Packit f0b94e
    let elemString = "";
Packit f0b94e
    let elemMod = aElemKey.getAttribute("modifiers");
Packit f0b94e
    let haveCloverLeaf = false;
Packit f0b94e
Packit f0b94e
    if (elemMod.match("accel")) {
Packit f0b94e
      if (Services.appinfo.OS == "Darwin") {
Packit f0b94e
        // XXX bug 779642 Use "Cmd-" literal vs. cloverleaf meta-key until
Packit f0b94e
        // Orion adds variable height lines.
Packit f0b94e
        if (aNoCloverLeaf) {
Packit f0b94e
          elemString += "Cmd-";
Packit f0b94e
        } else {
Packit f0b94e
          haveCloverLeaf = true;
Packit f0b94e
        }
Packit f0b94e
      } else {
Packit f0b94e
        elemString += PlatformKeys.GetStringFromName("VK_CONTROL") +
Packit f0b94e
          PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
      }
Packit f0b94e
    }
Packit f0b94e
    if (elemMod.match("access")) {
Packit f0b94e
      if (Services.appinfo.OS == "Darwin") {
Packit f0b94e
        elemString += PlatformKeys.GetStringFromName("VK_CONTROL") +
Packit f0b94e
          PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
      } else {
Packit f0b94e
        elemString += PlatformKeys.GetStringFromName("VK_ALT") +
Packit f0b94e
          PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
      }
Packit f0b94e
    }
Packit f0b94e
    if (elemMod.match("os")) {
Packit f0b94e
      elemString += PlatformKeys.GetStringFromName("VK_WIN") +
Packit f0b94e
        PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
    }
Packit f0b94e
    if (elemMod.match("shift")) {
Packit f0b94e
      elemString += PlatformKeys.GetStringFromName("VK_SHIFT") +
Packit f0b94e
        PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
    }
Packit f0b94e
    if (elemMod.match("alt")) {
Packit f0b94e
      elemString += PlatformKeys.GetStringFromName("VK_ALT") +
Packit f0b94e
        PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
    }
Packit f0b94e
    if (elemMod.match("ctrl") || elemMod.match("control")) {
Packit f0b94e
      elemString += PlatformKeys.GetStringFromName("VK_CONTROL") +
Packit f0b94e
        PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
    }
Packit f0b94e
    if (elemMod.match("meta")) {
Packit f0b94e
      elemString += PlatformKeys.GetStringFromName("VK_META") +
Packit f0b94e
        PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
    }
Packit f0b94e
Packit f0b94e
    if (haveCloverLeaf) {
Packit f0b94e
      elemString += PlatformKeys.GetStringFromName("VK_META") +
Packit f0b94e
        PlatformKeys.GetStringFromName("MODIFIER_SEPARATOR");
Packit f0b94e
    }
Packit f0b94e
Packit f0b94e
    let key;
Packit f0b94e
    let keyCode = aElemKey.getAttribute("keycode");
Packit f0b94e
    if (keyCode) {
Packit f0b94e
      keyCode = keyCode.toUpperCase();
Packit f0b94e
      try {
Packit f0b94e
        let bundle = keyCode == "VK_RETURN" ? PlatformKeys : Keys;
Packit f0b94e
        // Some keys might not exist in the locale file, which will throw.
Packit f0b94e
        key = bundle.GetStringFromName(keyCode);
Packit f0b94e
      } catch (ex) {
Packit f0b94e
        Cu.reportError("Error finding " + keyCode + ": " + ex);
Packit f0b94e
        key = keyCode.replace(/^VK_/, "");
Packit f0b94e
      }
Packit f0b94e
    } else {
Packit f0b94e
      key = aElemKey.getAttribute("key");
Packit f0b94e
      key = key.toUpperCase();
Packit f0b94e
    }
Packit f0b94e
    return elemString + key;
Packit f0b94e
  },
Packit f0b94e
Packit f0b94e
  findShortcut(aElemCommand) {
Packit f0b94e
    let document = aElemCommand.ownerDocument;
Packit f0b94e
    return document.querySelector("key[command=\"" + aElemCommand.getAttribute("id") + "\"]");
Packit f0b94e
  }
Packit f0b94e
};
Packit f0b94e
Packit f0b94e
Object.freeze(ShortcutUtils);
Packit f0b94e