Many visually impaired persons use the Web. In an effort to equal access to information for users who are visually impaired, Domo provides multiple data visualization solutions that create accessible graphs and maps with descriptive text.
The descriptive text is available for a screen reader device to audibly describe a graph or map so a visually impaired user can understand the graphical information. Domo includes the descriptive text feature to enable inclusion of accessible graphs and maps in all Web content.Domo CenterView Server output is interactive for all users, including the visually impaired. Interactive graphs and maps enable all users to drill down to more in-depth information. Sighted users receive additional information by drilling down to another graph, map, or Web page. Nonsighted users access the same additional information by going from one chart with descriptive text to another chart with descriptive text. As the data changes, the graph or map and the descriptive text automatically change to match the new data. This fulfills the requirements of Section 508 of the Rehabilitation Act, which requires that all graphs and maps must be simultaneously offered in a text format that can easily be interpreted by a screen-reader such as JAWS and IBM Home Page Reader.
Although this law applies only to federal organizations, many private organizations are also realizing the need to provide a method for visually impaired users to access important data.
This section includes the following topics:
Descriptive Text Overview
When you enable descriptive text, a link appears next to the visualization. By default, this link is a blue underlined letter: d.
If you tab to or position your mouse cursor over the d link, a short description appears telling you what clicking the link does. As a screen reader reads this descriptive text link, it indicates that descriptive text is available for the image. You then have the option of having the screen reader read the description of the visualization.
This descriptive text link contains the title for the image. There are several ways to set the title for an image:
- setting the title using the PCScript method
main.title(This is my title), which sets the title without altering anything else in the image
- setting the value of the Title textbox using the PCScript method
title.setText(This is my title), which sets both the value in the textbox and the title displayed in the description of the d link.
- setting a textbox as the Title textbox
Clicking the link displays the textual description of the chart.
Descriptive Text Example
The following graph has a descriptive text link, drilldowns, and a single instance of hover text. If you were to click the d link in the following graph,
then the following descriptive text would appear:
This data is fully interactive. What would appear as hover text in a graphical visualization appears as text right beside the description for each item. Likewise, drilldown links appear next to each item that is enabled for drilldown effects. Visually impaired users are able to drill down from this descriptive text to another visualization with d link descriptive text. If set, the image title appears.
Enabling Descriptive Text
When creating an Image Template file with the Image Template Editor, you can enable descriptive text for use with dynamic data from Domo CenterView Server. You can also set a preference for the Image Template Editor to generate descriptive text for the visually impaired with each Web browser preview.
To enable descriptive text for use with dynamic data,
- In Project Browser, click
visualizationfor the image you want.
- In Object Properties, select the
To enable the preview of descriptive text in a Web browser,
- In the Image Template Editor, click Edit > Preferences.
- Click the General tab.
- In the Preview options area, select the Create D-Link descriptive text option checkbox and type your two-letter language code in the Language textbox beneath it.
- Click OK.
Configuring Descriptive Text
Configure descriptive settings in the
DLink Settings property. More information about this property is available in the XML Object Reference.
The Image Template Editor lets you manage the specifics of descriptive text output in the following ways:
- Descriptive Text Title
- Custom Descriptive Text
- Descriptive Text Overrides
- Modifying the Descriptive Text Template
Descriptive Text Title
When Domo CenterView Server generates descriptive text, it uses the contents of the textbox set as the Title textbox for the title that appears at the top of the descriptive text information. Modifying the Title textbox in a visualization changes the descriptive text title that appears in the descriptive text information.
For more information about textboxes and title textboxes, see Text Boxes.
Custom Descriptive Text
Description Type attribute in the
DLink Settings property lets you configure descriptive text for either automatic or manual generation.
- Automatic: Uses the descriptive text template to automatically generate descriptive text content. Use the
Overridesattribute to add or remove specific visualization content from descriptive text. For more information, see Descriptive Text Overrides.
- Manual: Disables automatic descriptive text generation and relies solely on the content you specify in the
Descriptionattribute and the contents of the Title box, if one is defined.
Descriptive Text Overrides
The Image Template Editor gives you complete control over the objects in a descriptive text-enabled project and how those objects are described. A descriptive text template file defines the object settings for a project, but Object Properties let you override the template settings on a object-by-object basis.
To override descriptive text template settings,
- In Object Properties, open the
- Click the Ellipsis button in the
Overridesproperty to open the Descriptive Text Overrides dialog box.
- Select the checkboxes next to the d-link tags you want to override.
- (Optional) Click the Preview button on the toolbar to preview the descriptive text changes.
- When finished, click OK.
Modifying the Descriptive Text Template
From the standpoint of a novice user, modifying the descriptive text template might be the most difficult method of changing the descriptive text format because of the steep learning curve involved in understanding how the template works. For advanced users, however, this is a powerful and convenient way to control descriptive text. For more information, see Descriptive Text Settings.