Wiki source code of XWiki Keyboard Shortcuts

Version 22.2 by Clément Aubin on 2017/11/07

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
22.1	155	== Developer shortcuts ==
	156
22.2	157	The following key sequences can be used to toggle specific actions on the current logged in user:
22.1	158
	159	(% class="keyboard" summary="Keyboard Shortcuts for developers" %)
	160	\| (% class="shortcut" %)
	161	(((
	162	(% class="key" %)x(%%) (% class="key" %)x(%%) (% class="key" %)x(%%) (% class="key" %)a
	163	)))\|Toggle advanced user mode for the current user.
	164
	165	(% class="keyboard" summary="Keyboard Shortcuts for developers" %)
	166	\| (% class="shortcut" %)
	167	(((
	168	(% class="key" %)x(%%) (% class="key" %)x(%%) (% class="key" %)x(%%) (% class="key" %)h
	169	)))\|Toggle hidden pages for the current user.
	170
12.1	171	= Configuring keyboard shortcuts =
	172
	173	== Modifying keyboard shortcuts ==
	174
12.3	175	* Create a new page in your wiki, for example //XWiki.KeyboardShortcuts// and paste the following content inside:(((
12.4	176	{{code}}
	177	core.shortcuts.view.edit=e
7.1	178	core.shortcuts.view.wiki=k
	179	core.shortcuts.view.wysiwyg=g
	180	core.shortcuts.view.inline=f
	181	core.shortcuts.view.rights=r
	182	core.shortcuts.view.objects=o
	183	core.shortcuts.view.class=s
	184	core.shortcuts.view.comments=c
	185	core.shortcuts.view.attachments=a
	186	core.shortcuts.view.history=h
	187	core.shortcuts.view.information=i
	188	core.shortcuts.view.code=d
21.2	189	core.shortcuts.view.delete=Delete
	190	core.shortcuts.view.rename=F2
	191	core.shortcuts.edit.cancel=Alt+C
	192	core.shortcuts.edit.backtoedit=Alt+B
	193	core.shortcuts.edit.preview=Alt+P
	194	core.shortcuts.edit.saveandcontinue=Alt+Shift+S
	195	core.shortcuts.edit.saveandview=Alt+S
12.4	196	{{/code}}
	197	)))
7.1	198	* Modify entries in this list at your convenience
	199	* Save the page
	200	* Go to the wiki administration into the "//Programming//" category
12.1	201	* At the bottom, add //XWiki.KeyboardShortcuts// to the "//Internationalization Document Bundles//" list
7.1	202
12.1	203	== Adding your own shortcuts ==
1.1	204
	205	You can add your own keyboard shortcuts in a few javascript lines :
	206
8.1	207	{{code language="html"}}
1.1	208	<script type="text/javascript">
	209	//<![CDATA[
21.1	210	shortcut.add("Ctrl+Alt+N", function() { alert("Hey there! Congratulations on typing this one ;)"); });
1.1	211	//]]>
	212	</script>
2.1	213	{{/code}}
1.1	214
6.1	215	{{html clean="false"}}
1.1	216	<script type="text/javascript">
21.1	217	shortcut.add("Ctrl+Alt+N", function() { alert("Hey there! Congratulations on typing this one ;)"); });
1.1	218	</script>
5.1	219	{{/html}}
	220
12.4	221	Try the snippet by pressing (% class="key" %)Ctrl(%%) + (% class="key" %)Alt(%%) + (% class="key" %)n(%%).
5.1	222
18.1	223	Also check the [[complete documentation>>https://dmauro.github.io/Keypress/]].
1.1	224
12.1	225	== Removing keyboard shortcuts ==
1.1	226
	227	To remove a shortcut adapt this snippet to your needs :
	228
9.1	229	{{code language="html"}}
1.1	230	<script type="text/javascript">
	231	//<![CDATA[
20.1	232	shortcut.remove("Ctrl+Alt+N");
1.1	233	//]]>
	234	</script>
2.1	235	{{/code}}
1.1	236
6.1	237	{{html clean="false"}}
1.1	238	<script type="text/javascript">
6.4	239	function removeCtrlAltN() {
20.1	240	shortcut.remove("Ctrl+Alt+N");
1.1	241	}
	242	</script>
6.6	243	<a onclick="removeCtrlAltN(); return false;" href="#">Click here to try the snippet, it will remove the Ctrl+Alt+n shortcut</a>.
5.1	244	{{/html}}
1.1	245
12.1	246	== Removing all shortcuts at once ==
5.1	247
10.1	248	{{code language="html"}}
5.1	249	<script type="text/javascript">
	250	//<![CDATA[
15.1	251	for (binding in shortcut.all_shortcuts()) {
	252	shortcut.remove(binding.keys.join(' '));
5.1	253	}
	254	//]]>
	255	</script>
	256	{{/code}}
	257
	258	{{velocity}}
6.5	259	#if (!$isGuest && $isAdvancedUser)
6.1	260	{{html clean="false"}}
5.1	261	<script type="text/javascript">
	262	//<![CDATA[
6.6	263	function removeAll() {
15.1	264	for (binding in shortcut.all_shortcuts()) {
	265	shortcut.remove(binding.keys.join(' '));
5.1	266	}
6.6	267	}
5.1	268	//]]>
	269	</script>
6.6	270	<a onclick="removeAll(); return false;" href="#">Click here to try the snippet, it will disable all keyboard shortcuts</a>.
5.1	271	{{/html}}
	272	#end
7.3	273	{{/velocity}}
5.1	274
12.1	275	== Credits ==
1.1	276
17.1	277	XWiki keyboard shortcuts are powered by [[Keypress JS shortcut library>>https://dmauro.github.io/Keypress/]].

Wiki source code of XWiki Keyboard Shortcuts

Quick Links

Navigation

About

About

Support

Platform

User Guide

Admin Guide

Developer Guide

Projects

XWiki

Extensions

Other

Contribute

Status

Practices

Under the Hood

Get Involved

Get Connected