# KeystrokeWidget API


 Bases: `AnyWidget`


Capture the latest keyboard shortcut pressed inside the widget.


No initialization arguments are required; the widget simply records keystrokes into the `last_key` trait.


The `last_key` payload mirrors browser `KeyboardEvent` data with: `key`, `code`, modifier booleans (`ctrlKey`, `shiftKey`, `altKey`, `metaKey`), and a `timestamp` in milliseconds since epoch.



```
from wigglystuff import KeystrokeWidget

from wigglystuff import KeystrokeWidget

keystroke = KeystrokeWidget()
keystroke
```


## Synced traitlets


`last_key` is a dictionary synced from the browser after each keypress. When no keypress has been captured yet, it is an empty dict.


| Key | Type | Notes |
| --- | --- | --- |
| `key` | `str` | Display value for the key (e.g., `a`, `Enter`). |
| `code` | `str` | Physical key code (e.g., `KeyA`, `Enter`). |
| `ctrlKey` | `bool` | `True` when Control is held. |
| `shiftKey` | `bool` | `True` when Shift is held. |
| `altKey` | `bool` | `True` when Alt/Option is held. |
| `metaKey` | `bool` | `True` when Command/Meta is held. |
| `timestamp` | `int` | Milliseconds since epoch at capture time. |