Properties
| Name | Attribute | Type | Description |
|---|---|---|---|
| attachMode | attach-mode | |
The rule for the Keyboard to attach to inputs for showing on component focus. • all - The Keyboard will show on focus for all input related components unless opted out with data-omni-keyboard-hidden on the component.• attribute - The Keyboard will only show on focus for input related components with the data-omni-keyboard-attach attribute• id - The Keyboard will only show on focus for input related components with the data-omni-keyboard-attach attribute set equal to the Keyboard's id |
| closeLabel | close-label | |
The text label to display by the close button. |
| spaceLabel | space-label | |
The text label to display on the spacebar button. |
| clearLabel | clear-label | |
The text label to display on the clear button. The clear slot takes precedence over this label. |
| actionLabel | action-label | |
The text label to display on the call to action button when enterkeyhint is not defined or enterkeyhint="enter". The action-enter slot takes precedence over this label. |
| dir | dir | |
Used to set the base direction of text for display |
| lang | lang | |
Used to identify the language of text content on the web |
Static Functions
| Name | Parameters | Returns | Description |
|---|---|---|---|
| create | |
|
Creates a new Keyboard element with the provided context and appends it to the DOM (either to document body or to provided target parent element). |
Supported Global Attributes
| Attribute | Type | Description |
|---|---|---|
|
|
Indicates that the Keyboard is enabled for that component when the Keyboard has attach-mode="attribute" or when the value is equal to the Keyboard's id and attach-mode="id". |
|
|
Disables the Keyboard for that component. |
|
|
Indicates that the Keyboard is to render in specified type of inputmode. Takes precedence over inputmode attribute. |
|
|
Indicates that the Keyboard's call to action button must render (and in some cases behave) accordingly. |
|
|
Indicates that the call to action button inserts a new line instead of default behaviour. |
|
|
Indicates that the Keyboard display value must be masked. |
|
|
Disables the Keyboard display value. Takes precedence over data-omni-keyboard-mask. |
Types
| Name | Type |
|---|---|
| InputMode | |
| InputEventTypes | |
| EnterKeyHint | |
| KeyboardMode | |
| InputEventInitWithType | |
| KeyboardInit | |
Slots
| Name | Description |
|---|---|
|
Used to define content that is displayed while async rendering is awaiting, or when renderLoading() is implicitly called |
|
Content to display on case change button when in a lowercase state. |
|
Content to display on case change button when in a single uppercase state. |
|
Content to display on case change button when in a permanent uppercase state (caps lock). |
|
Content to display next to close label. |
|
Content to display on backspace button. |
|
Content to display on clear button. |
|
Content to display on call to action button ('Enter') when target component has enterkeyhint="done". |
|
Content to display on call to action button ('Enter') when target component has enterkeyhint="go". |
|
Content to display on call to action button ('Enter') when target component has enterkeyhint="next". |
|
Content to display on call to action button ('Enter') when target component has enterkeyhint="previous". |
|
Content to display on call to action button ('Enter') when target component has enterkeyhint="search". |
|
Content to display on call to action button ('Enter') when target component has enterkeyhint="send". |
|
Content to display on call to action button ('Enter') when target component has enterkeyhint="enter" or enterkeyhint is not set. |
Theme Variables
| Name | Description |
|---|---|
|
Theme primary color. |
|
Theme primary hover color. |
|
Theme primary active color. |
|
Theme accent color. |
|
Theme accent hover color. |
|
Theme accent active color. |
|
Theme background color. |
|
Theme background hover color. |
|
Theme background active color. |
|
Theme font color. |
|
Theme disabled border color. |
|
Theme disabled background color. |
|
Theme disabled background color. |
|
Theme error border color. |
|
Theme hint font color. |
|
Theme inactive color. |
|
Theme inactive color. |
|
Theme font family. |
|
Theme font size. |
|
Theme font weight. |
|
Theme border radius. |
|
Theme border width. |
|
Theme box shadow. |
Component Variables
| Name | Description |
|---|---|
|
Max height for slotted content in keyboard buttons. |
|
Max width for slotted content in keyboard buttons. |
|
Font family for text in keyboard buttons. |
|
Font color for text in keyboard buttons. |
|
Font size for text in keyboard buttons. |
|
Background color for keyboard buttons. |
|
Border for keyboard buttons. |
|
Margin for keyboard buttons. |
|
Font weight for text in keyboard buttons. |
|
Height for keyboard buttons. |
|
Width for keyboard buttons. |
|
Line height for keyboard buttons. |
|
Border radius for keyboard buttons. |
|
Margin for keyboard buttons in mobile viewports. |
|
Height for keyboard buttons in mobile viewports. |
|
Width for keyboard buttons in mobile viewports. |
|
Width for return keyboard buttons in mobile viewports. |
|
Width for numeric keyboard buttons in mobile viewports. |
|
Height for keyboard buttons in small mobile viewports. |
|
Width for keyboard buttons in small mobile viewports. |
|
Font size for text in keyboard buttons in small mobile viewports. |
|
Border radius for keyboard buttons in small mobile viewports. |
|
Width for return keyboard buttons in small mobile viewports. |
|
Width for numeric keyboard buttons in small mobile viewports. |
|
Border radius for keyboard shadow. |
|
Bottom padding for keyboard shadow. |
|
Background color for keyboard shadow. |
|
Width for keyboard top bar. |
|
Left padding for keyboard top bar. |
|
Right padding for keyboard top bar. |
|
Background color for keyboard top bar. |
|
Border radius for keyboard top bar. |
|
Border bottom color for keyboard top bar. |
|
Width for display label in keyboard numeric mode. |
|
Width for display label in keyboard special mode. |
|
Width for display label in keyboard alpha-numeric mode. |
|
Width for keyboard button rows wrapper. |
|
Width for keyboard button rows wrapper for special keys. |
|
Width for keyboard button rows wrapper for numeric keyboard mode. |
|
Width for keyboard call to action button. |
|
Max width for keyboard call to action button. |
|
Font or icon colour for keyboard call to action button. |
|
Background colour for keyboard call to action button. |
|
Font size for keyboard call to action button. |
|
Font weight for keyboard call to action button. |
|
Border radius for keyboard call to action button. |
|
Margin for keyboard call to action button. |
|
Width for keyboard close button icon. |
|
Font weight for keyboard close button. |
|
Font colour for keyboard close button. |
|
Font size for keyboard close button. |
|
Width for keyboard close button area. |
|
Right padding for keyboard close button area. |
|
Background color for keyboard. |
|
Margin for keyboard rows. |
|
Width for keyboard rows. |
|
Top padding for first keyboard row. |
|
Bottom padding for last keyboard row. |
|
Colour for keyboard icons. |
|
Height for keyboard top bar in mobile viewports. |
|
Border radius for keyboard top bar in mobile viewports. |
|
Width for display label in keyboard numeric mode for mobile viewports. |
|
Width for display label in keyboard special mode for mobile viewports. |
|
Width for display label in keyboard alpha-numeric mode for mobile viewports. |
|
Margin for keyboard rows in mobile viewports. |
|
Margin for special keyboard rows in mobile viewports. |
|
Width for keyboard rows in mobile viewports. |
|
Height for keyboard call to action button in mobile viewports. |
|
Max width for keyboard call to action button in mobile viewports. |
|
Margin for keyboard call to action button in mobile viewports. |
|
Width for keyboard close button icon in mobile viewports. |
|
Width for display label in keyboard numeric mode for small mobile viewports. |
|
Width for display label in keyboard special mode for small mobile viewports. |
|
Width for display label in keyboard alpha-numeric mode for small mobile viewports. |
|
Margin for keyboard rows in small mobile viewports. |
|
Height for keyboard call to action button in small mobile viewports. |
|
Max width for keyboard call to action button in small mobile viewports. |