1f82507730
Deprecate the following obsolete functions and properties: * `keyman.helpURL` * `keyman.util.rgba` * `keyman.util.toFloat` * `keyman.util.toNumber` * `keyman.util.toNzString` Use correct language for code blocks in Keyman Engine for Web documentation. Test-bot: skip
1.4 KiB
| title |
|---|
| attachToControl |
Summary
Attach KeymanWeb to HTML element (or IFrame).
Syntax
keyman.attachToControl(Pelem)
Parameters
Pelem- Type:
Element - Element to which KeymanWeb will be attached.
Return Value
undefined
Description
There are two steps involved in enabling input handling with KeymanWeb for any given control: attachment and enablement. The attachment process validates a control's compatibility with KeymanWeb and establishes special metadata within the system. This data is released if the control is ever detached. The control will not receive special input handling until the control is enabled within KeymanWeb.
If attachToControl() is called on an element with the 'kmw-disabled'
class property, it will only establish KeymanWeb's metadata for the
control and initialize the control in a disabled state. A later call to
enableControl() may be used to initialize input handling for it.
Otherwise, the control will be both attached and enabled.
When the initialization property attachType is set to
'auto', this function is called automatically for every control on the
page, even those dynamically added. However, when attachType is set to
'manual', attachToControl must be explicitly called for each control
in need of KeymanWeb's input handling.