Wiki source code of XWiki Keyboard Shortcuts
Version 23.1 by Clément Aubin on 2017/11/12
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
12.4 | 1 | {{velocity}} |
| 2 | $xwiki.ssx.use("Features.KeyboardShortcuts") | ||
| 3 | {{/velocity}} | ||
 |
12.1 | 4 | |
 |
8.1 | 5 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 6 | {{toc/}} | ||
| 7 | {{/box}} | ||
 |
1.1 | 8 | |
| |
14.1 | 9 | **Since XWiki version 1.4M1**, you can use keyboard shortcuts to use some XWiki features. Keyboard shortcuts help you save time since you never have to take your hands off the keyboard to use the mouse. |
| |
1.1 | 10 | |
| |
12.1 | 11 | = Using keyboard shortcuts = |
| |
1.1 | 12 | |
| |
12.1 | 13 | == View Mode == |
| |
1.1 | 14 | |
| |
8.1 | 15 | {{info}} |
| 16 | View keyboard shortcuts are only available to advanced users, preventing simple users to get unexpected behavior when pressing keyboard keys by mistake | ||
| 17 | {{/info}} | ||
| |
1.1 | 18 | |
| |
12.1 | 19 | === a) Edit Actions === |
| |
1.1 | 20 | |
| |
12.4 | 21 | (% class="keyboard" summary="Keyboard Shortcuts for View Mode in order to activate edit actions" %) |
| 22 | | (% class="shortcut" %) | ||
| 23 | ((( | ||
| 24 | (% class="key" %)E | ||
 |
13.2 | 25 | )))|Edit the page using the default edition mode |
| |
12.4 | 26 | | (% class="shortcut" %) |
| 27 | ((( | ||
| 28 | (% class="key" %)K | ||
| |
13.2 | 29 | )))|Edit the page in wiki edition mode |
| |
12.4 | 30 | | (% class="shortcut" %) |
| 31 | ((( | ||
| 32 | (% class="key" %)G | ||
| |
13.2 | 33 | )))|Edit the page using the WYSIWYG editor |
| |
12.4 | 34 | | (% class="shortcut" %) |
| 35 | ((( | ||
| 36 | (% class="key" %)F | ||
| |
13.2 | 37 | )))|Inline Form |
| |
12.4 | 38 | | (% class="shortcut" %) |
| 39 | ((( | ||
| 40 | (% class="key" %)R | ||
| |
13.2 | 41 | )))|Edit page access rights |
| |
12.4 | 42 | | (% class="shortcut" %) |
| 43 | ((( | ||
| 44 | (% class="key" %)O | ||
| |
13.2 | 45 | )))|Edit page objects |
| |
12.4 | 46 | | (% class="shortcut" %) |
| 47 | ((( | ||
| 48 | (% class="key" %)S | ||
| |
13.2 | 49 | )))|Edit class |
| |
1.1 | 50 | |
| |
12.1 | 51 | === b) View Actions === |
| |
1.1 | 52 | |
| |
12.4 | 53 | (% class="keyboard" summary="Keyboard Shortcuts for View Mode in order to activate view actions" %) |
| 54 | | (% class="shortcut" %) | ||
| 55 | ((( | ||
| 56 | (% class="key" %)C | ||
| |
13.2 | 57 | )))|Go to page comments |
| |
12.4 | 58 | | (% class="shortcut" %) |
| 59 | ((( | ||
| 60 | (% class="key" %)A | ||
| |
13.2 | 61 | )))|Go to page attachments |
| |
12.4 | 62 | | (% class="shortcut" %) |
| 63 | ((( | ||
| 64 | (% class="key" %)H | ||
| |
13.2 | 65 | )))|Go to page history |
| |
12.4 | 66 | | (% class="shortcut" %) |
| 67 | ((( | ||
 |
13.1 | 68 | (% class="key" %)I |
| |
13.2 | 69 | )))|Go to page information |
| |
13.1 | 70 | | (% class="shortcut" %) |
| 71 | ((( | ||
| |
12.4 | 72 | (% class="key" %)D |
| |
13.2 | 73 | )))|View page wiki code |
| |
1.1 | 74 | |
| |
12.1 | 75 | === c) Other Actions === |
| |
1.1 | 76 | |
| |
12.4 | 77 | (% class="keyboard" summary="Keyboard Shortcuts for View Mode in order to activate other actions" %) |
| 78 | | (% class="shortcut" %) | ||
| 79 | ((( | ||
| 80 | (% class="key" %)F2 | ||
| |
13.2 | 81 | )))|Rename page |
| |
12.4 | 82 | | (% class="shortcut" %) |
| 83 | ((( | ||
| 84 | (% class="key" %)Delete | ||
| |
13.2 | 85 | )))|Delete page |
| |
1.1 | 86 | |
| |
12.1 | 87 | == Edit Wiki & Edit Inline Mode == |
| |
1.1 | 88 | |
| |
8.1 | 89 | {{warning}} |
| |
12.4 | 90 | While in Inline Edit mode and focusing on a WYSIWYG edit area, the keyboard shortcuts listed below won't work since the WYSIWYG editor grabs all the key pressed events. |
| |
8.1 | 91 | {{/warning}} |
| 92 | |||
| |
12.1 | 93 | (% class="keyboard" summary="Keyboard Shortcuts for Edit Wiki and Inline Mode" %) |
| |
12.4 | 94 | | (% class="shortcut" %) |
| 95 | ((( | ||
| 96 | (% class="key" %)Alt(%%) + (% class="key" %)C | ||
| 97 | )))|Cancel edition | ||
| 98 | | (% class="shortcut" %) | ||
| 99 | ((( | ||
| 100 | (% class="key" %)Alt(%%) + (% class="key" %)P | ||
| 101 | )))|Preview the page without saving | ||
| 102 | | (% class="shortcut" %) | ||
| 103 | ((( | ||
| 104 | (% class="key" %)Alt(%%) + (% class="key" %)Shift(%%) + (% class="key" %)S | ||
| 105 | )))|Save and continue to edit the page | ||
| 106 | | (% class="shortcut" %) | ||
| 107 | ((( | ||
| 108 | (% class="key" %)Alt(%%) + (% class="key" %)S | ||
| 109 | )))|Save and view the page | ||
| |
1.1 | 110 | |
| |
12.1 | 111 | == Edit WYSIWYG Mode == |
| |
1.1 | 112 | |
 |
