Description:
The navigation mode in a widget can be toggled between a cursor and
a tabbed navigation mode. By default, the browsing mode of a widget is set
to use a cursor (pointer). The setNavigationEnabled method
is used for changing the widget's navigation mode.
The argument navigationType is of Boolean type
and can be set to true or false to
toggle the navigation mode between the cursor mode and the tab mode respectively.
Syntax:
[void] window.widget.setNavigationEnabled(Boolean navigationMode)
or
[void] widget.setNavigationEnabled(Boolean navigationMode)
Arguments:
navigationMode:
Set to true to enable the cursor navigation mode,
and set to false to enable the tabbed navigation mode.
Return value:
This method does not return a value.
Remarks:
The setNavigationType() and setNavigationEnabled methods are independent
of each other. You can use either method to set the navigation mode.
Tab navigation is only recommended for simple vertical navigation. Enable the tabbed navigation mode to disable the cursor pointer when using JavaScript to handle key events. For more information, see Navigating on screens.
Example code:
// Tab mode widget.setNavigationEnabled(false); // Cursor mode widget.setNavigationEnabled(true);