Name

$table-accessibility — Accessibility settings for tables.

Parameter:
{}table-accessibility
Defined in:
param.xsl
Used in:
parameter-maps.xsl, modules/tablecals.xsl

Synopsis

$table-accessibility as xs:string* := ('summary', 'details')

Description

The $table-accessibility parameter determines how accessibility features are added to CALS tables*.

The value of this parameter is a list of strings. If the list contains:

summary

A summary attribute will be added to the table if an alt element or a textobject containing a single phrase is available.

details

A details element will be added if there is a textobject containing anything other than a single phrase available.

The list may contain either or both values. If other values are present, they are ignored.

See Example 1.1, An example of table accessibility.

 
<table frame="all">
   <title>Square numbers</title>
   <alt>The first four whole numbers
and their squares.</alt>
   <textobject>
      <para>This table shows the first four whole numbers
and their squares. (The square of a number is that
number times itself.)
</para>
   </textobject>
   <tgroup cols="2" colsep="1" rowsep="1">
      <thead>
         <row>
            <entry>
               <inlineequation>
                  <mathphrase>n</mathphrase>
               </inlineequation>
            </entry>
            <entry>
               <inlineequation>
                  <mathphrase>n<superscript>2</superscript>
                  </mathphrase>
               </inlineequation>
            </entry>
         </row>
      </thead>
      <tbody>
         <row>
            <entry>1</entry>
            <entry>1</entry>
         </row>
         <row>
            <entry>2</entry>
            <entry>4</entry>
         </row>
         <row>
            <entry>3</entry>
            <entry>9</entry>
         </row>
         <row>
            <entry>4</entry>
            <entry>16</entry>
         </row>
      </tbody>
   </tgroup>
</table>
Example 1.1 An example of table accessibility

One possible rendering of such an example:

Table 1.1 Square numbers

This table shows the first four whole numbers and their squares. (The square of a number is that number times itself.)

nn2
11
24
39
416

Inspection of the HTML will reveal that the summary attribute is present on the element that wraps the table and a details element precedes it. These may or may not be rendered by your user agent depending on its accessibility features and settings.

See also $mediaobject-accessibility.