python-editor-v3 icon indicating copy to clipboard operation
python-editor-v3 copied to clipboard

Issues accessing intellisense / argument completion with screen reader

Open kmcnaught opened this issue 2 years ago • 2 comments

While writing code, there are two tooltips - intellisense and argument completion. The latter can be triggered automatically or manually, depending on settings.

I'm looking at the accessibility of these tooltips with a screenreader, there are 5 different types of content to discuss - see screenshots below. A - intellisense autocomplete. This plays nicely with NVDA, reading the list of suggestions if you pause typing. B - intellisense docs. I have not managed to get this read out by NVDA C - intellisense links. I have not managed to select these with NVDA D - argument completion docs. I have not managed to get this read out by NVDA E - argument completion links. I have not managed to select these with NVDA

Are there any shortcuts I am missing, or navigation strategies?

Are any/all of these intended to be screen reader accessible, or is the information available elsewhere? (in which case it would be good to have a deliberate decision and this be documented)

screenshot of intellisense tooltip screenshot of argument completion tooltip

kmcnaught avatar Sep 21 '22 10:09 kmcnaught

The information is a subset of the information exposed via the API tab. However, accessing it in a contextual way is very useful.

I think we'd welcome suggestions.

Some of these behaviours are from CodeMirror 6 with various degrees of customisation.

It might be interesting to review Visual Studio Code's approach.

microbit-matt-hillsdon avatar Sep 21 '22 12:09 microbit-matt-hillsdon

My understanding from looking at VSCode (which could be wrong), is that the text in the right hand box is placed in a div outside of the visible area which is read out by the screen reader.

Despite there being a close button and link in the right hand box, I can't find a shortcut to access this area using the keyboard only.

image

microbit-robert avatar Sep 23 '22 09:09 microbit-robert