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>joanied@gnome.org</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>
224