Skip to content

Accessibility: mat-form-field redundant focus on Android WebView with keyboard #31669

@rafalbesztak2

Description

@rafalbesztak2

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:

  1. Create a basic Angular application that includes a form with <mat-form-field> matInput component.
  2. Build this application and run it inside an Android WebView (e.g., in a Capacitor, Cordova, or native Android project).
  3. Connect physical keyboard to the Android device (e.g. bluetooth keyboard connected to Mobile with Android).
  4. 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

Metadata

Metadata

Assignees

Labels

AccessibilityThis issue is related to accessibility (a11y)P3An issue that is relevant to core functions, but does not impede progress. Important, but not urgentarea: material/form-field

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions