OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 | 5 |
6 /** | 6 /** |
7 * An event that describes user interaction with the keyboard. | 7 * An event that describes user interaction with the keyboard. |
8 * | 8 * |
9 * The [type] of the event identifies what kind of interaction occurred. | 9 * The [type] of the event identifies what kind of interaction occurred. |
10 * | 10 * |
11 * See also: | 11 * See also: |
12 * | 12 * |
13 * * [KeyboardEvent](https://developer.mozilla.org/en/DOM/KeyboardEvent) at MDN. | 13 * * [KeyboardEvent](https://developer.mozilla.org/en/DOM/KeyboardEvent) at MDN. |
14 */ | 14 */ |
15 $(ANNOTATIONS)$(NATIVESPEC)$(CLASS_MODIFIERS)class $CLASSNAME$EXTENDS$IMPLEMENTS
{ | 15 $(ANNOTATIONS)$(NATIVESPEC)$(CLASS_MODIFIERS)class $CLASSNAME$EXTENDS$IMPLEMENTS
{ |
16 | 16 |
17 /** | 17 /** |
18 * Programmatically create a KeyboardEvent. | 18 * Programmatically create a KeyboardEvent. |
19 * | 19 * |
20 * Due to browser differences, keyCode, charCode, or keyIdentifier values | 20 * Due to browser differences, keyCode, charCode, or keyIdentifier values |
21 * cannot be specified in this base level constructor. This constructor | 21 * cannot be specified in this base level constructor. This constructor |
22 * enables the user to programmatically create and dispatch a [KeyboardEvent], | 22 * enables the user to programmatically create and dispatch a [KeyboardEvent], |
23 * but it will not contain any particular key content. For programmatically | 23 * but it will not contain any particular key content. For programmatically |
24 * creating keyboard events with specific key value contents, see the custom | 24 * creating keyboard events with specific key value contents, see the custom |
25 * Event [KeyEvent]. | 25 * Event [KeyEvent]. |
26 */ | 26 */ |
27 factory $CLASSNAME(String type, | 27 factory $CLASSNAME(String type, { |
28 {Window view, bool canBubble: true, bool cancelable: true, | 28 Window view, |
29 int location: 1, bool ctrlKey: false, | 29 bool canBubble: true, |
30 bool altKey: false, bool shiftKey: false, bool metaKey: false}) { | 30 bool cancelable: true, |
| 31 int location, |
| 32 int keyLocation, // Legacy alias for location |
| 33 bool ctrlKey: false, |
| 34 bool altKey: false, |
| 35 bool shiftKey: false, |
| 36 bool metaKey: false}) { |
31 if (view == null) { | 37 if (view == null) { |
32 view = window; | 38 view = window; |
33 } | 39 } |
| 40 location ??= keyLocation ?? 1; |
34 KeyboardEvent e = document._createEvent("KeyboardEvent"); | 41 KeyboardEvent e = document._createEvent("KeyboardEvent"); |
35 e._initKeyboardEvent(type, canBubble, cancelable, view, "", | 42 e._initKeyboardEvent(type, canBubble, cancelable, view, "", |
36 location, ctrlKey, altKey, shiftKey, metaKey); | 43 location, ctrlKey, altKey, shiftKey, metaKey); |
37 return e; | 44 return e; |
38 } | 45 } |
39 | 46 |
40 @DomName('KeyboardEvent.initKeyboardEvent') | 47 @DomName('KeyboardEvent.initKeyboardEvent') |
41 void _initKeyboardEvent(String type, bool canBubble, bool cancelable, | 48 void _initKeyboardEvent(String type, bool canBubble, bool cancelable, |
42 Window view, String keyIdentifier, int location, bool ctrlKey, | 49 Window view, String keyIdentifier, int location, bool ctrlKey, |
43 bool altKey, bool shiftKey, bool metaKey) { | 50 bool altKey, bool shiftKey, bool metaKey) { |
(...skipping 16 matching lines...) Expand all Loading... |
60 @DomName('KeyboardEvent.keyCode') | 67 @DomName('KeyboardEvent.keyCode') |
61 int get keyCode => _keyCode; | 68 int get keyCode => _keyCode; |
62 | 69 |
63 @DomName('KeyboardEvent.charCode') | 70 @DomName('KeyboardEvent.charCode') |
64 int get charCode => _charCode; | 71 int get charCode => _charCode; |
65 | 72 |
66 @DomName('KeyboardEvent.which') | 73 @DomName('KeyboardEvent.which') |
67 int get which => _which; | 74 int get which => _which; |
68 $!MEMBERS | 75 $!MEMBERS |
69 } | 76 } |
OLD | NEW |