blob: d9b8aeb81594ff12e9ec39e25cf989676b9fa738 (
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
goog.provide('cvox.ChromeVoxKbHandler');
goog.require('cvox.ChromeVox');
goog.require('cvox.ChromeVoxUserCommands');
goog.require('cvox.History');
goog.require('cvox.KeyMap');
goog.require('cvox.KeySequence');
goog.require('cvox.KeyUtil');
goog.require('cvox.KeyboardHelpWidget');
/**
* @fileoverview Handles user keyboard input events.
*
*/
cvox.ChromeVoxKbHandler = {};
/**
* The key map
*
* @type {cvox.KeyMap}
*/
cvox.ChromeVoxKbHandler.handlerKeyMap;
/**
* Loads the key bindings into the keyToFunctionsTable.
*
* @param {string} keyToFunctionsTable The key bindings table in JSON form.
*/
cvox.ChromeVoxKbHandler.loadKeyToFunctionsTable = function(
keyToFunctionsTable) {
if (!window.JSON) {
return;
}
cvox.ChromeVoxKbHandler.handlerKeyMap =
cvox.KeyMap.fromJSON(keyToFunctionsTable);
};
/**
* Converts the key bindings table into an array that is sorted by the lengths
* of the key bindings. After the sort, the key bindings that describe single
* keys will come before the key bindings that describe multiple keys.
* @param {Object<string>} keyToFunctionsTable Contains each key binding and its
* associated function name.
* @return {Array<Array<string>>} The sorted key bindings table in
* array form. Each entry in the array is itself an array containing the
* key binding and its associated function name.
* @private
*/
cvox.ChromeVoxKbHandler.sortKeyToFunctionsTable_ = function(
keyToFunctionsTable) {
var sortingArray = [];
for (var keySeqStr in keyToFunctionsTable) {
sortingArray.push([keySeqStr, keyToFunctionsTable[keySeqStr]]);
}
function compareKeyStr(a, b) {
// Compare the lengths of the key bindings.
if (a[0].length < b[0].length) {
return -1;
} else if (b[0].length < a[0].length) {
return 1;
} else {
// The keys are the same length. Sort lexicographically.
return a[0].localeCompare(b[0]);
}
};
sortingArray.sort(compareKeyStr);
return sortingArray;
};
/**
* Handles key down events.
*
* @param {Event} evt The key down event to process.
* @return {boolean} True if the default action should be performed.
*/
cvox.ChromeVoxKbHandler.basicKeyDownActionsListener = function(evt) {
var keySequence = cvox.KeyUtil.keyEventToKeySequence(evt);
var functionName;
if (cvox.ChromeVoxKbHandler.handlerKeyMap != undefined) {
functionName =
cvox.ChromeVoxKbHandler.handlerKeyMap.commandForKey(keySequence);
} else {
functionName = null;
}
// TODO (clchen): Disambiguate why functions are null. If the user pressed
// something that is not a valid combination, make an error noise so there
// is some feedback.
if (!functionName) {
return !cvox.KeyUtil.sequencing;
}
// If ChromeVox isn't active, ignore every command except the one
// to toggle ChromeVox active again.
if (!cvox.ChromeVox.isActive && functionName != 'toggleChromeVox') {
return true;
}
// This is the key event handler return value - true if the event should
// propagate and the default action should be performed, false if we eat
// the key.
var returnValue = true;
var func = cvox.ChromeVoxUserCommands.commands[functionName];
if (func) {
var history = cvox.History.getInstance();
history.enterUserCommand(functionName);
returnValue = func();
history.exitUserCommand(functionName);
} else if (keySequence.cvoxModifier) {
// Modifier/prefix is active -- prevent default action
returnValue = false;
}
// If the whole document is hidden from screen readers, let the app
// catch keys as well.
if (cvox.ChromeVox.entireDocumentIsHidden) {
returnValue = true;
}
return returnValue;
};
|