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