setNavigationEnabled()

Syntax:

[void] window.widget.setNavigationEnabled(Boolean navigationMode) 

or

[void] widget.setNavigationEnabled(Boolean navigationMode)

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.

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:

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.

Example code:

// Tab mode
widget.setNavigationEnabled(false); 
// Cursor mode
widget.setNavigationEnabled(true);