AgileApps Support Wiki Pre Release

Keyboard Interaction for AgileApps new UI Accessibility

From AgileApps Support Wiki
Revision as of 15:08, 20 February 2019 by imported>Aeric

This page provides information on all the accessibility features which are achieved using keyboard shortcuts.

Notepad.png

Note: Standard system keyboard commands are not covered in this section.

Accessibility Support

To use these accessibility features, you should have the following:

  • Firefox browser version 52 or later.
  • A screen reader software JAWS Freedom scientific version 17.0

Frequently Used Keys

Following are some of the keys that are commonly used for accessibility:

  • Tab and Shift+Tab - Press the Tab key to move forward to the next element on the user interface, and press Shift+Tab keys to go to the previous element.
  • Right arrow and Left arrow - Move from one item to the next in a radio-button group.
  • Spacebar - Select or de-select the checkbox or radio button that is currently in focus. Can also use to open a file.
  • Enter - Used for clicking a button or a link.
  • Esc - Close a pop-up window.
  • x - Close a toaster that is currently open (works only when there is a Toaster).
  • Backspace/Delete - Press to remove a chip (only works if there are some chips available. For example: - Record Level visibility, Notes Editor).

Quick Access Keys

There are some quick access keys available within the application. These quick access keys are helpful in navigating from one area to another without any tab interaction. In a screen reader, sometimes these keys are not accessible. To make them accessible, press Insert+3 and then press the quick access key to access it.

Access the following quick access keys from the dashboard or the record list view pages:

  • ? - Displays all the quick access keys
  • q - Performs a quick search
  • c - Creates a new record
  • n - Jumps to primary navigation

Access the following quick keys in record details page:

  • m - Jumps to a secondary navigation.
  • ] - Collapses the secondary navigation details panel.
  • s - Saves the current record.

Keyboard Interaction

This sections covers the information about the keyboard interaction with various pages within the application.

Overview Page

Overview page is the home page and is the start page of the application that appears after you log in. It is also accessible by clicking the Home button from the left navigation menu.

It shows all the applications available for a tenant. After you tab out from the left navigation panel, the focus shifts first to the search box. Here, you can type an application name to search. Next to the search box, there is a filter button where you can click and filter the result. These filter items can be accessed using the arrow-up and arrow-down keys. After you click a filter item, the focus returns to the Home button. You can tab out to move through the application names. Click the link to the application name and a confirmation dialog appears. In the Confirmation dialog, the focus is first on the Cancel button. By clicking the OK button, it changes the application.

Record View Page

The Record View list page is available for all objects. Click an object from the left navigation panel, and you are redirected to the object list view page.

  • The initial focus of the Record List view is on the default view.
  • To change the view, you have to use the left and right arrow keys to navigate between the views and then click to select a view.
  • If you tab out from the view section, it will focus to first cell of the first row of the table. Then you can use the keys to interact with the table. Refer to the section Table interaction for interacting with tables.
  • If there is no record present, then you will not see any table.
  • On the top of the view page, there is an Action button. After clicking the action button, you can access the action items using the arrow up and arrow down keys.
  • For a case, case type and tasks object, there is another action button present in the last cell of each row in the table. You can move the focus on this Action button using the tab keys and then press space bar to open the menu. Use the up and down arrow keys to traverse those actions.
  • For case, case type and tasks object, you have a check box at the first cell for each row. When the focus is on this check box, press the space bar to select the check box for that row or if already selected you can deselect the checkbox by pressing the space bar. The action you select from the top action menu becomes applicable on all the rows selected.
  • List view shows 25 records at a time. If a view has more that 25 records, then you can access these records by moving the focus over the pagination button available at the right-hand bottom corner of the page and then pressing the space bar.

Record Details Page

The Record Details page is available for all objects. Click any record to view the Record Details page.

  • The initial focus for a Record details page first focus is the first section of the record form.
  • Record details page contains Left navigation panel, right navigation panel, record form, record banner (for case and task), action menu, record locator, record visibility button, and assign button.
  • Left and right navigation panel items are accessible by using the up and down arrow keys.
  • To work with the Action menu when it is in focus, use the up and down arrow keys.
  • To access the Record visibility dialog, click the lock button at the top of record.
  • To open the Assignment pop-up, click present on the top of the record, In that popup user need to use up and down arrow key to access the access the items.

