blob: 718bee9dc4d8f56257d2802d8919d22c1a1d6941 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
root = exports ? window
class HandlerStack
constructor: ->
@stack = []
@counter = 0
# A handler should return this value to immediately discontinue bubbling and pass the event on to the
# underlying page.
@stopBubblingAndTrue = new Object()
# A handler should return this value to indicate that the event has been consumed, and no further
# processing should take place.
@stopBubblingAndFalse = new Object()
# Adds a handler to the top of the stack. Returns a unique ID for that handler that can be used to remove it
# later.
push: (handler) ->
@stack.push handler
handler.id = ++@counter
# Adds a handler to the bottom of the stack. Returns a unique ID for that handler that can be used to remove
# it later.
unshift: (handler) ->
@stack.unshift handler
handler.id = ++@counter
# Called whenever we receive a key or other event. Each individual handler has the option to stop the
# event's propagation by returning a falsy value, or stop bubbling by returning @stopBubblingAndFalse or
# @stopBubblingAndTrue.
bubbleEvent: (type, event) ->
# extra is passed to each handler. This allows handlers to pass information down the stack.
extra = {}
# We take a copy of the array, here, in order to avoid interference from concurrent removes (for example,
# to avoid calling the same handler twice).
for handler in @stack[..].reverse()
# A handler may have been removed (handler.id == null).
if handler and handler.id
@currentId = handler.id
# A handler can register a handler for type "all", which will be invoked on all events. Such an "all"
# handler will be invoked first.
for func in [ handler.all, handler[type] ]
if func
passThrough = func.call @, event, extra
if not passThrough
DomUtils.suppressEvent(event) if @isChromeEvent event
return false
return true if passThrough == @stopBubblingAndTrue
return false if passThrough == @stopBubblingAndFalse
true
remove: (id = @currentId) ->
for i in [(@stack.length - 1)..0] by -1
handler = @stack[i]
if handler.id == id
handler.id = null
@stack.splice(i, 1)
break
# The handler stack handles chrome events (which may need to be suppressed) and internal (fake) events.
# This checks whether that the event at hand is a chrome event.
isChromeEvent: (event) ->
event?.preventDefault? and event?.stopImmediatePropagation?
# Convenience wrappers.
alwaysContinueBubbling: (handler) ->
handler()
true
neverContinueBubbling: (handler) ->
handler()
false
root.HandlerStack = HandlerStack
root.handlerStack = new HandlerStack
|
