extension/packages/commands.coffee

   1 utils     = require 'utils'
   2 help      = require 'help'
   3 find      = require 'find'
   4 find_link = require 'find-link'
   5 { _ }     = require 'l10n'
   6 { getPref
   7 , setPref
   8 , isPrefSet
   9 , getFirefoxPref } = require 'prefs'
  10
  11 { classes: Cc, interfaces: Ci, utils: Cu } = Components
  12
  13 # Open developer toolbar (Default shotrcut: Shift-F2)
  14 command_dev = (vim) ->
  15   if chromeWindow = utils.getRootWindow vim.window
  16     chromeWindow.DeveloperToolbar.show(true)
  17     chromeWindow.DeveloperToolbar.focus()
  18
  19 # Focus the Address Bar
  20 command_focus = (vim) ->
  21   if chromeWindow = utils.getRootWindow(vim.window)
  22     chromeWindow.focusAndSelectUrlBar()
  23
  24 # Focus the Search Bar
  25 command_focus_search = (vim) ->
  26   if chromeWindow = utils.getRootWindow(vim.window)
  27     if searchBar = chromeWindow.document.getElementById("searchbar")
  28       searchBar.select()
  29
  30 # Navigate to the address that is currently stored in the system clipboard
  31 command_paste = (vim) ->
  32   url = utils.readFromClipboard(vim.window)
  33   postData = null
  34   if not utils.isURL(url) and submission = utils.browserSearchSubmission(url)
  35     url = submission.uri.spec
  36     { postData } = submission
  37
  38   if chromeWindow = utils.getRootWindow(vim.window)
  39     chromeWindow.gBrowser.loadURIWithFlags(url, null, null, null, postData)
  40
  41 # Open new tab and navigate to the address that is currently stored in the system clipboard
  42 command_paste_tab = (vim) ->
  43   url = utils.readFromClipboard(vim.window)
  44   postData = null
  45   if not utils.isURL(url) and submission = utils.browserSearchSubmission(url)
  46     url = submission.uri.spec
  47     { postData } = submission
  48
  49   if chromeWindow = utils.getRootWindow vim.window
  50     chromeWindow.gBrowser.selectedTab = chromeWindow.gBrowser.addTab(url, null, null, postData, null, false)
  51
  52 # Open new tab and focus the address bar
  53 command_open_tab = (vim) ->
  54   if chromeWindow = utils.getRootWindow(vim.window)
  55     chromeWindow.BrowserOpenTab()
  56
  57 # Copy element URL to the clipboard
  58 command_marker_yank = (vim) ->
  59   callback = (marker) ->
  60     if url = marker.element.href
  61       marker.element.focus()
  62       utils.writeToClipboard(vim.window, url)
  63     else if utils.isTextInputElement(marker.element)
  64       utils.writeToClipboard(vim.window, marker.element.value)
  65
  66   vim.enterMode('hints', [callback])
  67
  68 # Focus element
  69 command_marker_focus = (vim) ->
  70   callback = (marker) -> marker.element.focus()
  71
  72   vim.enterMode('hints', [callback])
  73
  74 # Copy current URL to the clipboard
  75 command_yank = (vim) ->
  76   utils.writeToClipboard(vim.window, vim.window.location.toString())
  77
  78 # Reload the page, possibly from cache
  79 command_reload = (vim) ->
  80   vim.window.location.reload(false)
  81
  82 # Reload the page from the server
  83 command_reload_force = (vim) ->
  84   vim.window.location.reload(true)
  85
  86 # Reload the page, possibly from cache
  87 command_reload_all = (vim) ->
  88   if rootWindow = utils.getRootWindow(vim.window)
  89     if tabs = rootWindow.gBrowser.tabContainer
  90       for i in [0...tabs.itemCount]
  91         window = tabs.getItemAtIndex(i).linkedBrowser.contentWindow
  92         window.location.reload(false)
  93
  94 # Reload the page from the server
  95 command_reload_all_force = (vim) ->
  96   if rootWindow = utils.getRootWindow(vim.window)
  97     if tabs = rootWindow.gBrowser.tabContainer
  98       for i in [0...tabs.itemCount]
  99         window = tabs.getItemAtIndex(i).linkedBrowser.contentWindow
 100         window.location.reload(true)
 101
 102 command_stop = (vim) ->
 103   vim.window.stop()
 104
 105 command_stop_all = (vim) ->
 106   if rootWindow = utils.getRootWindow(vim.window)
 107     if tabs = rootWindow.gBrowser.tabContainer
 108       for i in [0...tabs.itemCount]
 109         window = tabs.getItemAtIndex(i).linkedBrowser.contentWindow
 110         window.stop()
 111
 112 # Scroll to the top of the page
 113 command_scroll_to_top = (vim) ->
 114   for i in [0...1000]
 115     utils.simulateWheel(vim.window, 0, -1, utils.WHEEL_MODE_PAGE)
 116
 117 # Scroll to the bottom of the page
 118 command_scroll_to_bottom = (vim) ->
 119   for i in [0...1000]
 120     utils.simulateWheel(vim.window, 0, 1, utils.WHEEL_MODE_PAGE)
 121
 122 # Scroll down a bit
 123 command_scroll_down = (vim) ->
 124   utils.simulateWheel(vim.window, 0, getPref('scroll_step_lines'), utils.WHEEL_MODE_LINE)
 125
 126 # Scroll up a bit
 127 command_scroll_up = (vim) ->
 128   utils.simulateWheel(vim.window, 0, -getPref('scroll_step_lines'), utils.WHEEL_MODE_LINE)
 129
 130 # Scroll left a bit
 131 command_scroll_left = (vim) ->
 132   utils.simulateWheel(vim.window, -getPref('scroll_step_lines'), 0, utils.WHEEL_MODE_LINE)
 133
 134 # Scroll right a bit
 135 command_scroll_right = (vim) ->
 136   utils.simulateWheel(vim.window, getPref('scroll_step_lines'), 0, utils.WHEEL_MODE_LINE)
 137
 138 # Scroll down half a page
 139 command_scroll_half_page_down = (vim) ->
 140   utils.simulateWheel(vim.window, 0, 0.5, utils.WHEEL_MODE_PAGE)
 141
 142 # Scroll up half a page
 143 command_scroll_half_page_up = (vim) ->
 144   utils.simulateWheel(vim.window, 0, -0.5, utils.WHEEL_MODE_PAGE)
 145
 146 # Scroll down full a page
 147 command_scroll_page_down = (vim) ->
 148   utils.simulateWheel(vim.window, 0, 1, utils.WHEEL_MODE_PAGE)
 149
 150 # Scroll up full a page
 151 command_scroll_page_up = (vim) ->
 152   utils.simulateWheel(vim.window, 0, -1, utils.WHEEL_MODE_PAGE)
 153
 154 # Activate previous tab
 155 command_tab_prev = (vim) ->
 156   if rootWindow = utils.getRootWindow(vim.window)
 157     rootWindow.gBrowser.tabContainer.advanceSelectedTab(-1, true)
 158
 159 # Activate next tab
 160 command_tab_next = (vim) ->
 161   if rootWindow = utils.getRootWindow(vim.window)
 162     rootWindow.gBrowser.tabContainer.advanceSelectedTab(1, true)
 163
 164 command_home = (vim) ->
 165   url = getFirefoxPref('browser.startup.homepage')
 166   if chromeWindow = utils.getRootWindow(vim.window)
 167     chromeWindow.gBrowser.loadURIWithFlags(url, null, null, null, null)
 168
 169 # Go to the first tab
 170 command_tab_first = (vim) ->
 171   if rootWindow = utils.getRootWindow(vim.window)
 172     rootWindow.gBrowser.tabContainer.selectedIndex = 0
 173
 174 # Go to the last tab
 175 command_tab_last = (vim) ->
 176   if rootWindow = utils.getRootWindow(vim.window)
 177     itemCount = rootWindow.gBrowser.tabContainer.itemCount
 178     rootWindow.gBrowser.tabContainer.selectedIndex = itemCount - 1
 179
 180 # Go back in history
 181 command_back = (vim) ->
 182   vim.window.history.back()
 183
 184 # Go forward in history
 185 command_forward = (vim) ->
 186   vim.window.history.forward()
 187
 188 # Close current tab
 189 command_close_tab = (vim) ->
 190   if rootWindow = utils.getRootWindow(vim.window)
 191     unless rootWindow.gBrowser.selectedTab.pinned
 192       rootWindow.gBrowser.removeCurrentTab()
 193
 194 # Restore last closed tab
 195 command_restore_tab = (vim) ->
 196   if rootWindow = utils.getRootWindow(vim.window)
 197     ss = utils.getSessionStore()
 198     if ss and ss.getClosedTabCount(rootWindow) > 0
 199       ss.undoCloseTab(rootWindow, 0)
 200
 201 helper_follow = ({ inTab, multiple }, vim) ->
 202   callback = (matchedMarker, markers) ->
 203     matchedMarker.element.focus()
 204     utils.simulateClick(matchedMarker.element, {metaKey: inTab, ctrlKey: inTab})
 205     isEditable = utils.isElementEditable(matchedMarker.element)
 206     if multiple and not isEditable
 207       # By not resetting immediately one is able to see the last char being matched, which gives
 208       # some nice visual feedback that you've typed the right char.
 209       vim.window.setTimeout((-> marker.reset() for marker in markers), 100)
 210       return true
 211
 212   vim.enterMode('hints', [callback])
 213
 214 # Follow links with hint markers
 215 command_follow = helper_follow.bind(undefined, {inTab: false})
 216
 217 # Follow links in a new Tab with hint markers
 218 command_follow_in_tab = helper_follow.bind(undefined, {inTab: true})
 219
 220 # Follow multiple links with hint markers
 221 command_follow_multiple = helper_follow.bind(undefined, {inTab: true, multiple: true})
 222
 223 # TODO : move these patterns to settings
 224 #
 225 # NOTE : If a page contains both a single angle-bracket link and a double angle-bracket link, then in
 226 # most cases the single bracket link will be "prev/next page" and the double bracket link will be
 227 # "first/last page", so we put the single bracket first in the pattern string so that it gets searched
 228 # for first.
 229 #
 230 # "\bprev\b,\bprevious\b,\bback\b,<,←,«,≪,<<"
 231 previousPatterns = "prev,previous,back,<,\u2190,\xab,\u226a,<<"
 232 # "\bnext\b,\bmore\b,>,→,»,≫,>>"
 233 nextPatterns = "next,more,>,\u2192,\xbb,\u226b,>>"
 234
 235 # Follow previous page
 236 command_follow_prev = (vim) ->
 237   #previousPatterns = getPref('previous_link_patterns') || ""
 238   previousStrings = previousPatterns.split(",").filter( (s) -> s.trim().length )
 239   link = find_link.find vim.window.document, "prev", previousStrings
 240   utils.simulateClick(link, {metaKey: false, ctrlKey: false}) if link
 241
 242 # Follow next page
 243 command_follow_next = (vim) ->
 244   #nextPatterns = getPref('next_link_patterns') || ""
 245   nextStrings = nextPatterns.split(",").filter( (s) -> s.trim().length )
 246   link = find_link.find vim.window.document, "next", nextStrings
 247   utils.simulateClick(link, {metaKey: false, ctrlKey: false}) if link
 248
 249 # Move current tab to the left
 250 command_tab_move_left = (vim) ->
 251   if gBrowser = utils.getRootWindow(vim.window)?.gBrowser
 252     if tab = gBrowser.selectedTab
 253       index = gBrowser.tabContainer.selectedIndex
 254       total = gBrowser.tabContainer.itemCount
 255
 256       # `total` is added to deal with negative offset
 257       gBrowser.moveTabTo(tab, (total + index - 1) % total)
 258
 259 # Move current tab to the right
 260 command_tab_move_right = (vim) ->
 261   if gBrowser = utils.getRootWindow(vim.window)?.gBrowser
 262     if tab = gBrowser.selectedTab
 263       index = gBrowser.tabContainer.selectedIndex
 264       total = gBrowser.tabContainer.itemCount
 265
 266       gBrowser.moveTabTo(tab, (index + 1) % total)
 267
 268 # Display the Help Dialog
 269 command_help = (vim) ->
 270   help.injectHelp(vim.window.document, commands)
 271
 272 find.findStr = ''
 273
 274 # Switch into find mode
 275 command_find = (vim, storage) ->
 276   find.injectFind vim.window.document, (findStr, startFindRng) ->
 277     # Reset region and find string if new find stirng has arrived
 278     if find.findStr != findStr
 279       [find.findStr, storage.findRng] = [findStr, startFindRng]
 280     # Perform forward find and store found region
 281     return storage.findRng = find.find(vim.window, find.findStr, storage.findRng, find.DIRECTION_FORWARDS)
 282
 283 # Switch into find mode with highlighting
 284 command_find_hl = (vim, storage) ->
 285   find.injectFind vim.window.document, (findStr) ->
 286     # Reset region and find string if new find stirng has arrived
 287     return find.highlight(vim.window, findStr)
 288
 289 # Search for the last pattern
 290 command_find_next = (vim, storage) ->
 291   if find.findStr.length > 0
 292     storage.findRng = find.find(vim.window, find.findStr, storage.findRng, find.DIRECTION_FORWARDS, true)
 293
 294 # Search for the last pattern backwards
 295 command_find_prev = (vim, storage) ->
 296   if find.findStr.length > 0
 297     storage.findRng = find.find(vim.window, find.findStr, storage.findRng, find.DIRECTION_BACKWARDS, true)
 298
 299 command_insert_mode = (vim) ->
 300   vim.enterMode('insert')
 301
 302 command_Esc = (vim, storage, event) ->
 303   utils.blurActiveElement(vim.window)
 304
 305   # Blur active XUL control
 306   callback = -> event.originalTarget?.ownerDocument?.activeElement?.blur()
 307   vim.window.setTimeout(callback, 0)
 308
 309   find.removeFind(vim.window.document)
 310
 311   help.removeHelp(vim.window.document)
 312
 313   if rootWindow = utils.getRootWindow(vim.window)
 314     rootWindow.DeveloperToolbar.hide()
 315
 316
 317 class Command
 318   constructor: (@group, @name, @func, keys) ->
 319     @defaultKeys = keys
 320     if isPrefSet(@prefName('keys'))
 321       try @keyValues = JSON.parse(getPref(@prefName('keys')))
 322     else
 323       @keyValues = keys
 324
 325   # Name of the preference for a given property
 326   prefName: (value) -> "commands.#{ @name }.#{ value }"
 327
 328   keys: (value) ->
 329     if value is undefined
 330       return @keyValues
 331     else
 332       @keyValues = value or @defaultKeyValues
 333       setPref(@prefName('keys'), value and JSON.stringify(value))
 334
 335   help: -> _("help_command_#{ @name }")
 336
 337 commands = [
 338   new Command('urls',   'focus',                  command_focus,                  ['o'])
 339   new Command('urls',   'focus_search',           command_focus_search,           ['O'])
 340   new Command('urls',   'paste',                  command_paste,                  ['p'])
 341   new Command('urls',   'paste_tab',              command_paste_tab,              ['P'])
 342   new Command('urls',   'marker_yank',            command_marker_yank,            ['y,f'])
 343   new Command('urls',   'marker_focus',           command_marker_focus,           ['v,f'])
 344   new Command('urls',   'yank',                   command_yank,                   ['y,y'])
 345   new Command('urls',   'reload',                 command_reload,                 ['r'])
 346   new Command('urls',   'reload_force',           command_reload_force,           ['R'])
 347   new Command('urls',   'reload_all',             command_reload_all,             ['a,r'])
 348   new Command('urls',   'reload_all_force',       command_reload_all_force,       ['a,R'])
 349   new Command('urls',   'stop',                   command_stop,                   ['s'])
 350   new Command('urls',   'stop_all',               command_stop_all,               ['a,s'])
 351
 352   new Command('nav',    'scroll_to_top',          command_scroll_to_top ,         ['g,g'])
 353   new Command('nav',    'scroll_to_bottom',       command_scroll_to_bottom,       ['G'])
 354   new Command('nav',    'scroll_down',            command_scroll_down,            ['j', 'c-e'])
 355   new Command('nav',    'scroll_up',              command_scroll_up,              ['k', 'c-y'])
 356   new Command('nav',    'scroll_left',            command_scroll_left,            ['h'])
 357   new Command('nav',    'scroll_right',           command_scroll_right ,          ['l'])
 358   new Command('nav',    'scroll_half_page_down',  command_scroll_half_page_down,  ['d'])
 359   new Command('nav',    'scroll_half_page_up',    command_scroll_half_page_up,    ['u'])
 360   new Command('nav',    'scroll_page_down',       command_scroll_page_down,       ['c-f'])
 361   new Command('nav',    'scroll_page_up',         command_scroll_page_up,         ['c-b'])
 362
 363   new Command('tabs',   'open_tab',               command_open_tab,               ['t'])
 364   new Command('tabs',   'tab_prev',               command_tab_prev,               ['J', 'g,T'])
 365   new Command('tabs',   'tab_next',               command_tab_next,               ['K', 'g,t'])
 366   new Command('tabs',   'tab_move_left',          command_tab_move_left,          ['c-J'])
 367   new Command('tabs',   'tab_move_right',         command_tab_move_right,         ['c-K'])
 368   new Command('tabs',   'home',                   command_home,                   ['g,h'])
 369   new Command('tabs',   'tab_first',              command_tab_first,              ['g,H', 'g,^'])
 370   new Command('tabs',   'tab_last',               command_tab_last,               ['g,L', 'g,$'])
 371   new Command('tabs',   'close_tab',              command_close_tab,              ['x'])
 372   new Command('tabs',   'restore_tab',            command_restore_tab,            ['X'])
 373
 374   new Command('browse', 'follow',                 command_follow,                 ['f'])
 375   new Command('browse', 'follow_in_tab',          command_follow_in_tab,          ['F'])
 376   new Command('browse', 'follow_multiple',        command_follow_multiple,        ['a,f'])
 377   new Command('browse', 'follow_previous',        command_follow_prev,            ['['])
 378   new Command('browse', 'follow_next',            command_follow_next,            [']'])
 379   new Command('browse', 'back',                   command_back,                   ['H'])
 380   new Command('browse', 'forward',                command_forward,                ['L'])
 381
 382   new Command('misc',   'find',                   command_find,                   ['/'])
 383   new Command('misc',   'find_hl',                command_find_hl,                ['a,/'])
 384   new Command('misc',   'find_next',              command_find_next,              ['n'])
 385   new Command('misc',   'find_prev',              command_find_prev,              ['N'])
 386   new Command('misc',   'insert_mode',            command_insert_mode,            ['i'])
 387   new Command('misc',   'help',                   command_help,                   ['?'])
 388   new Command('misc',   'dev',                    command_dev,                    [':'])
 389
 390   escapeCommand =
 391   new Command('misc',   'Esc',                    command_Esc,                    ['Esc'])
 392 ]
 393
 394 searchForMatchingCommand = (keys) ->
 395   for index in [0...keys.length] by 1
 396     str = keys[index..].join(',')
 397     for command in commands
 398       for key in command.keys()
 399         if key.startsWith(str)
 400           return {match: true, exact: (key == str), command}
 401
 402   return {match: false}
 403
 404 isEscCommandKey = (keyStr) -> keyStr in escapeCommand.keys()
 405
 406 exports.commands                  = commands
 407 exports.searchForMatchingCommand  = searchForMatchingCommand
 408 exports.isEscCommandKey           = isEscCommandKey