Creating Custom Keyboards

As described in the article on keyboard control, it is possible to create your own layouts.

This editor includes several examples of the most commonly used layouts. These can be viewed and modified with a single click on Copy to editor. A live preview is also displayed immediately. Afterwards, the layout can either be deployed to a single device via QR code or to multiple devices via MDM.

Structure of a Custom Keyboard

Each custom keyboard is a JSON object that can be customized in its structure and content using the available properties:

• rows: This is the top-level array. All buttons on the keyboard are arranged in rows.
• buttons: This object contains all the buttons that are displayed within a row.
• text: This text is shown to the user on the keyboard.
• function: This text is inserted into the input field when the button is clicked. It can differ from the display text and may include more than just a number or letter. Some special functions can also be used here, which are described in the next section.
• color: The color used to display the button. Must be a valid HEX code, e.g. #3366ff
• weight: This number controls the "width" of the button. The "weights" of all buttons in a row are added together. The button will then be displayed as wide (in %) as its weight divided by the sum of all weights.

The following special functions can be used as function:

• ENTER: Triggers an Enter key press when the button is clicked.
• TAB: Triggers a Tab key press when the button is clicked.
• DELETE: Deletes the previous character or all selected ones.
• F1-F9: Triggers a function key press.

Mixed layout

Example with numbers, letters, whole words and functions.

Only numbers and F-buttons

Example only with numbers and some F-keys.

Only F-Buttons

Example with only function keys..

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

{

  "rows": [

    {

      "buttons": [

        { "text": "0", "function": "0", "color": "#d3d3d3", "weight": 1 },

        { "text": "1", "function": "1", "color": "#d3d3d3", "weight": 1 },

        { "text": "2", "function": "2", "color": "#d3d3d3", "weight": 1 },

        { "text": "3", "function": "3", "color": "#d3d3d3", "weight": 1 },

        { "text": "4", "function": "4", "color": "#d3d3d3", "weight": 1 },

        { "text": "5", "function": "5", "color": "#d3d3d3", "weight": 1 },

        { "text": "6", "function": "6", "color": "#d3d3d3", "weight": 1 },

        { "text": "7", "function": "7", "color": "#d3d3d3", "weight": 1 },

        { "text": "8", "function": "8", "color": "#d3d3d3", "weight": 1 },

        { "text": "9", "function": "9", "color": "#d3d3d3", "weight": 1 }

      ]

    },

    {

      "buttons": [

        { "text": "http", "function": "http://", "color": "#3366ff", "weight": 1 },

        { "text": "https", "function": "https://", "color": "#ff6633", "weight": 1 },

        { "text": "ftp", "function": "ftp://", "color": "#33cc33", "weight": 1 }

      ]

    },

1380 of 3000 characters are used (minified)