14.3 | 113 | {{include document="platform:Features.WysiwygEditorShortcuts"/}} |
| |
1.1 | 114 | |
| |
12.1 | 115 | == Preview Mode == |
| 116 | |||
| 117 | (% class="keyboard" summary="Keyboard Shortcuts for Preview Mode" %) | ||
| |
12.4 | 118 | | (% class="shortcut" %) |
| 119 | ((( | ||
| 120 | (% class="key" %)Alt(%%) + (% class="key" %)C | ||
| |
13.2 | 121 | )))|Cancel edition |
| |
12.4 | 122 | | (% class="shortcut" %) |
| 123 | ((( | ||
| 124 | (% class="key" %)Alt(%%) + (% class="key" %)B | ||
| |
13.2 | 125 | )))|Back to the edition |
| |
12.4 | 126 | | (% class="shortcut" %) |
| 127 | ((( | ||
| 128 | (% class="key" %)Alt(%%) + (% class="key" %)Shift(%%) + (% class="key" %)S | ||
| |
13.2 | 129 | )))|Save and continue to edit the page |
| |
12.4 | 130 | | (% class="shortcut" %) |
| 131 | ((( | ||
| 132 | (% class="key" %)Alt(%%) + (% class="key" %)S | ||
| |
13.2 | 133 | )))|Save and view the page |
| |
12.1 | 134 | |
 |
