KMManager.setHTMLBanner
Summary
The setHTMLBanner() method sets the HTML banner content for Keyman Engine to display when suggestions aren't available.
Syntax
KMManager.setHTMLBanner(KeyboardType keyboardType, String content)Parameters
keyboardType
: KeyboardType to be used. KEYBOARD_TYPE_INAPP or KEYBOARD_TYPE_SYSTEM.
content
: HTML content formatted as a string.
Returns
Returns true if HTML banner is set, false otherwise.
Description
When suggestions aren't available for a keyboard, an HTML banner is displayed instead. Use this method to specify the HTML content to display in the banner to theme your keyboard app.
If the banner theme references assets (like .svg or .css files), ensure you've also called copyHTMLBannerAssets().
Note: The HTML banner needs to be updated whenever the keyboard is reloaded, so call this in SystemKeyboard.onInitializeInterface(().
Examples
Example: Using setHTMLBanner()
The following script illustrates the use of setHTMLBanner():
String KMGRAY_BANNER = "<div style=\"background: #b4b4b8; width: 100%; height: 100%; position: absolute; left: 0; top: 0\"></div>";
// Sets the HTML banner content
KMManager.setHTMLBanner(KeyboardType.KEYBOARD_TYPE_SYSTEM, KMGRAY_BANNER);