@ckeditor/ckeditor5-widget 0.0.0-nightly-20250324.0 → 0.0.0-nightly-20250326.0

package/dist/index.js

@@ -278,6 +278,7 @@ import { throttle } from 'es-toolkit/compat';
  * * adds the `ck-editor__editable` and `ck-editor__nested-editable` CSS classes,
  * * adds the `ck-editor__nested-editable_focused` CSS class when the editable is focused and removes it when it is blurred.
  * * implements the {@link ~setHighlightHandling view highlight on widget's editable}.
+ * * sets the `role` attribute to `textbox` for accessibility purposes.
  *
  * Similarly to {@link ~toWidget `toWidget()`} this function should be used in `editingDowncast` only and it is usually
  * used together with {@link module:engine/conversion/downcasthelpers~DowncastHelpers#elementToElement `elementToElement()`}.
@@ -310,13 +311,17 @@ import { throttle } from 'es-toolkit/compat';
  *
  * @param options Additional options.
  * @param options.label Editable's label used by assistive technologies (e.g. screen readers).
+ * @param options.withAriaRole Whether to add the role="textbox" attribute on the editable. Defaults to `true`.
  * @returns Returns the same element that was provided in the `editable` parameter
  */ function toWidgetEditable(editable, writer, options = {}) {
     writer.addClass([
         'ck-editor__editable',
         'ck-editor__nested-editable'
     ], editable);
-    writer.setAttribute('role', 'textbox', editable);
+    // Set role="textbox" only if explicitly requested (defaults to true for backward compatibility).
+    if (options.withAriaRole !== false) {
+        writer.setAttribute('role', 'textbox', editable);
+    }
     writer.setAttribute('tabindex', '-1', editable);
     if (options.label) {
         writer.setAttribute('aria-label', options.label, editable);