tauri-apps / tauri-apps/tauri

[bug] [Accessibility Issues]Screen reader (NVDA) does not read out loud in a frameless window with `decorations: false` enabled.

Open
#12,901 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

platform: Windows priority: 1 high status: needs triage type: bug
Dominant language
Rust
Stars
111k
Forks
4k
Avg merge
2d 7h
Merged PRs (30d)
45

Description

Describe the bug

I am using TAURI to develop accessible Windows apps.
The current problem is that when I hover the mouse cursor over the text, it no longer reads it out loud.
I use NVDA as my screen reader.
This occurred when I upgraded TAURI from version 2.2.5 to 2.3.1. There was no problem at least until version 2.2.5.
Perhaps some internal logic change since 2.3.0 has affected the issue.
The problem does not occur in a normal window with frames, but only in frameless mode.

Supplemental information

To have the text under the mouse cursor read out loud, the “Mouse” → “Report text at mouse cursor position” checkbox must be checked in the NVDA settings beforehand.

Reproduction

This problem occurred when updating from tauri-build v2.0.5 to v2.0.6 and from tauri v2.2.5 to v2.3.1.
To verify the problem, you can easily reproduce it by creating a new project with pnpm create tauri-app.

Expected behavior

No response

Full tauri info output
[✔] Environment
    - OS: Windows 10.0.22631 x86_64 (X64)
    ✔ WebView2: 133.0.3065.92
    ✔ MSVC:
        - Visual Studio Build Tools 2022
        - Visual Studio Community 2022
    ✔ rustc: 1.85.0 (4d91de4e4 2025-02-17)
    ✔ cargo: 1.85.0 (d73d2caf9 2024-12-31)
    ✔ rustup: 1.27.1 (54dd3d00f 2024-04-24)
    ✔ Rust toolchain: stable-x86_64-pc-windows-msvc (default)
    - node: 22.10.0
    - pnpm: 10.5.2
    - npm: 11.1.0

[-] Packages
    - tauri 🦀: 2.3.1
    - tauri-build 🦀: 2.0.6
    - wry 🦀: 0.50.3
    - tao 🦀: 0.32.7
    - @tauri-apps/api : 2.3.0
    - @tauri-apps/cli : 2.3.1

[-] Plugins
    - tauri-plugin-opener 🦀: 2.2.6
    - @tauri-apps/plugin-opener : 2.2.6

[-] App
    - build-type: bundle
    - CSP: unset
    - frontendDist: ../dist
    - devUrl: http://localhost:1420/
    - framework: React
    - bundler: Vite
Stack trace

Additional context

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with a fresh project from pnpm create tauri-app on Windows, using Tauri 2.3.1 and decorations: false, then compare it with Tauri 2.2.5 while NVDA's mouse-text reporting is enabled. Trace the frameless-window behavior in the Tauri, tao, and wry components; done means NVDA reads text under the mouse in frameless mode without regressing normal framed windows.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
accessibility, desktop, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.