Record Form

A record form contains multiple types of fields, sub-forms, and related forms. For each type of field, it has different types of keyboard interactions.

  • When user clicks any record, it redirects to the record form and the initial focus is the first section of the form.
  • You can access these sections by using the left and right arrow keys and pressing Enter.
  • To move the focus outside the form section, press tab and the focus will set on the first field of the form.
  • Use the tab and shift+tab keys to move forward or backward between the fields of a form.
  • To select a check box field, press the space bar to activate or deactivate it.
  • To select a radio button, use the space bar and then use the left and right arrow keys to move your selection across radio buttons.
  • When a drop-down list is in focus, press the space bar to view the contents of the list and then use the up and down arrow keys to move up or down across the items. You can select an element even without expanding the list by using the up and down arrow keys.
  • For a date field that is in focus, you can either manually type the date or select a date using the date picker. To select the date picker, tab to bring the date picker in focus and then press Enter or space bar to open the date picker.
  • In the date picker, the first focus is on the current date. Use the left and right arrow key to move to next or previous date and use the up and down arrow keys to move up or down in the date row. When the focus is still inside the date picker, press the tab key to change the focus from date to year section and then press Enter to expand the years list. Use up/down or left/right arrow keys to move the focus between the years.
  • In the years section, each page contains some limited number of years. Press the tab key to move the focus on the previous and next buttons and press Enter to access the previous or next set of years.
  • After you select a year, you will see the month selection page. Use the tab key to highlight a month in the selected year and then select the arrow keys to highlight a month and then press Enter to select the month.
  • After you select a month, you will see the dates for that month. Use the tab key to highlight a date and then use the arrow keys to highlight the date you want to select. Press Enter when that date you want to select is in focus.
  • After you select a date, the focus will return to the date picker button.
  • If it is a date time field, then it will populate the current time in the time field. You have to change the time manually.
  • If it is a Geo location field, then there is a location picker and map button available. Press the tab key to highlight the map button and press Enter to set the coordinates for your location. Once the coordinates are set, you can press the tab key to highlight the location picker, and press Enter to view this location using the browser.
  • You are not allowed to add anything manually for the geo location field.

If it is an image field then first focus will come to the upload button if no image is present. By entering to the upload button it will open an attachment popup, where user has to selct choose item button then click add button to add the image. If there is already an image present in the image field, then first focus will be set to view button, By press enter user can view the image in a separate dialog. the dialog can be closed either by pressing ESC key or by clicking the colose button. After view there is a download button where user can download the image, then there is a delete button, by clcking delete a confirmation dialog will appear user needs press ok button to remove the file. while uploading an image if user wants to overright the image with another then confimation popup will appear with appropriate message. if it is a file field then first focus will set at the select file button. Press enter to upload a file. After uploading a file user it will appear like a chip with delete icon. If a record has already a file then focus will set to the chip. By pressing enter user can see the file in a dialog (it depends on file type, if it is a image it can be visible, but some other extension it will show download button, where user can download the file.). File can be removed only by pressing the delete icon, By clicking delete icon it will ask for a confirmation. If the field is a multiselect picklist, then user has to use up and down arrow to select an element, For selecting multiple element user has to use Shift+Up arrow or Shift+Down arrow. If it is a email filed then thh field has a send email button, by clicking that button it will open you email client software (if you have) by filling To field with the mentioned mail. If it is a lookup field then it contains a search button and a redirect button. By clicking search button it will open a lookup dialog, By clicking redirect button it will redirect to the correspond recod detail page. If a field is disabled or read only then user can not change anything on than only it will focus to the field and read the content. If there is any error in the record form then on save focus will set to the first error field If there is any change in the record and user tries to naviagate away form the form then it will show a popup with proper message. After travershing all the field focus will move to relation information first sections. Those sections can be accessible by using left/right arrow and enter. Then user can interact with its records using like a table (Refer table interaction)