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. |