Merge pull request #13272 from keymanapp/docs/web/guide-example-promi…

…se-use docs(web): use promise-chaining in manual-control example
keymanapp · Feb 18, 2025 · 7902260 · 7902260
2 parents 04f279f + 8421409
commit 7902260
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 17 deletions.
diff --git a/web/docs/engine/guide/examples/__manual-control.html b/web/docs/engine/guide/examples/__manual-control.html
@@ -6,21 +6,16 @@
   <script type='text/javascript' src='js/laokeys_load.js'></script>
 
   <script type="text/javascript">
-
-    var KWControl = null;
-
     function SetupDocument()
     {
-      keyman.init();
-      KWControl = document.getElementById('KWControl');
-      keyman.setActiveKeyboard('laokeys');
-      keyman.osk.hide();
+      keyman.init().then(function() {
+        keyman.setActiveKeyboard('laokeys');
+        keyman.osk.hide();
+      });
     }
 
     function KWControlClick()
     {
-      var KWControl = document.getElementById('KWControl');
-
       if(keyman.osk.isEnabled()) {
         keyman.osk.hide();
       } else {

diff --git a/web/docs/engine/guide/examples/manual-control.md b/web/docs/engine/guide/examples/manual-control.md
@@ -14,13 +14,12 @@ Include the following script in the HEAD of your page:
   function SetupDocument()
   {
     /* Make sure that Keyman is initialized (we can't guarantee initialization order) */
-    keyman.init();
-
-    KWControl = document.getElementById('KWControl');
-    /* Prevents automatic display of the onscreen keyboard. (default automatic) */
-    keyman.osk.hide();
-    /* Select the LaoKeys keyboard */
-    keyman.setActiveKeyboard('laokeys');
+    keyman.init().then(function () {
+      /* Prevents automatic display of the onscreen keyboard. (default automatic) */
+      keyman.osk.hide();
+      /* Select the LaoKeys keyboard */
+      keyman.setActiveKeyboard('laokeys');
+    });
   }
 
   /* KWControlClick: Called when user clicks on the KWControl IMG */
@@ -56,7 +55,7 @@ And finally, include the control img for KeymanWeb:
 
 ```html
 <!-- Display the KeymanWeb icon for the user to click on -->
-<img style="border: solid 1px black; padding: 2px 2px 3px 2px" src='kmicon.png' alt='KeymanWeb' onclick='KWControlClick()' id='KWControl' />
+<img style="border: solid 1px black; padding: 2px 2px 3px 2px" src='kmicon.png' alt='KeymanWeb' onclick='KWControlClick()' />
 ```
 
 ## API References