Debian Codegraph @

help/C/howto_tables.page

raw
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>