11.1 | 135 | == Annotations == |
| 136 | |||
| |
12.1 | 137 | (% class="keyboard" summary="Keyboard Shortcuts for Annotations" %) |
| |
12.4 | 138 | | (% class="shortcut" %) |
| 139 | ((( | ||
| |
13.3 | 140 | (% class="key" %)Ctrl(%%) + (% class="key" %)M(%%) (% class="separator" %)or(%%) (% class="key" %)Meta(%%) + (% class="key" %)M(%%) |
| 141 | (% class="key" %)Ctrl(%%) + (% class="key" %)I(%%) (% class="separator" %)or(%%) (% class="key" %)Meta(%%) + (% class="key" %)I | ||
| |
13.2 | 142 | )))|Annotate a piece of text |
| |
11.1 | 143 | |
| |
12.1 | 144 | == Navigation == |
| |
7.1 | 145 | |
| |
12.1 | 146 | (% class="keyboard" summary="Keyboard Shortcuts for Navigation" %) |
| |
12.4 | 147 | | (% class="shortcut" %) |
| 148 | ((( | ||
| 149 | (% class="key" %)Ctrl(%%) + (% class="key" %)G | ||
| |
13.2 | 150 | )))(% class="separator" %)or(%%) (% class="shortcut" %) |
| |
12.4 | 151 | ((( |
| 152 | (% class="key" %)Meta(%%) + (% class="key" %)G | ||
| 153 | )))|Jump to any page in the wiki | ||
| |
12.1 | 154 | |
| 155 | = Configuring keyboard shortcuts = | ||
| 156 | |||
| 157 | == Modifying keyboard shortcuts == | ||
| 158 | |||
| |
12.3 | 159 | * Create a new page in your wiki, for example //XWiki.KeyboardShortcuts// and paste the following content inside:((( |
| |
12.4 | 160 | {{code}} |
| 161 | core.shortcuts.view.edit=e | ||
| |
7.1 | 162 | core.shortcuts.view.wiki=k |
| 163 | core.shortcuts.view.wysiwyg=g | ||
| 164 | core.shortcuts.view.inline=f | ||
| 165 | core.shortcuts.view.rights=r | ||
| 166 | core.shortcuts.view.objects=o | ||
| 167 | core.shortcuts.view.class=s | ||
| 168 | core.shortcuts.view.comments=c | ||
| 169 | core.shortcuts.view.attachments=a | ||
| 170 | core.shortcuts.view.history=h | ||
| 171 | core.shortcuts.view.information=i | ||
| 172 | core.shortcuts.view.code=d | ||
 |
