| 1 |
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_tables"> |
| 2 |
<info> |
| 3 |
<link type="guide" xref="index#reading"/> |
| 4 |
<link type="next" xref="howto_forms" /> |
| 5 |
<title type="sort">4. Tables</title> |
| 6 |
<desc> |
| 7 |
Navigating and setting dynamic headers |
| 8 |
</desc> |
| 9 |
<credit type="author"> |
| 10 |
<name>Joanmarie Diggs</name> |
| 11 |
<email>[email protected]</email> |
| 12 |
</credit> |
| 13 |
<license> |
| 14 |
<p>Creative Commons Share Alike 3.0</p> |
| 15 |
</license> |
| 16 |
</info> |
| 17 |
<title>Tables</title> |
| 18 |
<p> |
| 19 |
<app>Orca</app> provides several features specifically designed to improve |
| 20 |
access to tables found in web pages and other documents: configurable cell |
| 21 |
versus row reading, <link xref="howto_structural_navigation">Structural |
| 22 |
Navigation</link> and Dynamic Headers. |
| 23 |
</p> |
| 24 |
<section id="cell_row"> |
| 25 |
<title>Cell Versus Row Reading</title> |
| 26 |
<p> |
| 27 |
Consider the process of examining the list of messages in your Inbox. |
| 28 |
In order to have Orca announce the sender, subject, date, and presence |
| 29 |
of attachments you would need <app>Orca</app> to speak the row. On the |
| 30 |
other hand, when navigating amongst rows in a spreadsheet, hearing the |
| 31 |
full row may not be desired if for no other reason than the sheer number |
| 32 |
of cells in each row. Thus in that case, you would want <app>Orca</app> |
| 33 |
to only speak the cell with focus. Similar situations occur in document |
| 34 |
tables. |
| 35 |
</p> |
| 36 |
<p> |
| 37 |
<app>Orca</app> allows you to customize whether only the cell should be |
| 38 |
read, or if the full row should be, for GUI tables, document tables, |
| 39 |
and spreadsheets. Because these settings are independent of one another, |
| 40 |
you do not have to choose one table reading mode to fit multiple types of |
| 41 |
tables. |
| 42 |
</p> |
| 43 |
<p> |
| 44 |
You can set each of <app>Orca</app>'s table reading preferences <app>Orca</app> |
| 45 |
wide as well as on an application-by-application basis. How to do each is |
| 46 |
described in the guide on <link xref="preferences"><app>Orca</app>'s preferences |
| 47 |
dialogs</link>. The settings can be found on the <link xref="preferences_speech"> |
| 48 |
<gui>Speech</gui> page</link>. |
| 49 |
</p> |
| 50 |
<p> |
| 51 |
Lastly, there is also an <app>Orca</app> command which allows you to toggle |
| 52 |
cell versus row reading on the fly for the currently-active table: |
| 53 |
<keyseq><key>Orca Modifier</key><key>F11</key></keyseq>. |
| 54 |
</p> |
| 55 |
</section> |
| 56 |
<section id="structural_navigation"> |
| 57 |
<title>Structural Navigation</title> |
| 58 |
<p> |
| 59 |
<app>Orca</app>'s <link xref="commands_structural_navigation#tables">table |
| 60 |
Structural Navigation commands</link> make it possible for you to quickly |
| 61 |
locate tables, jump immediately to a table's first or last cell, and |
| 62 |
move to the next cell in any direction. |
| 63 |
</p> |
| 64 |
<p> |
| 65 |
As you navigate amongst and within tables using Structural Navigation, |
| 66 |
<app>Orca</app> will announce additional details to help you understand |
| 67 |
your position, such as the dimensions of the table you just entered and |
| 68 |
the fact that you have reached the edge of the table in the direction you |
| 69 |
are moving. |
| 70 |
</p> |
| 71 |
<p> |
| 72 |
In addition, <app>Orca</app> provides configurable |
| 73 |
<link xref="preferences_table_navigation">presentation options</link> |
| 74 |
which work in conjunction with Structural Navigation and allow you to |
| 75 |
control whether or not cell coordinates are presented, multiple cell spans |
| 76 |
are indicated, and cell headers are announced. |
| 77 |
</p> |
| 78 |
<note style="tip"> |
| 79 |
<title>Don't Forget To Toggle Structural Navigation On!</title> |
| 80 |
<p> |
| 81 |
Depending on where you are, it may be necessary for you to explicitly |
| 82 |
toggle Structural Navigation on before you can use it. To learn more, read |
| 83 |
<link xref="howto_structural_navigation#toggling_required"> |
| 84 |
when toggling Structural Navigation on is required.</link> |
| 85 |
</p> |
| 86 |
</note> |
| 87 |
</section> |
| 88 |
<section id="dynamic_headers"> |
| 89 |
<title>Dynamic Headers</title> |
| 90 |
<p> |
| 91 |
Many of the tables you will encounter while reading have cells which serve |
| 92 |
as the header for a row or a column. Whether or not the creator of that |
| 93 |
table correctly marked those cells as headers is hard to say. In many |
| 94 |
cases, the text was simply formatted to be larger and/or bold. And even if |
| 95 |
the table is correctly marked up, that is no guarantee that the application |
| 96 |
or toolkit exposes that text as header information to assistive technologies. |
| 97 |
<app>Orca</app>'s Dynamic Header support makes it possible to overcome these |
| 98 |
challenges. |
| 99 |
</p> |
| 100 |
<steps> |
| 101 |
<title>Setting Column Headers</title> |
| 102 |
<item> |
| 103 |
<p> |
| 104 |
Move to the row which contains all of the column headers. |
| 105 |
</p> |
| 106 |
</item> |
| 107 |
<item> |
| 108 |
<p> |
| 109 |
Press <keyseq><key>Orca Modifier</key><key>R</key></keyseq> to tell |
| 110 |
<app>Orca</app> that the current row is the one with the headers. |
| 111 |
</p> |
| 112 |
</item> |
| 113 |
</steps> |
| 114 |
<steps> |
| 115 |
<title>Setting Row Headers</title> |
| 116 |
<item> |
| 117 |
<p> |
| 118 |
Move to the column which contains all of the row headers. |
| 119 |
</p> |
| 120 |
</item> |
| 121 |
<item> |
| 122 |
<p> |
| 123 |
Press <keyseq><key>Orca Modifier</key><key>C</key></keyseq> to tell |
| 124 |
<app>Orca</app> that the current column is the one with the headers. |
| 125 |
</p> |
| 126 |
</item> |
| 127 |
</steps> |
| 128 |
<p> |
| 129 |
Having set either the column headers or the row headers, you should find |
| 130 |
that as you navigate amongst the cells, <app>Orca</app> will present each |
| 131 |
header that has changed. Or to put it another way, <app>Orca</app> will |
| 132 |
not present the column header over and over again as you move up or down |
| 133 |
within the current column. Likewise, it will not present the row header |
| 134 |
over and over again as you move left or right within the current row. |
| 135 |
However, if you change rows and there are row headers, the header |
| 136 |
associated with the new row will be presented. And if you change columns |
| 137 |
and there are column headers, the header associated with the new column |
| 138 |
will be presented. |
| 139 |
</p> |
| 140 |
<p> |
| 141 |
To clear headers, simply double-click the command you used to set them. |
| 142 |
Thus double-clicking <keyseq><key>Orca Modifier</key><key>R</key></keyseq> |
| 143 |
tells <app>Orca</app> there are no column headers. Double-clicking |
| 144 |
<keyseq><key>Orca Modifier</key><key>C</key></keyseq> tells <app>Orca</app> |
| 145 |
there are no row headers. |
| 146 |
</p> |
| 147 |
</section> |
| 148 |
</page> |