-
Notifications
You must be signed in to change notification settings - Fork 6.8k
Description
Is this a regression?
- Yes, this behavior used to work in the previous version
The previous version in which this bug was not present was
No response
Description
When navigating an Angular Material application within an Android WebView using an external keyboard (Accessibility), the <div class="mat-mdc-text-field-wrapper mdc-text-field">
inside a <mat-form-field>
incorrectly receives keyboard focus.
This is caused by a known behavior in Android's WebView where any element with a keyboard event is added to the tab order. The div has a click listener, presumably to focus the native <input>
when any part of the field is clicked.
This results in a redundant tab stop, creating a confusing navigation experience for keyboard users.
The recommended fix is to add tabindex="-1"
to the div.mat-mdc-text-field-wrapper. This will remove the element from focus sequence while preserving its click functionality.
The error probably occurs in other Angular Material components, so please fix it there as well.
Reproduction
Sample usage of component - to be verified on Adroid WebView!
StackBlitz link: https://stackblitz.com/edit/components-issue-starter-jwyrngj8?file=src%2Fmain.ts
Steps to reproduce:
- Create a basic Angular application that includes a form with
<mat-form-field>
matInput component. - Build this application and run it inside an Android WebView (e.g., in a Capacitor, Cordova, or native Android project).
- Connect physical keyboard to the Android device (e.g. bluetooth keyboard connected to Mobile with Android).
- Open the app and use the Tab key to navigate through the page elements.
Expected Behavior
When tabbing towards a mat-form-field, focus should move directly from the previously focused element to the inner <input>
element. The wrapper div (.mat-mdc-text-field-wrapper) should be skipped entirely in the tab order, as it is not an interactive control itself.
Actual Behavior
The keyboard focus first lands on the div.mat-mdc-text-field-wrapper. The user must then press Tab a second time to move focus from the wrapper to the actual <input>
element. This creates a "ghost" tab stop that provides no user-facing functionality and disrupts the logical navigation flow.
Environment
- Angular: any from 5.2.5 to 20.1.5 (latest)
- CDK/Material: any from 5.2.5 to 20.1.5 (latest)
- Browser(s): Android System WebView
- Operating System: verified on Android 14 and 15