Skip to content

accessibility: Standard buttons and radio buttons not in keyboard focus order on macOS #6249

Description

@andyhaskell

Wails version family

v2

Exact Wails version

v2.16.0

Operating System

macOS

Description

On a Wails app, standard HTML buttons don't seem to be in keyboard focus order unless I turn on a screen reader (VoiceOver for me), making this an accessibility blocker for keyboard-only users who do not use screen readers, for example a sighted person who has a motor disability making it difficult to use a mouse. I also am seeing this behavior for radio button elements.

To Reproduce

  1. Create the default Wails app
  2. Place an HTML text input after the "greet" button
  3. Attempt to tab through the UI. Observe that focus order skips over "greet" button, putting the second text input into keyboard focus immediately after the first text input.

Expected behaviour

HTML buttons and radio buttons should appear in keyboard focus

Screenshots

Screen.Recording.2026-10-11.at.2.27.33.PM.mov

Attempted Fixes

No response

System Details

$ wails doctor

                                
          Wails Doctor          
                                

                                                                                                                                                  
# Wails
┌───────────────────┐
| Version | v2.16.0 |
└───────────────────┘

# System
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
| OS           | MacOS                                                                                                                       |
| Version      | 27.0.1                                                                                                                      |
| ID           | 26A434                                                                                                                      |
| Branding     |                                                                                                                             |
| Go Version   | go1.26.5                                                                                                                    |
| Platform     | darwin                                                                                                                      |
| Architecture | arm64                                                                                                                       |
| CPU 1        | Apple M3 Max                                                                                                                |
| CPU 2        | Apple M3 Max                                                                                                                |
| GPU          | Chipset Model: Apple M3 Max Type: GPU Bus: Built-In Total Number of Cores: 40 Vendor: Apple (0x106b) Metal Support: Metal 4 |
| Memory       | 48GB                                                                                                                        |
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

# Dependencies
┌───────────────────────────────────────────────────────────────────────┐
| Dependency                | Package Name | Status    | Version        |
| Xcode command line tools  | N/A          | Installed | 2418           |
| Nodejs                    | N/A          | Installed | 22.18.0        |
| npm                       | N/A          | Installed | 10.9.3         |
| *Xcode                    | N/A          | Installed | 27.0 (27A266a) |
| *upx                      | N/A          | Available |                |
| *nsis                     | N/A          | Available |                |
|                                                                       |
└─────────────────────── * - Optional Dependency ───────────────────────┘

# Diagnosis
Optional package(s) installation details: 
  - upx : Available at https://upx.github.io/
  - nsis : More info at https://wails.io/docs/guides/windows-installer/

 SUCCESS  Your system is ready for Wails development!

 ♥   If Wails is useful to you or your company, please consider sponsoring the project:
https://github.com/sponsors/leaanthony

Additional context

No response

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    BugSomething isn't workingv2

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions