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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-widget",
-  "version": "0.0.0-nightly-20250324.0",
+  "version": "0.0.0-nightly-20250325.0",
   "description": "Widget API for CKEditor 5.",
   "keywords": [
     "ckeditor",
@@ -12,13 +12,13 @@
   "type": "module",
   "main": "src/index.js",
   "dependencies": {
-    "@ckeditor/ckeditor5-core": "0.0.0-nightly-20250324.0",
-    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-20250324.0",
-    "@ckeditor/ckeditor5-enter": "0.0.0-nightly-20250324.0",
-    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-20250324.0",
-    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-20250324.0",
-    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-20250324.0",
-    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-20250324.0",
+    "@ckeditor/ckeditor5-core": "0.0.0-nightly-20250325.0",
+    "@ckeditor/ckeditor5-engine": "0.0.0-nightly-20250325.0",
+    "@ckeditor/ckeditor5-enter": "0.0.0-nightly-20250325.0",
+    "@ckeditor/ckeditor5-icons": "0.0.0-nightly-20250325.0",
+    "@ckeditor/ckeditor5-ui": "0.0.0-nightly-20250325.0",
+    "@ckeditor/ckeditor5-utils": "0.0.0-nightly-20250325.0",
+    "@ckeditor/ckeditor5-typing": "0.0.0-nightly-20250325.0",
     "es-toolkit": "1.32.0"
   },
   "author": "CKSource (http://cksource.com/)",

package/src/utils.d.ts

@@ -89,6 +89,7 @@ export declare function getLabel(element: ViewElement): string;
  * * 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()`}.
@@ -121,10 +122,12 @@ export declare function getLabel(element: ViewElement): string;
  *
  * @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
  */
 export declare function toWidgetEditable(editable: ViewEditableElement, writer: DowncastWriter, options?: {
     label?: string;
+    withAriaRole?: boolean;
 }): ViewEditableElement;
 /**
  * Returns a model range which is optimal (in terms of UX) for inserting a widget block.

package/src/utils.js

@@ -176,6 +176,7 @@ export function getLabel(element) {
  * * 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()`}.
@@ -208,11 +209,15 @@ export function getLabel(element) {
  *
  * @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
  */
 export 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);