| OLD | NEW |
| 1 <!doctype html> | 1 <!doctype html> |
| 2 <!-- | 2 <!-- |
| 3 @license | 3 @license |
| 4 Copyright (c) 2015 The Polymer Project Authors. All rights reserved. | 4 Copyright (c) 2015 The Polymer Project Authors. All rights reserved. |
| 5 This code may only be used under the BSD style license found at http://polymer.g
ithub.io/LICENSE.txt | 5 This code may only be used under the BSD style license found at http://polymer.g
ithub.io/LICENSE.txt |
| 6 The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt | 6 The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt |
| 7 The complete set of contributors may be found at http://polymer.github.io/CONTRI
BUTORS.txt | 7 The complete set of contributors may be found at http://polymer.github.io/CONTRI
BUTORS.txt |
| 8 Code distributed by Google as part of the polymer project is also | 8 Code distributed by Google as part of the polymer project is also |
| 9 subject to an additional IP rights grant found at http://polymer.github.io/PATEN
TS.txt | 9 subject to an additional IP rights grant found at http://polymer.github.io/PATEN
TS.txt |
| 10 --> | 10 --> |
| 11 <html> | 11 <html> |
| 12 <head> | 12 <head> |
| 13 <meta charset="UTF-8"> | 13 <meta charset="UTF-8"> |
| 14 <meta name="viewport" content="width=device-width, minimum-scale=1.0, initial-
scale=1.0, user-scalable=yes"> | 14 <meta name="viewport" content="width=device-width, minimum-scale=1.0, initial-
scale=1.0, user-scalable=yes"> |
| 15 <title>iron-a11y-keys</title> | 15 <title>iron-a11y-keys</title> |
| 16 | 16 |
| 17 <script src="../../webcomponentsjs/webcomponents-lite.js"></script> | 17 <script src="../../webcomponentsjs/webcomponents-lite.js"></script> |
| 18 <script src="../../web-component-tester/browser.js"></script> | 18 <script src="../../web-component-tester/browser.js"></script> |
| 19 <script src="../../test-fixture/test-fixture-mocha.js"></script> | |
| 20 <script src="../../iron-test-helpers/mock-interactions.js"></script> | 19 <script src="../../iron-test-helpers/mock-interactions.js"></script> |
| 21 | 20 |
| 22 <link rel="import" href="../../polymer/polymer.html"> | 21 <link rel="import" href="../../polymer/polymer.html"> |
| 23 <link rel="import" href="../../test-fixture/test-fixture.html"> | |
| 24 <link rel="import" href="../iron-a11y-keys-behavior.html"> | 22 <link rel="import" href="../iron-a11y-keys-behavior.html"> |
| 25 </head> | 23 </head> |
| 26 <body> | 24 <body> |
| 27 <test-fixture id="BasicKeys"> | 25 <test-fixture id="BasicKeys"> |
| 28 <template> | 26 <template> |
| 29 <x-a11y-basic-keys></x-a11y-basic-keys> | 27 <x-a11y-basic-keys></x-a11y-basic-keys> |
| 30 </template> | 28 </template> |
| 31 </test-fixture> | 29 </test-fixture> |
| 32 | 30 |
| 31 <test-fixture id="NonPropagatingKeys"> |
| 32 <template> |
| 33 <x-a11y-basic-keys stop-keyboard-event-propagation></x-a11y-basic-keys> |
| 34 </template> |
| 35 </test-fixture> |
| 36 |
| 33 <test-fixture id="ComboKeys"> | 37 <test-fixture id="ComboKeys"> |
| 34 <template> | 38 <template> |
| 35 <x-a11y-combo-keys></x-a11y-combo-keys> | 39 <x-a11y-combo-keys></x-a11y-combo-keys> |
| 36 </template> | 40 </template> |
| 37 </test-fixture> | 41 </test-fixture> |
| 38 | 42 |
| 39 <test-fixture id="AlternativeEventKeys"> | 43 <test-fixture id="AlternativeEventKeys"> |
| 40 <template> | 44 <template> |
| 41 <x-a11y-alternate-event-keys></x-a11y-alternate-event-keys> | 45 <x-a11y-alternate-event-keys></x-a11y-alternate-event-keys> |
| 42 </template> | 46 </template> |
| 43 </test-fixture> | 47 </test-fixture> |
| 44 | 48 |
| 45 <test-fixture id="BehaviorKeys"> | 49 <test-fixture id="BehaviorKeys"> |
| 46 <template> | 50 <template> |
| 47 <x-a11y-behavior-keys></x-a11y-behavior-keys> | 51 <x-a11y-behavior-keys></x-a11y-behavior-keys> |
| 48 </template> | 52 </template> |
| 49 </test-fixture> | 53 </test-fixture> |
| 50 | 54 |
| 55 <test-fixture id="PreventKeys"> |
| 56 <template> |
| 57 <x-a11y-prevent-keys></x-a11y-prevent-keys> |
| 58 </template> |
| 59 </test-fixture> |
| 60 |
| 51 <script> | 61 <script> |
| 52 suite('Polymer.IronA11yKeysBehavior', function() { | 62 suite('Polymer.IronA11yKeysBehavior', function() { |
| 53 var keys; | 63 var keys; |
| 54 | 64 |
| 55 suiteSetup(function() { | 65 suiteSetup(function() { |
| 56 var KeysTestBehavior = [Polymer.IronA11yKeysBehavior, { | 66 var KeysTestBehavior = [Polymer.IronA11yKeysBehavior, { |
| 57 properties: { | 67 properties: { |
| 58 keyCount: { | 68 keyCount: { |
| 59 type: Number, | 69 type: Number, |
| 60 value: 0 | 70 value: 0 |
| 61 } | 71 } |
| 62 }, | 72 }, |
| 63 | 73 |
| 64 _keyHandler: function(event) { | 74 _keyHandler: function(event) { |
| 65 this.keyCount++; | 75 this.keyCount++; |
| 66 this.lastEvent = event; | 76 this.lastEvent = event; |
| 77 }, |
| 78 |
| 79 // Same as _keyHandler, used to distinguish who's called before who. |
| 80 _keyHandler2: function(event) { |
| 81 this.keyCount++; |
| 82 this.lastEvent = event; |
| 83 }, |
| 84 |
| 85 _preventDefaultHandler: function(event) { |
| 86 event.preventDefault(); |
| 87 this.keyCount++; |
| 88 this.lastEvent = event; |
| 67 } | 89 } |
| 68 }]; | 90 }]; |
| 69 | 91 |
| 70 Polymer({ | 92 Polymer({ |
| 71 is: 'x-a11y-basic-keys', | 93 is: 'x-a11y-basic-keys', |
| 72 | 94 |
| 73 behaviors: [ | 95 behaviors: [ |
| 74 KeysTestBehavior | 96 KeysTestBehavior |
| 75 ], | 97 ], |
| 76 | 98 |
| 77 keyBindings: { | 99 keyBindings: { |
| 78 'space': '_keyHandler' | 100 'space': '_keyHandler', |
| 101 '@': '_keyHandler' |
| 79 } | 102 } |
| 80 }); | 103 }); |
| 81 | 104 |
| 82 Polymer({ | 105 Polymer({ |
| 83 is: 'x-a11y-combo-keys', | 106 is: 'x-a11y-combo-keys', |
| 84 | 107 |
| 85 behaviors: [ | 108 behaviors: [ |
| 86 KeysTestBehavior | 109 KeysTestBehavior |
| 87 ], | 110 ], |
| 88 | 111 |
| 89 keyBindings: { | 112 keyBindings: { |
| 90 'ctrl+shift+a': '_keyHandler' | 113 'enter': '_keyHandler2', |
| 114 'ctrl+shift+a shift+enter': '_keyHandler' |
| 91 } | 115 } |
| 92 }); | 116 }); |
| 93 | 117 |
| 94 Polymer({ | 118 Polymer({ |
| 95 is: 'x-a11y-alternate-event-keys', | 119 is: 'x-a11y-alternate-event-keys', |
| 96 | 120 |
| 97 behaviors: [ | 121 behaviors: [ |
| 98 KeysTestBehavior | 122 KeysTestBehavior |
| 99 ], | 123 ], |
| 100 | 124 |
| (...skipping 10 matching lines...) Expand all Loading... |
| 111 | 135 |
| 112 Polymer({ | 136 Polymer({ |
| 113 is: 'x-a11y-behavior-keys', | 137 is: 'x-a11y-behavior-keys', |
| 114 | 138 |
| 115 behaviors: [ | 139 behaviors: [ |
| 116 KeysTestBehavior, | 140 KeysTestBehavior, |
| 117 XA11yBehavior | 141 XA11yBehavior |
| 118 ], | 142 ], |
| 119 | 143 |
| 120 keyBindings: { | 144 keyBindings: { |
| 121 'space': '_keyHandler' | 145 'enter': '_keyHandler' |
| 146 } |
| 147 }); |
| 148 |
| 149 Polymer({ |
| 150 is: 'x-a11y-prevent-keys', |
| 151 |
| 152 behaviors: [ |
| 153 KeysTestBehavior, |
| 154 XA11yBehavior |
| 155 ], |
| 156 |
| 157 keyBindings: { |
| 158 'space a': '_keyHandler', |
| 159 'enter shift+a': '_preventDefaultHandler' |
| 122 } | 160 } |
| 123 }); | 161 }); |
| 124 }); | 162 }); |
| 125 | 163 |
| 126 suite('basic keys', function() { | 164 suite('basic keys', function() { |
| 127 setup(function() { | 165 setup(function() { |
| 128 keys = fixture('BasicKeys'); | 166 keys = fixture('BasicKeys'); |
| 129 }); | 167 }); |
| 130 | 168 |
| 131 test('trigger the handler when the specified key is pressed', function() { | 169 test('trigger the handler when the specified key is pressed', function() { |
| 132 MockInteractions.pressSpace(keys); | 170 MockInteractions.pressSpace(keys); |
| 133 | 171 |
| 134 expect(keys.keyCount).to.be.equal(1); | 172 expect(keys.keyCount).to.be.equal(1); |
| 135 }); | 173 }); |
| 136 | 174 |
| 175 test('trigger the handler when the specified key is pressed together with a
modifier', function() { |
| 176 var event = new CustomEvent('keydown'); |
| 177 event.ctrlKey = true; |
| 178 event.keyCode = event.code = 32; |
| 179 keys.dispatchEvent(event); |
| 180 expect(keys.keyCount).to.be.equal(1); |
| 181 }); |
| 182 |
| 183 test('handles special character @', function() { |
| 184 var event = new CustomEvent('keydown'); |
| 185 event.key = '@'; |
| 186 keys.dispatchEvent(event); |
| 187 expect(keys.keyCount).to.be.equal(1); |
| 188 }); |
| 189 |
| 137 test('do not trigger the handler for non-specified keys', function() { | 190 test('do not trigger the handler for non-specified keys', function() { |
| 138 MockInteractions.pressEnter(keys); | 191 MockInteractions.pressEnter(keys); |
| 139 | 192 |
| 140 expect(keys.keyCount).to.be.equal(0); | 193 expect(keys.keyCount).to.be.equal(0); |
| 141 }); | 194 }); |
| 142 | 195 |
| 143 test('can have bindings added imperatively', function() { | 196 test('can have bindings added imperatively', function() { |
| 144 keys.addOwnKeyBinding('enter', '_keyHandler'); | 197 keys.addOwnKeyBinding('enter', '_keyHandler'); |
| 145 | 198 |
| 146 MockInteractions.pressEnter(keys); | 199 MockInteractions.pressEnter(keys); |
| 147 expect(keys.keyCount).to.be.equal(1); | 200 expect(keys.keyCount).to.be.equal(1); |
| 148 | 201 |
| 149 MockInteractions.pressSpace(keys); | 202 MockInteractions.pressSpace(keys); |
| 150 expect(keys.keyCount).to.be.equal(2); | 203 expect(keys.keyCount).to.be.equal(2); |
| 151 }); | 204 }); |
| 152 | 205 |
| 153 test('can remove imperatively added bindings', function() { | 206 test('can remove imperatively added bindings', function() { |
| 154 keys.addOwnKeyBinding('enter', '_keyHandler'); | 207 keys.addOwnKeyBinding('enter', '_keyHandler'); |
| 155 keys.removeOwnKeyBindings(); | 208 keys.removeOwnKeyBindings(); |
| 156 | 209 |
| 157 MockInteractions.pressEnter(keys); | 210 MockInteractions.pressEnter(keys); |
| 158 expect(keys.keyCount).to.be.equal(0); | 211 expect(keys.keyCount).to.be.equal(0); |
| 159 | 212 |
| 160 MockInteractions.pressSpace(keys); | 213 MockInteractions.pressSpace(keys); |
| 161 expect(keys.keyCount).to.be.equal(1); | 214 expect(keys.keyCount).to.be.equal(1); |
| 162 }); | 215 }); |
| 163 | 216 |
| 217 test('allows propagation beyond the key combo handler', function() { |
| 218 var keySpy = sinon.spy(); |
| 219 document.addEventListener('keydown', keySpy); |
| 220 |
| 221 MockInteractions.pressEnter(keys); |
| 222 |
| 223 expect(keySpy.callCount).to.be.equal(1); |
| 224 }); |
| 225 |
| 164 suite('edge cases', function() { | 226 suite('edge cases', function() { |
| 165 test('knows that `spacebar` is the same as `space`', function() { | 227 test('knows that `spacebar` is the same as `space`', function() { |
| 166 var event = new CustomEvent('keydown'); | 228 var event = new CustomEvent('keydown'); |
| 167 event.key = 'spacebar'; | 229 event.key = 'spacebar'; |
| 168 expect(keys.keyboardEventMatchesKeys(event, 'space')).to.be.equal(true); | 230 expect(keys.keyboardEventMatchesKeys(event, 'space')).to.be.equal(true); |
| 169 }); | 231 }); |
| 232 |
| 233 test('handles `+`', function() { |
| 234 var event = new CustomEvent('keydown'); |
| 235 event.key = '+'; |
| 236 expect(keys.keyboardEventMatchesKeys(event, '+')).to.be.equal(true); |
| 237 }); |
| 238 |
| 239 test('handles `:`', function() { |
| 240 var event = new CustomEvent('keydown'); |
| 241 event.key = ':'; |
| 242 expect(keys.keyboardEventMatchesKeys(event, ':')).to.be.equal(true); |
| 243 }); |
| 244 |
| 245 test('handles ` ` (space)', function() { |
| 246 var event = new CustomEvent('keydown'); |
| 247 event.key = ' '; |
| 248 expect(keys.keyboardEventMatchesKeys(event, 'space')).to.be.equal(true); |
| 249 }); |
| 170 }); | 250 }); |
| 171 | 251 |
| 172 suite('matching keyboard events to keys', function() { | 252 suite('matching keyboard events to keys', function() { |
| 173 test('can be done imperatively', function() { | 253 test('can be done imperatively', function() { |
| 174 var event = new CustomEvent('keydown'); | 254 var event = new CustomEvent('keydown'); |
| 175 event.keyCode = 65; | 255 event.keyCode = 65; |
| 176 expect(keys.keyboardEventMatchesKeys(event, 'a')).to.be.equal(true); | 256 expect(keys.keyboardEventMatchesKeys(event, 'a')).to.be.equal(true); |
| 177 }); | 257 }); |
| 178 | 258 |
| 179 test('can be done with a provided keyboardEvent', function() { | 259 test('can be done with a provided keyboardEvent', function() { |
| (...skipping 24 matching lines...) Expand all Loading... |
| 204 var event = new CustomEvent('keydown'); | 284 var event = new CustomEvent('keydown'); |
| 205 | 285 |
| 206 event.ctrlKey = true; | 286 event.ctrlKey = true; |
| 207 event.shiftKey = true; | 287 event.shiftKey = true; |
| 208 event.keyCode = event.code = 65; | 288 event.keyCode = event.code = 65; |
| 209 | 289 |
| 210 keys.dispatchEvent(event); | 290 keys.dispatchEvent(event); |
| 211 | 291 |
| 212 expect(keys.keyCount).to.be.equal(1); | 292 expect(keys.keyCount).to.be.equal(1); |
| 213 }); | 293 }); |
| 294 |
| 295 test('check if KeyBoardEvent.key is alpha-numberic', function() { |
| 296 var event = new CustomEvent('keydown'); |
| 297 |
| 298 event.ctrlKey = true; |
| 299 event.shiftKey = true; |
| 300 event.key = 'å'; |
| 301 event.keyCode = event.code = 65; |
| 302 |
| 303 keys.dispatchEvent(event); |
| 304 |
| 305 expect(keys.keyCount).to.be.equal(1); |
| 306 }); |
| 307 |
| 308 test('trigger also bindings without modifiers', function() { |
| 309 var event = new CustomEvent('keydown'); |
| 310 // Combo `shift+enter`. |
| 311 event.shiftKey = true; |
| 312 event.keyCode = event.code = 13; |
| 313 keys.dispatchEvent(event); |
| 314 expect(keys.keyCount).to.be.equal(2); |
| 315 }); |
| 316 |
| 317 test('give precendence to combos with modifiers', function() { |
| 318 var enterSpy = sinon.spy(keys, '_keyHandler2'); |
| 319 var shiftEnterSpy = sinon.spy(keys, '_keyHandler'); |
| 320 var event = new CustomEvent('keydown'); |
| 321 // Combo `shift+enter`. |
| 322 event.shiftKey = true; |
| 323 event.keyCode = event.code = 13; |
| 324 keys.dispatchEvent(event); |
| 325 expect(enterSpy.called).to.be.true; |
| 326 expect(shiftEnterSpy.called).to.be.true; |
| 327 expect(enterSpy.calledAfter(shiftEnterSpy)).to.be.true; |
| 328 }); |
| 329 |
| 214 }); | 330 }); |
| 215 | 331 |
| 216 suite('alternative event keys', function() { | 332 suite('alternative event keys', function() { |
| 217 setup(function() { | 333 setup(function() { |
| 218 keys = fixture('AlternativeEventKeys'); | 334 keys = fixture('AlternativeEventKeys'); |
| 219 }); | 335 }); |
| 220 | 336 |
| 221 test('trigger on the specified alternative keyboard event', function() { | 337 test('trigger on the specified alternative keyboard event', function() { |
| 222 MockInteractions.keyDownOn(keys, 32); | 338 MockInteractions.keyDownOn(keys, 32); |
| 223 | 339 |
| 224 expect(keys.keyCount).to.be.equal(0); | 340 expect(keys.keyCount).to.be.equal(0); |
| 225 | 341 |
| 226 MockInteractions.keyUpOn(keys, 32); | 342 MockInteractions.keyUpOn(keys, 32); |
| 227 | 343 |
| 228 expect(keys.keyCount).to.be.equal(1); | 344 expect(keys.keyCount).to.be.equal(1); |
| 229 }); | 345 }); |
| 230 }); | 346 }); |
| 231 | 347 |
| 232 suite('behavior keys', function() { | 348 suite('behavior keys', function() { |
| 233 setup(function() { | 349 setup(function() { |
| 234 keys = fixture('BehaviorKeys'); | 350 keys = fixture('BehaviorKeys'); |
| 235 }); | 351 }); |
| 236 | 352 |
| 237 test('bindings in other behaviors are transitive', function() { | 353 test('bindings in other behaviors are transitive', function() { |
| 238 MockInteractions.pressEnter(keys); | 354 MockInteractions.pressEnter(keys); |
| 239 MockInteractions.pressSpace(keys); | 355 expect(keys.keyCount).to.be.equal(2); |
| 356 }); |
| 357 }); |
| 240 | 358 |
| 241 expect(keys.keyCount).to.be.equal(2); | 359 suite('stopping propagation automatically', function() { |
| 360 setup(function() { |
| 361 keys = fixture('NonPropagatingKeys'); |
| 362 }); |
| 363 |
| 364 test('does not propagate key events beyond the combo handler', function() { |
| 365 var keySpy = sinon.spy(); |
| 366 |
| 367 document.addEventListener('keydown', keySpy); |
| 368 |
| 369 MockInteractions.pressEnter(keys); |
| 370 |
| 371 expect(keySpy.callCount).to.be.equal(0); |
| 372 }); |
| 373 }); |
| 374 |
| 375 suite('prevent default behavior of event', function() { |
| 376 setup(function() { |
| 377 keys = fixture('PreventKeys'); |
| 378 }); |
| 379 |
| 380 test('`defaultPrevented` is correctly set', function() { |
| 381 MockInteractions.pressEnter(keys); |
| 382 expect(keys.lastEvent.defaultPrevented).to.be.equal(true); |
| 383 }); |
| 384 |
| 385 test('only 1 handler is invoked', function() { |
| 386 var aSpy = sinon.spy(keys, '_keyHandler'); |
| 387 var shiftASpy = sinon.spy(keys, '_preventDefaultHandler'); |
| 388 var event = new CustomEvent('keydown', { |
| 389 cancelable: true |
| 390 }); |
| 391 // Combo `shift+a`. |
| 392 event.shiftKey = true; |
| 393 event.keyCode = event.code = 65; |
| 394 keys.dispatchEvent(event); |
| 395 |
| 396 expect(keys.keyCount).to.be.equal(1); |
| 397 expect(shiftASpy.called).to.be.true; |
| 398 expect(aSpy.called).to.be.false; |
| 242 }); | 399 }); |
| 243 }); | 400 }); |
| 244 | 401 |
| 245 }); | 402 }); |
| 246 </script> | 403 </script> |
| 247 </body> | 404 </body> |
| 248 </html> | 405 </html> |
| OLD | NEW |