Forms Tab β Hardware Tab-Key Navigation in WebView Form Fields (iPadOS)
When a staff member uses a hardware keyboard connected to an iPad, pressing the Tab key moves focus between fields in a V2 or V3 form displayed on the Forms tab of the guest profile. This article explains how Tab-key navigation works within form WebViews on iPadOS so staff can complete forms efficiently without lifting their hands from the keyboard.
Audience: Front desk staff who fill out guest forms on iPadOS using a hardware keyboard.
On this page
- Before you begin
- How Tab-key navigation works in form fields
- Steps
- Tips
- Troubleshooting
- Related articles
Before you begin
- You must be working on an iPad running iPadOS with a hardware keyboard connected.
- The guest profile must be open and the Forms tab must be active.
- Tab-key navigation within form WebViews is supported on iPadOS only. It is not available on desktop web browsers or Android devices.
Note: Tab-key navigation applies to V2 and V3 forms displayed inside the Forms tab WebView. It does not apply to forms opened in external browsers or on other platforms.
How Tab-key navigation works in form fields
When the focus is inside a form field within the WebView on the Forms tab, pressing the hardware Tab key advances focus to the next focusable field. Pressing Shift+Tab moves focus to the previous field.
The system determines field order based on tab-index values:
- Fields with positive tab-index values are focused first, in ascending numerical order.
- Fields with a tab-index of zero are focused after all positive-index fields, in the order they appear in the document.
Fields that are hidden, disabled, read-only, or have zero size are skipped automatically β the focus moves past them to the next eligible field.
Radio button groups
For groups of radio buttons, Tab-key navigation treats the entire group as a single tab stop:
- If one radio button in the group is already selected (checked), focus moves to that button.
- If no button in the group is selected, focus moves to the first button in the group.
Pressing Tab again after landing on a radio group moves focus to the field or group that follows in tab-index order.
Steps
Complete a form using the hardware Tab key on iPad
- From the Appointment Book, select the guest and open the Guest profile panel.
- Select the Forms tab from the tab strip.
- Open the form you want to complete. The form opens inside a WebView.
- Tap a field to place the initial focus inside the WebView, or press Tab to begin navigating from the first focusable field.
- Press Tab to advance focus to the next field in tab-index order.
- Fields that are hidden, disabled, read-only, or zero-size are skipped.
- For a radio button group, focus lands on the checked button if one exists, or the first button in the group if none is selected.
- Press Shift+Tab to move focus back to the previous focusable field.
- Continue pressing Tab until all required fields are completed.
- Submit the form using the form's submission control when all fields are filled in.
Tip: If a field you expect to reach is not receiving focus, it may be marked as hidden, disabled, or read-only in the form's configuration. For form design questions, see Form creation and management.
Tips
- Start with a tap, then use Tab continuously. After tapping to place focus inside the WebView, you can navigate the entire form without touching the screen again.
- Shift+Tab is useful for corrections. If you move past a field, press Shift+Tab to return to it without scrolling or tapping.
- Radio group navigation is a single step. Tab moves through a radio group as one stop. Use the arrow keys on the hardware keyboard to select a specific option within the group after landing on it.
- Tab-key navigation is iPadOS only. When documenting procedures for staff who work across multiple platforms, note that this keyboard shortcut applies only to iPad with a hardware keyboard. On desktop web, use the browser's native Tab behavior.
- Long forms are faster with keyboard navigation. For forms with many fields, combining Tab navigation with typing eliminates repeated tapping and reduces time spent on form completion.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Pressing Tab does not move focus between fields | Focus may not be inside the form WebView | Tap a field inside the form to place focus inside the WebView first, then use Tab. |
| A field is skipped unexpectedly | The field may be marked hidden, disabled, or read-only in the form's configuration | Verify the field's state in the form builder. For form design changes, see Form creation and management. |
| Focus does not land on the expected radio button | No option is currently selected in the group | When no button is checked, focus lands on the first button in the group. Use the arrow keys to select a specific option. |