Loading

Using the Field Dependency Matrix with a Keyboard or Screen Reader

Fecha de publicación: Jul 12, 2023
Descripción

The interface for configuring field dependencies is accessible for keyboard-only and screen reader users. There are some differences in operation along with visual formatting styling in the field dependency matrix which may impact these user groups.

Solución

Introduction

The field dependency matrix is a table which lets you specify the dependent picklist values that are available when a user selects each controlling field value.
The top row of the matrix table contains all the values of the controlling field, while the columns list the dependent field values.
Use this table to include or exclude values. Included values are available in the dependent picklist when a value in the controlling field is selected.
Excluded fields are not available in the dependent picklist for the selected controlling field value.

Note: JAWS 2023 users have reported an inability to navigate the table and select the correct cells once the first value has been included. There is a mismatch between the column JAWS reads and the location where focus is placed in the table for cell activation. JAWS 2022 and NVDA do not seem to be impacted by this issue.
 

Understanding the Interface

The Edit Field Dependency page contains two tables.
The first table is titled Legend. It is a color key showing how dependent picklist values will visually appear within the matrix table when they have been included or excluded for a controlling field value. It contains one column and two rows.
Navigate to a cell in the Legend table and perform the keyboard command to have your screen reader speak formatting information including color and font for text at your current cursor position.
JAWS desktop keyboard layout: Press INSERT + F to hear font information. Press INSERT + 5 on the number row to hear color information for text and background.
JAWS keyboard laptop layout: Press CAPS LOCK + F to hear font information. Press CAPS LOCK + 5 on the number row to hear color information for text and background.
NVDA desktop and laptop keyboard layout: Press NVDA + F to hear both font and color information for text and background.
Performing this command on the words Excluded Value in the Legend table shows the text is in italics and is gray on a white background.
Performing this command on the words Included Value shows the text is bolded and is black against a yellow background.
Values for the dependent picklist will show these colors and formatting styles in the matrix table depending on their status of included or excluded.

The second table is the field dependency matrix. In this table, the column headers represent values in the controlling field. Within each column, all possible values for the dependent picklist are shown. The size of this table will vary depending on how many values exist for the controlling and dependent fields.
 

Including Values

  1. Locate the column for the controlling field value you wish to modify
  2. Move down the column of the desired controlling field value.
  3. Press ENTER on the first dependent value you wish to include.
  4. Activate the Include Values button.
 

A Note for Screen Reader Users

If using JAWS, pressing ENTER on a table cell for the first time after the page loads seems to lose focus. Navigate back to the desired dependent picklist value and press ENTER again to select it, then activate the Include Values button. NVDA does not display this behavior. JAWS does not display this behavior after the first time the user presses ENTER on the page.
Excluding Values
  1. Locate the column for the controlling field value you wish to modify
  2. Move down the column of the desired controlling field value.
  3. Press ENTER on the dependent picklist value you wish to exclude.
  4. Activate the Exclude Values button. All values are excluded by default when creating a new field dependency.
 

Making multiple selections

Currently, keyboard functionality doesn’t allow a user to select multiple values to include or exclude. You must select each value one at a time, activate the button to include or exclude the value, then proceed to the next value you wish to modify.
 

Changing the values in your view of the matrix

  • If the controlling field contains more values than the matrix can display on-screen, use the Previous and Next links located above the table to scroll the matrix horizontally. This will display more values.
  • Activate the View All link to view all available values in the matrix at once.
  • If View All is enabled, activate the View sets of 5 link to toggle back to viewing 5 columns at a time.
  • If View Sets of 5 is enabled, activate the Go To link and choose a controlling value from the picklist. This will scroll the matrix to bring the desired column into view.
 

Previewing your Selections

There are two ways a user can preview included values before saving the field dependency configuration.
  1. Review each individual table cell for every controlling field value column. For each cell, perform the command to have your screen reader speak text formatting information. Values marked for inclusion will be bolded black text on a yellow background. Excluded values will be in italics and the text will be gray on a white background
  2. Alternatively, activate the Preview button and select a controlling field value from the first dropdown. Review the second dropdown and ensure all desired dependent picklist values are present for that value. Repeat for the remaining controlling field values. Activate the Close button to return to the field dependency matrix.
 
Be sure to activate the Save button to create the new field dependency.
Número del artículo de conocimiento

000393424

 
Cargando
Salesforce Help | Article