Dynamically change controls

If you dynamically change the set of controls on your web page (for example, your app adds/removes or enables/disables specific text fields depending on the user’s actions), you must reinitialize the VUI form to recognize these changes. The same procedure is required if you change the set of application commands active in your app or the possible values defined for a command placeholder.

Procedure

When the GUI view or the active application commands are changed after the VUI form has been created by Dragon Medical SpeechKit, call the NUSA_reinitializeVuiForm() function.

To reinitialize edit controls in a specific section of your VUI form, call NUSA_reinitializeVuiForm(parent).

For example:

NUSA_reinitializeVuiForm(document.getElementById("speechFormsContainer1"));

To reinitialize an array of edit controls, call NUSA_reinitializeVuiForm(elements).

For example:

var childElements = [];
childElements.push.apply(childElements, document.getElementById("speechFormsContainer1").getElementsByTagName("*"));
childElements.push.apply(childElements, document.getElementById("speechFormsContainer2").getElementsByTagName("*"));
return NUSA_reinitializeVuiForm(childElements);

Focus handling considerations

• If controls are added, the voice focus doesn't change.

• If the control that currently has the voice focus is removed, the focus will implicitly be set to the first control unless you change the focus explicitly.

• Any utterance that has been dictated after the call to NUSA_reinitializeVuiForm() will go into the control that has implicitly or explicitly received the focus.