Debian Codegraph @

help/C/preferences_web.page

raw
1 <page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_web">
2 <info>
3 <link type="guide" xref="preferences#application" />
4 <link type="next" xref="preferences_table_navigation" />
5 <title type="sort">1. Web Navigation</title>
6 <title type="link">Web Navigation</title>
7 <desc>
8 Configuring <app>Orca</app>'s support for <app>Firefox</app>,
9 <app>Thunderbird</app>, and <app>Chrome</app>/<app>Chromium</app>
10 </desc>
11 <credit type="author">
12 <name>Joanmarie Diggs</name>
13 <email>[email protected]</email>
14 </credit>
15 <license>
16 <p>Creative Commons Share Alike 3.0</p>
17 </license>
18 </info>
19 <title>Web Navigation Preferences</title>
20 <section id="page_navigation">
21 <title>Page Navigation</title>
22 <p>
23 The <gui>Page Navigation</gui> group of controls make it possible for you
24 to customize how <app>Orca</app> presents, and allow you to interact with,
25 text and other content.
26 </p>
27 <section id="page_navigation_control_caret">
28 <title>Control caret navigation</title>
29 <p>
30 This checkbox toggles <app>Orca</app>'s caret navigation on and off.
31 When it is on, <app>Orca</app> takes control of the caret as you arrow
32 around within a page; when it is off, the browser's native caret navigation is
33 active.
34 </p>
35 <p>
36 Default value: checked
37 </p>
38 <note style="tip">
39 <title>This setting can be toggled on the fly</title>
40 <p>
41 To toggle this setting on the fly without saving it, use
42 <keyseq><key>Orca Modifier</key><key>F12</key></keyseq>.
43 </p>
44 </note>
45 </section>
46 <section id="page_navigation_focus_caret">
47 <title>Automatic focus mode during caret navigation</title>
48 <p>
49 If this checkbox is checked, <app>Orca</app> will automatically turn on
50 focus mode when you use caret navigation commands to navigate to a form
51 field. For example, pressing <key>Down</key> would allow you to move
52 into an entry but once you had done so, Orca would switch to focus mode
53 and subsequent presses of <key>Down</key> would be controlled by the web
54 browser and not by Orca. If this checkbox is not checked, <app>Orca</app>
55 would continue to control what happens when you press <key>Down</key>,
56 thus making it possible to arrow out of the entry and continue reading.
57 </p>
58 <p>
59 Default value: not checked
60 </p>
61 <note style="tip">
62 <title>Manually switching between browse mode and focus mode</title>
63 <p>
64 In order to start or stop interacting with the focused form field,
65 use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
66 between browse mode and focus mode.
67 </p>
68 </note>
69 </section>
70 <section id="page_navigation_structural">
71 <title>Enable structural navigation</title>
72 <p>
73 This checkbox toggles <app>Orca</app>'s
74 <link xref="howto_structural_navigation">Structural Navigation</link>
75 on and off. Structural Navigation allows you to navigate by elements
76 such as headings, links, and form fields.
77 </p>
78 <p>
79 Default value: checked
80 </p>
81 <note style="tip">
82 <title>This setting can be toggled on the fly</title>
83 <p>
84 To toggle this setting on the fly without saving it, use
85 <keyseq><key>Orca Modifier</key><key>Z</key></keyseq>.
86 </p>
87 </note>
88 </section>
89 <section id="page_navigation_focus_structural">
90 <title>Automatic focus mode during structural navigation</title>
91 <p>
92 If this checkbox is checked, <app>Orca</app> will automatically turn on
93 focus mode when you use structural navigation commands to navigate to a
94 form field. For example, pressing <key>E</key> to move to the next entry
95 would move focus there and also turn focus mode on so that your next press
96 of <key>E</key> would type an "e" into that entry. If this checkbox is not
97 checked, then <app>Orca</app> will leave you in browse mode and your next
98 press of <key>E</key> would move you to the next entry on the page.
99 </p>
100 <p>
101 Default value: not checked
102 </p>
103 <note style="tip">
104 <title>Manually switching between browse mode and focus mode</title>
105 <p>
106 In order to start or stop interacting with the focused form field,
107 use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
108 between browse mode and focus mode.
109 </p>
110 </note>
111 </section>
112 <section id="page_navigation_focus_native">
113 <title>Automatic focus mode during native navigation</title>
114 <p>
115 If this checkbox is checked, <app>Orca</app> will automatically turn on
116 focus mode when you use native browser navigation commands to navigate to a
117 form field. For example, pressing <key>Tab</key> to move to the next entry
118 would move focus there and also turn focus mode on so that your next press
119 of <key>E</key> would type an "e" into that entry. If this checkbox is not
120 checked, then <app>Orca</app> will leave you in browse mode and your next
121 press of <key>E</key> would move you to the next entry on the page.
122 </p>
123 <p>
124 Default value: checked
125 </p>
126 <note style="tip">
127 <title>Manually switching between browse mode and focus mode</title>
128 <p>
129 In order to start or stop interacting with the focused form field,
130 use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
131 between browse mode and focus mode.
132 </p>
133 </note>
134 </section>
135 <section id="page_navigation_speak">
136 <title>Automatically start speaking a page when it is first loaded</title>
137 <p>
138 If this checkbox is checked, <app>Orca</app> will perform a Say All on
139 the newly opened web page or email.
140 </p>
141 <p>
142 Default value: checked for Firefox; not checked for Thunderbird
143 </p>
144 </section>
145 <section id="page_navigation_summary">
146 <title>Present summary of a page when it is first loaded</title>
147 <p>
148 If this checkbox is checked, <app>Orca</app> will summarize details about the
149 newly opened web page or email, such as the number of headings, landmarks,
150 and links.
151 </p>
152 <p>
153 Default value: checked for Firefox; not checked for Thunderbird
154 </p>
155 </section>
156 <section id="page_navigation_layout_mode">
157 <title>Enable layout mode for content</title>
158 <p>
159 If this checkbox is checked, <app>Orca</app>'s caret navigation will respect
160 the on-screen layout of the content and present the full line, including any
161 links or form fields on that line. If this checkbox is not checked, <app>Orca</app>
162 will treat objects such as links and form fields as if they were on separate
163 lines, both for presentation and navigation.
164 </p>
165 <p>
166 Default value: checked
167 </p>
168 </section>
169 </section>
170 <section id="table_options">
171 <title>Table Options</title>
172 <note>
173 <p>
174 To learn more about <app>Orca</app>'s options for navigating within
175 tables, please see <link xref="preferences_table_navigation">Table
176 Navigation Preferences</link>.
177 </p>
178 </note>
179 </section>
180 <section id="find_options">
181 <title>Find Options</title>
182 <p>
183 The <gui>Find Options</gui> group of controls make it possible for you to
184 customize how <app>Orca</app> presents the results of a search conducted
185 using the application's built-in search functionality.
186 </p>
187 <section id="find_options_speak_during_find">
188 <title>Speak results during find</title>
189 <p>
190 If this checkbox is checked, <app>Orca</app> will read the line which
191 matches your current search query.
192 </p>
193 <p>
194 Default value: checked
195 </p>
196 </section>
197 <section id="find_options_speak_changed_lines_during_find">
198 <title>Only speak changed lines during find</title>
199 <p>
200 If this checkbox is checked, <app>Orca</app> will not present the
201 matching line if it is the same line as the previous match. This
202 option is designed to prevent "chattiness" on a line with multiple
203 instances of the string for which you are searching.
204 </p>
205 <p>
206 Default value: not checked
207 </p>
208 </section>
209 <section id="find_options_minimum_match_length">
210 <title>Minimum length of matched text</title>
211 <p>
212 This editable spin button is where you can specify the number of
213 characters which must match before <app>Orca</app> announces the
214 matching line. This option is also designed to prevent "chattiness"
215 as there are many matches when you first begin typing the string
216 for which you are searching.
217 </p>
218 <p>
219 Default value: 4
220 </p>
221 </section>
222 </section>
223 </page>