Wiki source code of XWiki Keyboard Shortcuts

Version 26.1 by Clément Aubin on 2017/11/27

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