Dynamically populate screen reader text

You can dynamically populate screen reader text with strings from a data source. For example, you can display custom screen reader text for an object that is in French.

The schema you connect to could have the following defined for custom screen reader text: 

<form> 
      <csr dp_csr="csr1"/> 
</form>

The data file you point to could have the following defined for custom screen reader text: 

<form> 
      <csr dp_csr="The 7-digit customer identification field."/> 
</form>

When you merge the data file with the form design, and you start the screen reader, it will read the type of field and then read “The 7-digit customer identification field.”

Before you perform this task, you must ensure the following settings are in effect:

  • Ensure active labels are on. See Set up dynamic properties .

  • Ensure you are connected to a data source that describes the data to which form object properties will be bound. See Connecting to a data source .

  • To test the form with sample data, ensure you are pointing to a data file that has data defined for the form object property. See To preview a form using sample data .

  • Ensure Acrobat is set up to Read Form Fields in the Preferences (Reading category) dialog box in the Edit menu.

  1. In the Object Library palette, click the Standard category and drag an object onto the form design.

    For example, insert a Numeric Field object.

  2. (Optional) In the Object palette, click the Field tab and type a caption for the object in the Caption box.

    For example, type Customer ID .

  3. In the Accessibility palette, click the Custom Screen Reader Text active label.

  4. Select the data connection.

    Note: If you are not already connected to a data source, Default Data Binding is the only selection in the Data Connection list.

  5. Click the triangle beside the Binding box and select a binding.

    For example, select csr > @dp_csr.

    View full size graphic

    The following string appears in the Binding box:

    $record.csr.dp_csr

    You could type this string into the Items box instead of selecting it.

  6. Click OK.

  7. View the form in the Preview PDF tab.

    For example, in the Preview PDF tab, try entering data in the Customer ID field to hear the custom screen reader text.

// Ethnio survey code removed