Mouse keys
Mouse keys is a feature of some graphical user interfaces that uses the keyboard as a pointing device. Its roots lie in the earliest days of visual editors when line and column navigation was controlled with arrow keys.
Today, mouse keys usually refers to the numeric keypad layout standardized with the introduction of the X Window System in 1984.
Layout
[Image:X window system MouseKeys default numpad layout.svg|thumb|left|X window system MouseKeys default numpad layout]| key | action |
| with enable/disable MouseKeys | |
| cursor up | |
| cursor down | |
| cursor right | |
| cursor left | |
| cursor up and left | |
| cursor up and right | |
| cursor down and right | |
| cursor down and left | |
| select primary button | |
| select modifier button | |
| select alternate button | |
| click selected button | |
| double click selected button | |
| depress selected button | |
| release selected button | |
| enter key |
History
Historically, MouseKeys supported GUI programs when many terminals had no dedicated pointing device. As pointing devices became ubiquitous, the use of mouse keys narrowed to situations where a pointing device was missing, unusable, or inconvenient. Such situations may arise from the following:- precision requirements
- disabled user or ergonomics issues
- environmental limits
- broken/missing/unavailable equipment
By the early 2020s, with graphics tablets becoming more common, a configuration change may be required before enabling MouseKeys.
MouseKeysAccel
[Image:X Protocol MouseKeysAccel Control Trajectory.svg|thumb|left|X window system MouseKeysAccel trajectory]| parameter | meaning |
| mk_delay | milliseconds between the initial key press and first repeated motion event |
| mk_interval | milliseconds between repeated motion events |
| mk_max_speed | steady speed applied each event |
| mk_time_to_max | number of events accelerating to steady speed |
| mk_curve | ramp used to reach maximum pointer speed |
The X Window System MouseKeysAccel control applies action repeatedly while a direction key remains depressed. When the key is depressed, an action_delta is immediately applied. If the key remains depressed, longer than mk_delay milliseconds, some action is applied every mk_interval milliseconds until the key is released. If the key remains depressed, after more than mk_time_to_max actions have been applied, action_delta magnified mk_max_speed times, is applied every mk_interval milliseconds.
The first mk_time_to_max actions increase smoothly according to an exponential.
| mk_curve | result |
| -1000 | uniform speed, linearly increasing action |
| 0 | uniform acceleration, linearly increasing speed |
| 1000 | uniform jerk, linearly increasing acceleration |
These five parameters are configurable.
Enabling
Under the X Window Systems X.Org and XFree86 used on Unix-like systems such as Linux, BSD, and AIX, MouseKeys, when available, is nominally activated by ++. MouseKeys without acceleration is sometimes available with +. This is nominally independent of the window manager in use, but may be overridden, or even made unavailable by a configuration file.Before enabling, it may be necessary to change system configuration. The utility can be used to change the configuration under Xorg:
setxkbmap -option keypad:pointerkeysThere are also various utilities to allow more precise control via user-configurable key bindings, such as and .
Since KDE 5, MouseKeys is enabled and configured by systemsetting5
MouseKeys for Apple Inc.'s macOS is enabled and configured via the Accessibility.
Microsoft changed the method of enabling between Windows 2000, Windows XP, and Windows Vista.
Common usage
Replacing the mouse keys
Replacing the mouse keys by the numeric keypad is as follows:Typing is equivalent to clicking the selected button. By default, the selected button is the primary button. Typing selects the alternate button. Typing selects the modifier button. Typing selects the primary button. The selection remains in effect until a different button is selected.
Assignment of left/middle/right button to primary/modifier/alternate, alternate/modifier/primary, or something else is settable by many means. Some mice have a switch, that swaps assignment of right and left keys. Many laptop bioses have a setting for mouse button assignment. Many window managers have a setting that permutes the assignment. Within the X Window System core protocol, permutation can be applied by .