Web Accessibility Restrictions
The shadowDom (hidden table accessible only to screen readers) used in RealGridJS was removed and changed to use the grid visible on the screen. Most functions can be used regardless of web accessibility, but functions using the mouse (sorting/filtering, etc.) cannot be performed the same way using auxiliary devices, so you must use the API or refrain from using them.
Limitations
- Row grouping mode and multi-level column groups are not supported.
- fixedColumn is not supported.
- Cannot access footer or headerSummary.
- <button>,<a> using customRenderer or templateRenderer If you use tag, you cannot use the click event.
- If accessibility is set to
true
, when you enter a key in a cell, it will not change to edit mode immediately, but you must use theF2
key or double-click to change to edit mode before using it. - If the cell contains content that the reader cannot read, you must use renderer.ariaLabelCallback to enable the reader to read it.
- People with physical disabilities or visual impairments cannot use a mouse, so they should refrain from using mouse-related events. You cannot click on the header to sort or use filters.
- You cannot use the check bar separately. (If you need to use the check bar, please contact the technical support team.)
- You cannot use input tags, etc. through the column header template.
Virtual cursor
- In order for visually impaired people to use the grid, they must disable the virtual cursor before using it.
- Some screen readers automatically release the virtual cursor when focus is placed on the grid.
- When the virtual cursor is set, the
table
that is the basis of the grid, not the grid, is read.
Keyboard accessibility
- To move to another element in the grid, change the editOption.exitGridWhenTab property to
grid
orrow
. Or, if you set editOptions.useTabKey tofalse
, entering thetab
key moves to the next element. - In an editor with a list, change to editing mode and press alt+down to display the list. When the list is displayed, use the down/up keys to move to the desired data and then enter it using the enter key.
- To check or uncheck the check in the checkBar, type ctrl+shift+space (windows) or command+shift+space (mac).
- Renderers with basic actions, such as linkRenderer and buttonRenderer, execute basic actions when
spaceKey
is entered. Additionally, to execute usingenterKey
, set renderer.enterKey totrue
. - For checkRenderer, only
spaceKey
is available.
※ Accessibility-related options
When creating a grid, you must add the third option as shown below.
gridView = new RealGrid.GridView("realgrid", true, waiOptions);
The default values of waiOptions are as follows.
waiOptions = {
title: "Real Grid Table (Functions such as button links are executed with the Enter key in the table)",
description: "A data table consisting of ${columns} columns.",
};
- If nothing is specified, it will be set as default.
- Set the title and description appropriate for each screen.