2 # Copyright Anton Khodakivskiy 2012, 2013.
3 # Copyright Simon Lydell 2013, 2014, 2015, 2016.
5 # This file is part of VimFx.
7 # VimFx is free software: you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation, either version 3 of the License, or
10 # (at your option) any later version.
12 # VimFx is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with VimFx. If not, see <http://www.gnu.org/licenses/>.
21 # This file defines the `vim` API, available to all modes and commands. There is
22 # one `Vim` instance for each tab. Most importantly, it provides access to the
23 # owning Firefox window and the current mode, and allows you to change mode.
24 # `vim` objects are exposed by the config file API. Underscored names are
25 # private and should not be used by API consumers.
27 messageManager = require('./message-manager')
28 ScrollableElements = require('./scrollable-elements')
29 statusPanel = require('./status-panel')
30 utils = require('./utils')
32 ChromeWindow = Ci.nsIDOMChromeWindow
35 constructor: (browser, @_parent) ->
38 @_setBrowser(browser, {addListeners: false})
43 Object.defineProperty(this, 'options', {
44 get: => @_parent.options
49 @_onLocationChange(@browser.currentURI.spec)
51 focusType = utils.getFocusType(utils.getActiveElement(@window))
52 @_setFocusType(focusType)
55 @_listen('vimMethod', ({method, args = []}, callback = null) =>
56 result = @[method](args...)
60 @_listen('vimMethodSync', ({method, args = []}) =>
61 return @[method](args...)
64 @_listen('locationChange', @_onLocationChange.bind(this))
66 @_listen('frameCanReceiveEvents', (value) =>
67 @_state.frameCanReceiveEvents = value
70 @_listen('focusType', (focusType) =>
71 # If the focus moves from a web page element to a browser UI element, the
72 # focus and blur events happen in the expected order, but the message from
73 # the frame script arrives too late. Therefore, check that the currently
74 # active element isn’t a browser UI element first.
75 unless @_isUIElement(utils.getActiveElement(@window))
76 @_setFocusType(focusType)
79 _setBrowser: (@browser, {addListeners = true} = {}) ->
80 @window = @browser.ownerGlobal
81 @_messageManager = @browser.messageManager
83 @_statusPanel?.remove()
84 @_statusPanel = statusPanel.injectStatusPanel(@browser)
85 @_statusPanel.onclick = @hideNotification.bind(this)
87 @_addListeners() if addListeners
91 frameCanReceiveEvents: false
92 scrollableElements: new ScrollableElements(@window)
95 _isBlacklisted: (url) -> @options.blacklist.some((regex) -> regex.test(url))
98 return not @_state.frameCanReceiveEvents or
99 @_isUIElement(event.originalTarget)
101 _isUIElement: (element) ->
102 # TODO: The `element.ownerGlobal` check will be redundant when
103 # non-multi-process is removed from Firefox.
104 return element.ownerGlobal instanceof ChromeWindow and
105 element != @window.gBrowser.selectedBrowser
107 # `args...` is passed to the mode's `onEnter` method.
108 enterMode: (mode, args...) ->
109 return if @mode == mode
111 unless utils.has(@_parent.modes, mode)
112 modes = Object.keys(@_parent.modes).join(', ')
114 "VimFx: Unknown mode. Available modes are: #{modes}. Got: #{mode}"
117 @_call('onLeave') if @mode?
119 result = @_call('onEnter', null, args...)
120 @_parent.emit('modeChange', {vim: this})
121 @_send('modeChange', {mode})
124 _consumeKeyEvent: (event) ->
125 return @_parent.consumeKeyEvent(event, this)
127 _onInput: (match, event) ->
128 uiEvent = if @isUIEvent(event) then event else false
129 suppress = @_call('onInput', {uiEvent, count: match.count}, match)
132 _onLocationChange: (url) ->
134 when @_isBlacklisted(url)
135 @enterMode('ignore', {type: 'blacklist'})
136 when (@mode == 'ignore' and @_storage.ignore.type == 'blacklist') or
139 @_parent.emit('locationChange', {vim: this, location: new @window.URL(url)})
141 _call: (method, data = {}, extraArgs...) ->
142 args = Object.assign({vim: this, storage: @_storage[@mode] ?= {}}, data)
143 currentMode = @_parent.modes[@mode]
144 return currentMode[method].call(currentMode, args, extraArgs...)
146 _run: (name, data = {}, callback = null) ->
147 @_send('runCommand', {name, data}, callback)
149 _messageManagerOptions: (options) ->
150 return Object.assign({
151 messageManager: @_messageManager
154 _listen: (name, listener, options = {}) ->
155 messageManager.listen(name, listener, @_messageManagerOptions(options))
157 _listenOnce: (name, listener, options = {}) ->
158 messageManager.listenOnce(name, listener, @_messageManagerOptions(options))
160 _send: (name, data, callback = null, options = {}) ->
161 messageManager.send(name, data, callback, @_messageManagerOptions(options))
164 @_parent.emit('notification', {vim: this, message})
165 if @options.notifications_enabled
166 @_statusPanel.setAttribute('label', message)
167 @_statusPanel.removeAttribute('inactive')
170 @_parent.emit('hideNotification', {vim: this})
171 @_statusPanel.setAttribute('inactive', 'true')
173 markPageInteraction: (value = null) -> @_send('markPageInteraction', value)
175 _focusMarkerElement: (elementIndex, options = {}) ->
176 # If you, for example, focus the location bar, unfocus it by pressing
177 # `<esc>` and then try to focus a link or text input in a web page the focus
178 # won’t work unless `@browser` is focused first.
180 @_run('focus_marker_element', {elementIndex, options})
182 _setFocusType: (@focusType) ->
184 when @focusType == 'ignore'
185 @enterMode('ignore', {type: 'focusType'})
186 when @mode == 'ignore' and @_storage.ignore.type == 'focusType'
188 when @mode == 'normal' and @focusType == 'findbar'
190 when @mode == 'find' and @focusType != 'findbar'
192 @_parent.emit('focusTypeChange', {vim: this})