|
24 | 24 | /** |
25 | 25 | * Representations of pressable keys that aren't text. These are stored in the Unicode PUA (Private |
26 | 26 | * Use Area) code points, 0xE000–0xF8FF. These values are used internally by WebDriver to simulate |
27 | | - * keyboard input where standard Unicode characters are insufficient, such as modifier and control keys. |
| 27 | + * keyboard input where standard Unicode characters are insufficient, such as modifier and control |
| 28 | + * keys. |
28 | 29 | * |
29 | | - * The codes follow conventions partially established by the W3C WebDriver specification and the Selenium project. |
30 | | - * Some values (e.g., RIGHT_SHIFT, RIGHT_COMMAND) are used in ChromeDriver but are not currently part of the W3C spec. |
31 | | - * Others (e.g., OPTION, FN) are symbolic and reserved for possible future mapping. |
| 30 | + * <p>The codes follow conventions partially established by the W3C WebDriver specification and the |
| 31 | + * Selenium project. Some values (e.g., RIGHT_SHIFT, RIGHT_COMMAND) are used in ChromeDriver but are |
| 32 | + * not currently part of the W3C spec. Others (e.g., OPTION, FN) are symbolic and reserved for |
| 33 | + * possible future mapping. |
32 | 34 | * |
33 | | - * For consistency across platforms and drivers, values should be verified before assuming native support. |
| 35 | + * <p>For consistency across platforms and drivers, values should be verified before assuming native |
| 36 | + * support. |
34 | 37 | * |
35 | | - * @see <a href="https://www.w3.org/TR/webdriver/#keyboard-actions">W3C WebDriver Keyboard Actions</a> |
36 | | - * @see <a href="http://www.google.com.au/search?&q=unicode+pua&btnK=Search">Unicode PUA Overview</a> |
| 38 | + * @see <a href="https://www.w3.org/TR/webdriver/#keyboard-actions">W3C WebDriver Keyboard |
| 39 | + * Actions</a> |
| 40 | + * @see <a href="http://www.google.com.au/search?&q=unicode+pua&btnK=Search">Unicode PUA |
| 41 | + * Overview</a> |
37 | 42 | */ |
38 | 43 | @NullMarked |
39 | 44 | public enum Keys implements CharSequence { |
@@ -115,7 +120,7 @@ public enum Keys implements CharSequence { |
115 | 120 |
|
116 | 121 | // Symbolic macOS keys not yet standardized |
117 | 122 | OPTION('\uE050'), // TODO: verify Unicode value with WebDriver spec |
118 | | - FN('\uE051'), // TODO: symbolic only; confirm or remove in future |
| 123 | + FN('\uE051'), // TODO: symbolic only; confirm or remove in future |
119 | 124 |
|
120 | 125 | ZENKAKU_HANKAKU('\uE040'); |
121 | 126 |
|
@@ -162,8 +167,8 @@ public String toString() { |
162 | 167 | } |
163 | 168 |
|
164 | 169 | /** |
165 | | - * Simulate pressing many keys at once in a "chord". |
166 | | - * Takes a sequence of Keys.XXXX or strings; appends each to a string, adds the chord termination key (Keys.NULL), and returns it. |
| 170 | + * Simulate pressing many keys at once in a "chord". Takes a sequence of Keys.XXXX or strings; |
| 171 | + * appends each to a string, adds the chord termination key (Keys.NULL), and returns it. |
167 | 172 | * |
168 | 173 | * <p>Note: Keys.NULL signals release of modifier keys like CTRL/ALT/SHIFT via keyup events. |
169 | 174 | * |
|
0 commit comments