Version

ModalTabIndices Property

Gets sets ability to dynamically disable tabIndex attributes of html elements located outside of dialog in modal state.
Syntax
'Declaration
 
Public Property ModalTabIndices As Boolean
public bool ModalTabIndices {get; set;}
Remarks
That property has effect only when Modal is enabled.

Notes for value of true:

  • If dialog gets visible, then tabIndex of potentially focusable html elements located outside dialog are set to -1. Those elements are INPUT, SELECT, A, DIV, etc.
  • If dialog gets hidden, then tabIndex of modified html elements are restored or set to 0. That may have negative side effects for some elements like DIV.
  • If page has too many html elements, then internal logic may take too long and browser will be locked.
Notes for value of false:
  • Tab indexes of html elements located outside dialog are not modified.
  • It is possible that in state when dialog never got focus, the first Tab-key press may set focus to an html element located outside dialog.
  • It is possible situation that continuous pressing Tab-key may stop focus-loop. So, the end user will need to press Shift+Tab or click element by mouse.
  • To improve focus behavior on Tab-key, it is recommended to set TabIndex of child controls of dialog to high values.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also