Interaction
By default the dimmed scrim advances the tour and the highlighted element is not tappable. Both are configurable.
Scrim taps
Section titled “Scrim taps”overlayTapBehavior sets what happens when someone taps the dimmed area outside the spotlight:
| Value | Behavior |
|---|---|
'next' (default) |
Advance to the next step. |
'skip' |
End the tour (fires onSkip). |
'none' |
Ignore scrim taps. |
<TourProvider tours={tours} overlayTapBehavior="skip">{/* ... */}</TourProvider>Tap through to the real element
Section titled “Tap through to the real element”Set allowTargetInteraction to let taps reach the highlighted element itself - the spotlight hole becomes interactive while the rest of the screen stays dimmed. Use this for “tap the + button to continue” flows where the tour wants the user to perform the real action.
<TourProvider tours={tours} allowTargetInteraction>{/* ... */}</TourProvider>Guideway makes the four scrim bands around the hole catch taps, while the hole passes them through to your component.
The keyboard
Section titled “The keyboard”Guideway dismisses the keyboard on every step change, so a focused input from one step never leaves the keyboard covering the next tooltip or target.