keymap.js 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148
  1. import { flipCtrlCmd, mac, presto } from "../util/browser.js"
  2. import { map } from "../util/misc.js"
  3. import { keyNames } from "./keynames.js"
  4. export let keyMap = {}
  5. keyMap.basic = {
  6. "Left": "goCharLeft", "Right": "goCharRight", "Up": "goLineUp", "Down": "goLineDown",
  7. "End": "goLineEnd", "Home": "goLineStartSmart", "PageUp": "goPageUp", "PageDown": "goPageDown",
  8. "Delete": "delCharAfter", "Backspace": "delCharBefore", "Shift-Backspace": "delCharBefore",
  9. "Tab": "defaultTab", "Shift-Tab": "indentAuto",
  10. "Enter": "newlineAndIndent", "Insert": "toggleOverwrite",
  11. "Esc": "singleSelection"
  12. }
  13. // Note that the save and find-related commands aren't defined by
  14. // default. User code or addons can define them. Unknown commands
  15. // are simply ignored.
  16. keyMap.pcDefault = {
  17. "Ctrl-A": "selectAll", "Ctrl-D": "deleteLine", "Ctrl-Z": "undo", "Shift-Ctrl-Z": "redo", "Ctrl-Y": "redo",
  18. "Ctrl-Home": "goDocStart", "Ctrl-End": "goDocEnd", "Ctrl-Up": "goLineUp", "Ctrl-Down": "goLineDown",
  19. "Ctrl-Left": "goGroupLeft", "Ctrl-Right": "goGroupRight", "Alt-Left": "goLineStart", "Alt-Right": "goLineEnd",
  20. "Ctrl-Backspace": "delGroupBefore", "Ctrl-Delete": "delGroupAfter", "Ctrl-S": "save", "Ctrl-F": "find",
  21. "Ctrl-G": "findNext", "Shift-Ctrl-G": "findPrev", "Shift-Ctrl-F": "replace", "Shift-Ctrl-R": "replaceAll",
  22. "Ctrl-[": "indentLess", "Ctrl-]": "indentMore",
  23. "Ctrl-U": "undoSelection", "Shift-Ctrl-U": "redoSelection", "Alt-U": "redoSelection",
  24. "fallthrough": "basic"
  25. }
  26. // Very basic readline/emacs-style bindings, which are standard on Mac.
  27. keyMap.emacsy = {
  28. "Ctrl-F": "goCharRight", "Ctrl-B": "goCharLeft", "Ctrl-P": "goLineUp", "Ctrl-N": "goLineDown",
  29. "Alt-F": "goWordRight", "Alt-B": "goWordLeft", "Ctrl-A": "goLineStart", "Ctrl-E": "goLineEnd",
  30. "Ctrl-V": "goPageDown", "Shift-Ctrl-V": "goPageUp", "Ctrl-D": "delCharAfter", "Ctrl-H": "delCharBefore",
  31. "Alt-D": "delWordAfter", "Alt-Backspace": "delWordBefore", "Ctrl-K": "killLine", "Ctrl-T": "transposeChars",
  32. "Ctrl-O": "openLine"
  33. }
  34. keyMap.macDefault = {
  35. "Cmd-A": "selectAll", "Cmd-D": "deleteLine", "Cmd-Z": "undo", "Shift-Cmd-Z": "redo", "Cmd-Y": "redo",
  36. "Cmd-Home": "goDocStart", "Cmd-Up": "goDocStart", "Cmd-End": "goDocEnd", "Cmd-Down": "goDocEnd", "Alt-Left": "goGroupLeft",
  37. "Alt-Right": "goGroupRight", "Cmd-Left": "goLineLeft", "Cmd-Right": "goLineRight", "Alt-Backspace": "delGroupBefore",
  38. "Ctrl-Alt-Backspace": "delGroupAfter", "Alt-Delete": "delGroupAfter", "Cmd-S": "save", "Cmd-F": "find",
  39. "Cmd-G": "findNext", "Shift-Cmd-G": "findPrev", "Cmd-Alt-F": "replace", "Shift-Cmd-Alt-F": "replaceAll",
  40. "Cmd-[": "indentLess", "Cmd-]": "indentMore", "Cmd-Backspace": "delWrappedLineLeft", "Cmd-Delete": "delWrappedLineRight",
  41. "Cmd-U": "undoSelection", "Shift-Cmd-U": "redoSelection", "Ctrl-Up": "goDocStart", "Ctrl-Down": "goDocEnd",
  42. "fallthrough": ["basic", "emacsy"]
  43. }
  44. keyMap["default"] = mac ? keyMap.macDefault : keyMap.pcDefault
  45. // KEYMAP DISPATCH
  46. function normalizeKeyName(name) {
  47. let parts = name.split(/-(?!$)/)
  48. name = parts[parts.length - 1]
  49. let alt, ctrl, shift, cmd
  50. for (let i = 0; i < parts.length - 1; i++) {
  51. let mod = parts[i]
  52. if (/^(cmd|meta|m)$/i.test(mod)) cmd = true
  53. else if (/^a(lt)?$/i.test(mod)) alt = true
  54. else if (/^(c|ctrl|control)$/i.test(mod)) ctrl = true
  55. else if (/^s(hift)?$/i.test(mod)) shift = true
  56. else throw new Error("Unrecognized modifier name: " + mod)
  57. }
  58. if (alt) name = "Alt-" + name
  59. if (ctrl) name = "Ctrl-" + name
  60. if (cmd) name = "Cmd-" + name
  61. if (shift) name = "Shift-" + name
  62. return name
  63. }
  64. // This is a kludge to keep keymaps mostly working as raw objects
  65. // (backwards compatibility) while at the same time support features
  66. // like normalization and multi-stroke key bindings. It compiles a
  67. // new normalized keymap, and then updates the old object to reflect
  68. // this.
  69. export function normalizeKeyMap(keymap) {
  70. let copy = {}
  71. for (let keyname in keymap) if (keymap.hasOwnProperty(keyname)) {
  72. let value = keymap[keyname]
  73. if (/^(name|fallthrough|(de|at)tach)$/.test(keyname)) continue
  74. if (value == "...") { delete keymap[keyname]; continue }
  75. let keys = map(keyname.split(" "), normalizeKeyName)
  76. for (let i = 0; i < keys.length; i++) {
  77. let val, name
  78. if (i == keys.length - 1) {
  79. name = keys.join(" ")
  80. val = value
  81. } else {
  82. name = keys.slice(0, i + 1).join(" ")
  83. val = "..."
  84. }
  85. let prev = copy[name]
  86. if (!prev) copy[name] = val
  87. else if (prev != val) throw new Error("Inconsistent bindings for " + name)
  88. }
  89. delete keymap[keyname]
  90. }
  91. for (let prop in copy) keymap[prop] = copy[prop]
  92. return keymap
  93. }
  94. export function lookupKey(key, map, handle, context) {
  95. map = getKeyMap(map)
  96. let found = map.call ? map.call(key, context) : map[key]
  97. if (found === false) return "nothing"
  98. if (found === "...") return "multi"
  99. if (found != null && handle(found)) return "handled"
  100. if (map.fallthrough) {
  101. if (Object.prototype.toString.call(map.fallthrough) != "[object Array]")
  102. return lookupKey(key, map.fallthrough, handle, context)
  103. for (let i = 0; i < map.fallthrough.length; i++) {
  104. let result = lookupKey(key, map.fallthrough[i], handle, context)
  105. if (result) return result
  106. }
  107. }
  108. }
  109. // Modifier key presses don't count as 'real' key presses for the
  110. // purpose of keymap fallthrough.
  111. export function isModifierKey(value) {
  112. let name = typeof value == "string" ? value : keyNames[value.keyCode]
  113. return name == "Ctrl" || name == "Alt" || name == "Shift" || name == "Mod"
  114. }
  115. export function addModifierNames(name, event, noShift) {
  116. let base = name
  117. if (event.altKey && base != "Alt") name = "Alt-" + name
  118. if ((flipCtrlCmd ? event.metaKey : event.ctrlKey) && base != "Ctrl") name = "Ctrl-" + name
  119. if ((flipCtrlCmd ? event.ctrlKey : event.metaKey) && base != "Cmd") name = "Cmd-" + name
  120. if (!noShift && event.shiftKey && base != "Shift") name = "Shift-" + name
  121. return name
  122. }
  123. // Look up the name of a key as indicated by an event object.
  124. export function keyName(event, noShift) {
  125. if (presto && event.keyCode == 34 && event["char"]) return false
  126. let name = keyNames[event.keyCode]
  127. if (name == null || event.altGraphKey) return false
  128. // Ctrl-ScrollLock has keyCode 3, same as Ctrl-Pause,
  129. // so we'll use event.code when available (Chrome 48+, FF 38+, Safari 10.1+)
  130. if (event.keyCode == 3 && event.code) name = event.code
  131. return addModifierNames(name, event, noShift)
  132. }
  133. export function getKeyMap(val) {
  134. return typeof val == "string" ? keyMap[val] : val
  135. }