This issue has been created
There are 2 updates, 1 comment.
 
 
XWiki Platform / cid:jira-generated-image-avatar-12f2485e-98f7-495a-9902-d0c492f66dfd XWIKI-23717 Open

BlockNote's editing area fails accessibility tests
 
View issue   ยท   Add comment
 

Issue created

 
cid:jira-generated-image-avatar-3676f9e3-4678-4458-a58c-b0f3ef214fef Marius Dumitru Florea created this issue on 14/Nov/25 14:58
 
Summary: BlockNote's editing area fails accessibility tests
Issue Type: cid:jira-generated-image-avatar-12f2485e-98f7-495a-9902-d0c492f66dfd Bug
Affects Versions: 17.6.0-rc-1
Assignee: Unassigned
Components: Blocknote
Created: 14/Nov/25 14:58
Priority: cid:jira-generated-image-static-major-7e882e8e-4d28-451a-93df-773d1d7033de Major
Reporter: Marius Dumitru Florea
Description:

We get the following failure:

Validation in the test method [minimal]
Check for [org.xwiki.test.ui.po.editor.WYSIWYGEditPage] at [http://xwikiweb:8080/xwiki/bin/edit/NestedBlockNoteIT/minimal/WebHome].
Found [1] items

1: Elements must only use supported ARIA attributes
Description: Ensure an element's role supports its ARIA attributes
Help URL: https://dequeuniversity.com/rules/axe/4.11/aria-allowed-attr?application=axeAPI
Help: Elements must only use supported ARIA attributes
Impact: critical
Tags: cat.aria, wcag2a, wcag412, EN-301-549, EN-9.4.1.2, RGAAv4, RGAA-7.1.1

HTML element: 
 <div aria-autocomplete="list" aria-haspopup="listbox" contenteditable="true" tabindex="0" translate="no" class="ProseMirror bn-editor placeholder-selector-91fdfda5-98a2-4b41-9f0e-250e0c49369b ProseMirror-focused">
Selector: [.ProseMirror]
Fix all of the following:
  ARIA attribute is not allowed: aria-autocomplete="list"
 
 

2 updates

 
cid:jira-generated-image-avatar-3676f9e3-4678-4458-a58c-b0f3ef214fef Changes by Marius Dumitru Florea on 14/Nov/25 15:00
 
Fix Version: 17.10.1
 
cid:jira-generated-image-avatar-3f256543-3b1a-4f0d-a519-a5f196949f50 Changes by Charpentier Lucas on 14/Nov/25 15:02
 
Labels: wcag
 
 

1 comment

 
cid:jira-generated-image-avatar-3676f9e3-4678-4458-a58c-b0f3ef214fef Marius Dumitru Florea on 14/Nov/25 14:59
 

The problem is known to me since I started integrating BlockNote in XWiki. I mentioned it in XWIKI-23025 where I listed known remaining issues to fix after the first version of the integration is released (check the accessibility section / bullet):

.ProseMirror.bn-editor has aria-autocomplete="list" without a proper role (e.g. role="textbox"), see https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-autocomplete#associated&#95;roles

The problem wasn't caught by CI because there was no integration test. Manuel Leduc added a minimal test when working on XWIKI-23459 which lead to the current situation.

The HTML that causes the WCAG failure is not (directly) controlled by us. It's internal to BlockNote / ProseMirror. We can of course write a small JavaScript to locate the `.ProseMirror` DIV and add the missing `role="textbox"` BUT:

  • that's not our responsibility
  • it's internal to BlockNote / ProseMirror which means it can stop working when / if they change the HTML
  • it adds to our technical dept

In any case, before we do anything we need to understand why the BlockNote demo has the `role="textbox"` even though I can't find any code in BlockNote / ProseMirror that might add it. So I have no idea how come the demo editor has it.
 
 
This message was sent by Atlassian Jira (v9.3.0#930000-sha1:287aeb6) Atlassian logo
If image attachments aren't displayed, see this article.