From 06bc4f1a0e6c4f4e75cbe6e3d62e2b9eb64e1cb3 Mon Sep 17 00:00:00 2001 From: Jeslyn Bo Date: Thu, 21 May 2026 16:34:53 +1000 Subject: [PATCH 1/2] DOC-2614: Docs: Update iframe_aria_text description to clarify aria-label usage --- .../ROOT/partials/configuration/iframe_aria_text.adoc | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/partials/configuration/iframe_aria_text.adoc b/modules/ROOT/partials/configuration/iframe_aria_text.adoc index 330013f17e..2053ed1b8b 100644 --- a/modules/ROOT/partials/configuration/iframe_aria_text.adoc +++ b/modules/ROOT/partials/configuration/iframe_aria_text.adoc @@ -1,14 +1,17 @@ [[iframe_aria_text]] == `+iframe_aria_text+` -This option is used to customize the `+title+` attribute on the {productname} `+iframe+` element. For example: +This option is used to update the `+aria-label+` applied to the editor content inside the {product name} `+iframe+`. + +The value is set as an `aria-label` on the `` element inside the {product name} iframe document. For example: [source,html] ---- - + ---- -The `+title+` attribute is read by screen-readers to help users identify the editor. This option only applies to {productname} classic (iframe) mode and has no effect on xref:inline-editor-options.adoc#inline[`+inline+` editors]. +Note: +The iframe `+title+` attribute is not modified by this option and remains a fixed value ("Rich Text Area"). *Type:* `+String+` From 09aa4e7022082152a1087fd9cc875ca11cb351de Mon Sep 17 00:00:00 2001 From: Karl Kemister-Sheppard Date: Thu, 4 Jun 2026 15:55:02 +1000 Subject: [PATCH 2/2] DOC-2614: Correct iframe_aria_text description to reflect aria-label behavior Describe the option as setting the editor's accessible name via the body aria-label, fix the {productname} attribute, and restore the iframe-mode scope note. Removes the inaccurate claim that the iframe title is unchanged. --- modules/ROOT/partials/configuration/iframe_aria_text.adoc | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/partials/configuration/iframe_aria_text.adoc b/modules/ROOT/partials/configuration/iframe_aria_text.adoc index 2053ed1b8b..974ab835ba 100644 --- a/modules/ROOT/partials/configuration/iframe_aria_text.adoc +++ b/modules/ROOT/partials/configuration/iframe_aria_text.adoc @@ -1,17 +1,16 @@ [[iframe_aria_text]] == `+iframe_aria_text+` -This option is used to update the `+aria-label+` applied to the editor content inside the {product name} `+iframe+`. +This option sets the accessible name for the editable content area inside the {productname} `+iframe+`. The value is read by screen readers to help users identify the editor. -The value is set as an `aria-label` on the `` element inside the {product name} iframe document. For example: +On most browsers, the value is applied as an `+aria-label+` on the `++` element inside the iframe document. For example: [source,html] ---- ---- -Note: -The iframe `+title+` attribute is not modified by this option and remains a fixed value ("Rich Text Area"). +This option only applies to {productname} classic (iframe) mode and has no effect on xref:inline-editor-options.adoc#inline[`+inline+` editors]. *Type:* `+String+`