The <keyboard> object dresses the virtual keyboard that opens whenever text input is requested: search, Wi-Fi network name, credentials, renaming a game.
<keyboard>is new in Recalbox 10.1.
Only colours and the font are customisable: the keyboard size and position are always computed by Recalbox, so it stays usable on every screen.
| View | Name | Element |
|---|---|---|
menu, system, detailed, basic, gameclip |
keyboard |
The virtual keyboard shown over that view |
This object cannot be created with extra="true".
The keyboard picks up the definition of the view it opens over. Declare it at least in the menu view, which covers the most frequent case.
| Property | Type | Purpose | Default |
|---|---|---|---|
keyColor |
Colour | Key background | 303030F0 |
keySelectedColor |
Colour | Background of the selected key | C02020FF |
keyTextColor |
Colour | Key text and glyphs | FFFFFFFF |
keyDisabledColor |
Colour | Text of a disabled key | 707070FF |
keyModifierColor |
Colour | Modifier key active for a single stroke (SHIFT) |
4488FFFF |
keyModifierLockedColor |
Colour | Locked modifier key (CAPS LOCK) |
224488FF |
keyTitleColor |
Colour | Title of the input window | FFFF80FF |
keyEditTextColor |
Colour | Text being typed | FFFFFFFF |
fontPath |
Path | Font used for the keys. The size stays keyboard-driven | — |
The keyModifierColor and keyModifierLockedColor properties only concern the classic keyboard: the arcade wheel keyboard has no displayed modifier keys.
<view name="menu, system, detailed">
<keyboard name="keyboard"
keyColor="1A1A1AF0"
keySelectedColor="4368FFFF"
keyTextColor="FFFFFFFF"
keyDisabledColor="606060FF"
keyModifierColor="4488FFFF"
keyModifierLockedColor="224488FF"
keyTitleColor="FFCC44FF"
keyEditTextColor="FFFFFFFF"
fontPath="./art/Exo2-Regular.otf" />
</view>