21.2 | 173 | core.shortcuts.view.delete=Delete |
| 174 | core.shortcuts.view.rename=F2 | ||
| 175 | core.shortcuts.edit.cancel=Alt+C | ||
| 176 | core.shortcuts.edit.backtoedit=Alt+B | ||
| 177 | core.shortcuts.edit.preview=Alt+P | ||
| 178 | core.shortcuts.edit.saveandcontinue=Alt+Shift+S | ||
| 179 | core.shortcuts.edit.saveandview=Alt+S | ||
| |
12.4 | 180 | {{/code}} |
| 181 | ))) | ||
| |
7.1 | 182 | * Modify entries in this list at your convenience |
| 183 | * Save the page | ||
| 184 | * Go to the wiki administration into the "//Programming//" category | ||
| |
12.1 | 185 | * At the bottom, add //XWiki.KeyboardShortcuts// to the "//Internationalization Document Bundles//" list |
| |
7.1 | 186 | |
| |
12.1 | 187 | == Adding your own shortcuts == |
| |
1.1 | 188 | |
| 189 | You can add your own keyboard shortcuts in a few javascript lines : | ||
| 190 | |||
| |
8.1 | 191 | {{code language="html"}} |
| |
1.1 | 192 | <script type="text/javascript"> |
| 193 | //<![CDATA[ | ||
| |
23.1 | 194 | shortcut.add("Ctrl+Alt+n", function() { alert("Hey there! Congratulations on typing this one ;)"); }); |
| |
1.1 | 195 | //]]> |
| 196 | </script> | ||
| |
2.1 | 197 | {{/code}} |
| |
1.1 | 198 | |
| |
6.1 | 199 | {{html clean="false"}} |
| |
1.1 | 200 | <script type="text/javascript"> |
| |
23.1 | 201 | shortcut.add("Ctrl+Alt+n", function() { alert("Hey there! Congratulations on typing this one ;)"); }, {'propagate':false} ); |
| |
1.1 | 202 | </script> |
| |
5.1 | 203 | {{/html}} |
| 204 | |||
| |
12.4 | 205 | Try the snippet by pressing (% class="key" %)**Ctrl**(%%) + (% class="key" %)**Alt**(%%) + (% class="key" %)**n**(%%). |
| |
5.1 | 206 | |
| |
23.1 | 207 | Also check the [[complete documentation>>http://www.openjs.com/scripts/events/keyboard_shortcuts/]]. |
| |
1.1 | 208 | |
| |
12.1 | 209 | == Removing keyboard shortcuts == |
| |
1.1 | 210 | |
| 211 | To remove a shortcut adapt this snippet to your needs : | ||
| 212 | |||
| |
9.1 | 213 | {{code language="html"}} |
| |
1.1 | 214 | <script type="text/javascript"> |
| 215 | //<![CDATA[ | ||
| |
23.1 | 216 | shortcut.remove("Ctrl+Alt+n"); |
| |
1.1 | 217 | //]]> |
| 218 | </script> | ||
| |
2.1 | 219 | {{/code}} |
| |
1.1 | 220 | |
| |
6.1 | 221 | {{html clean="false"}} |
| |
1.1 | 222 | <script type="text/javascript"> |
| |
6.4 | 223 | function removeCtrlAltN() { |
| |
23.1 | 224 | shortcut.remove("Ctrl+Alt+n"); |
| |
1.1 | 225 | } |
| 226 | </script> | ||
| |
6.6 | 227 | <a onclick="removeCtrlAltN(); return false;" href="#">Click here to try the snippet, it will remove the Ctrl+Alt+n shortcut</a>. |
| |
5.1 | 228 | {{/html}} |
| |
1.1 | 229 | |
| |
12.1 | 230 | == Removing all shortcuts at once == |
| |
5.1 | 231 | |
| |
10.1 | 232 | {{code language="html"}} |
| |
5.1 | 233 | <script type="text/javascript"> |
| 234 | //<![CDATA[ | ||
| |
23.1 | 235 | for (binding in shortcut.all_shortcuts) { |
| 236 | shortcut.remove(binding); | ||
| |
5.1 | 237 | } |
| 238 | //]]> | ||
| 239 | </script> | ||
| 240 | {{/code}} | ||
| 241 | |||
| 242 | {{velocity}} | ||
| |
6.5 | 243 | #if (!$isGuest && $isAdvancedUser) |
| |
6.1 | 244 | {{html clean="false"}} |
| |
5.1 | 245 | <script type="text/javascript"> |
| 246 | //<![CDATA[ | ||
| |
6.6 | 247 | function removeAll() { |
| |
23.1 | 248 | for (binding in shortcut.all_shortcuts) { |
| 249 | shortcut.remove(binding); | ||
| |
5.1 | 250 | } |
| |
6.6 | 251 | } |
| |
5.1 | 252 | //]]> |
| 253 | </script> | ||
| |
6.6 | 254 | <a onclick="removeAll(); return false;" href="#">Click here to try the snippet, it will disable all keyboard shortcuts</a>. |
| |
5.1 | 255 | {{/html}} |
| 256 | #end | ||
| |
7.3 | 257 | {{/velocity}} |
| |
5.1 | 258 | |
| |
12.1 | 259 | == Credits == |
| |
1.1 | 260 | |
| |
23.1 | 261 | XWiki keyboard shortcuts are powered by [[openjs.com shortcut library>>http://www.openjs.com/scripts/events/keyboard_shortcuts/]]. |
