Descriptive Text

Skip to end of metadata
Go to start of metadata
Search in Domo CenterView 5 Documentation

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.

Note: At this point in time, drilldown to custom JavaScript functions or named destinations within the original Web page is not supported in the Image Template Editor descriptive text output. You may be able to circumvent the JavaScript limitation, however, by customizing the descriptive text template so that it includes a predefined JavaScript library of the functions you need to access.

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,
  1. In Project Browser, click visualization for the image you want.
  2. In Object Properties, select the DLink option checkbox.
To enable the preview of descriptive text in a Web browser,
  1. In the Image Template Editor, click Edit > Preferences.
  2. Click the General tab.
  3. 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.
  4. 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

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.

Note: If a Title box is defined for a visualization, it is always displayed as part of the descriptive text.

For more information about textboxes and title textboxes, see Text Boxes.

Custom Descriptive Text

The 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 Overrides attribute 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 Description attribute 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,
  1. In Object Properties, open the DLink Settings property.
  2. Click the Ellipsis button in the Overrides property to open the Descriptive Text Overrides dialog box.
  3. Select the checkboxes next to the d-link tags you want to override.
  4. (Optional) Click the Preview button on the toolbar to preview the descriptive text changes.
  5. 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.

Labels

released released Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
permalink: http://wiki.domo.com/confluence/x/D4KmAQ