Closed Jenneh closed 1 year ago
Tony and I had a brief brainstorm about this last week in a meeting mostly about the continuous integration setup. For the goal of making cells navigable, we are considering prototyping this layout, which would allow for multiple notebooks on the same page:
main
element to enclose all notebooks.article
element for each individual notebook.section
element enclosing each cell with an aria-label
attribute indicating the type of cell, whether code
, markdown
, or raw
.Section elements automatically create landmarks, allowing for the tab key to be used for cell navigation. When moving to each cell, the screen reader should announce the type of cell, contained in the aria-label.
Unresolved questions here:
i think the current state of the code makes it possible to navigate to cells. we added a bunch of the suggestion above to code base. we can try solutions different solutions.
the current working solutions adds tabindex="0"
to code cells only, there is a flag to turn this feature on markdown too (probably is not right though). this decision makes code cells interactive features that folks can tab to.
I'm going to take a look at this again, but I think for now envisioning code cells as an additional interactive element makes sense to me. The markdown areas are already filled with their own HTML semantics.
Problem and context
Cells are a key concept within notebooks. They are clearly visually delineated sections using outlines and color differences. When navigating a notebook with a screen reader, there is no information that cells exist or what type on content they contain.
Counterpoint: For one tester, cells don’t seem to be critical navigation point in this type of document. They were much more interested in content sections in this notebook.
Possible solutions
Ideas:
Acceptance criteria
Tasks to complete