Skip to content

Commit 59626d4

Browse files
DOC-3209: NVDA would announce iframe_aria_text multiple times. (#3836)
* DOC-3209: NVDA would announce iframe_aria_text multiple times. * Update modules/ROOT/pages/8.1.0-release-notes.adoc Co-authored-by: CODE:AG <[email protected]> --------- Co-authored-by: CODE:AG <[email protected]>
1 parent ffa8cee commit 59626d4

File tree

2 files changed

+19
-0
lines changed

2 files changed

+19
-0
lines changed

modules/ROOT/pages/8.1.0-release-notes.adoc

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -301,6 +301,17 @@ This improvement addresses the link:https://www.w3.org/WAI/WCAG21/Understanding/
301301
// #TINY-vwxyz1
302302

303303
// CCFR here.
304+
=== NVDA would announce iframe_aria_text multiple times
305+
// #TINY-11296
306+
307+
Previously, in certain browsers, when using screen readers such as NVDA or JAWS, the `iframe_aria_text` was either not announced at all or announced twice, causing inconsistent and potentially confusing behavior for users relying on assistive technology. To resolve this, the behavior has been standardized by adjusting how the label is applied:
308+
309+
* in Firefox, the `title` attribute is now set directly on the iframe element and the `aria-label` on the body is not used.
310+
* while in other browsers the `aria-label` is applied to the body inside the iframe without setting a `title` attribute on the iframe.
311+
312+
As a result, `iframe_aria_text` is now consistently announced once across all supported browsers.
313+
314+
For more information, see: xref:accessibility.adoc#iframe_aria_text[iframe_aria_text].
304315

305316
=== Navigating between elements with `+contenteditable="true"+` was not possible on Firefox using the keyboard.
306317
// #TINY-12459

modules/ROOT/partials/configuration/iframe_aria_text.adoc

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,3 +23,11 @@ tinymce.init({
2323
iframe_aria_text: 'Text Editor'
2424
});
2525
----
26+
27+
[NOTE]
28+
====
29+
The `+iframe_aria_text+` option is applied differently depending on the browser to ensure consistent screen reader announcements:
30+
31+
* **Firefox**: The `+title+` attribute is set on the iframe element. The `+aria-label+` on the body is not set.
32+
* **Other browsers**: The `+aria-label+` is set on the body inside the iframe. The `+title+` is not set on the iframe.
33+
====

0 commit comments

Comments
 (0)