PSD1165 – Configure tabbing in a form

Summary

This PhenixID Solution Document (PSD) is written for PhenixID Identity Manager (IM) 5.5.0 or later.

Use case
A user logs in and like to use the keyboard to access controls instead of using the mouse in an edit or create form.

Configuration

Overview

There two types of controls to consider when deciding tab order in a form:

• Standard controls
• Custom controls

Working with Standard controls

If you have just standard controls you can have the first control with focusOrder 1 (taborder), second with focusOrder 2 and so on. When you tab in such form tabbing will go from 1 to 2 to 3 and so on. (there is no difference if you have values 10, 20 and 30 tabbing will go from lowest value to highest value).
Best practice. You might consider having some value space between the controls (5 10 15 and so on for example). This is for two reasons:

• You might like to add another control in between two existing. In this case you do not have to redo all the numbering after the new added control.
• You have one or more custom controls in your form. (see next section)

Working with Custom controls

When you add a custom control to a form the control can have inside it self a number of tabbing options (for example an input field and a button). This is very important to consider when having a number of controls (both standard and custom) in a form.
When you specify, for example focusOrder(tabIndex) 10 for a custom control you might think the next control should have 11. If the custom control have inside it self 2 tab option then you need to calculate this when setting the next focusOrder. In this case it should be 12 for then next control since the custom control will use 10 and 11.
So once again, good practice can be to set some spacing between the different controls by default.

Add focusOrder in a form

1. Open IM Configurator
2. Open Tab Designer
3. Open a New or an Existing form (Create, Predefined search or Edit form)
4. Open Control Properties for a standard or custom control
5. In Focus Order, add the tab order value for the control
6. Save the control

Disable focusOrder for a control

Note: If you have a control that like not to have focusOrder or never be able to enter with tabbing. Add -2 as value.

Some custom controls and tab numbers

• Date control
  se.nordicedge.controls.date.DateMicrosoftTime
• Password control
  se.nordicedge.controls.password.ManagePasswordCC
• singleValueSelect
  se.nordicedge.controls.SingleValueSelect
• MultiListControls
  se.nordicedge.controls.lists.MultiListControl
  se.nordicedge.controls.lists.MultiListStringControl
  se.nordicedge.controls.lists.MultiListStaticStringControl