2 Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.
\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license
\r
6 CKEDITOR.plugins.add( 'contextmenu',
\r
8 requires : [ 'menu' ],
\r
10 beforeInit : function( editor )
\r
12 editor.contextMenu = new CKEDITOR.plugins.contextMenu( editor );
\r
14 editor.addCommand( 'contextMenu',
\r
18 editor.contextMenu.show( editor.document.getBody() );
\r
24 CKEDITOR.plugins.contextMenu = CKEDITOR.tools.createClass(
\r
26 $ : function( editor )
\r
28 this.id = 'cke_' + CKEDITOR.tools.getNextNumber();
\r
29 this.editor = editor;
\r
30 this._.listeners = [];
\r
31 this._.functionId = CKEDITOR.tools.addFunction( function( commandName )
\r
33 this._.panel.hide();
\r
35 editor.execCommand( commandName );
\r
42 onMenu : function( offsetParent, corner, offsetX, offsetY )
\r
44 var menu = this._.menu,
\r
45 editor = this.editor;
\r
54 menu = this._.menu = new CKEDITOR.menu( editor );
\r
55 menu.onClick = CKEDITOR.tools.bind( function( item )
\r
57 var noUnlock = true;
\r
60 if ( CKEDITOR.env.ie )
\r
65 else if ( item.command )
\r
66 editor.execCommand( item.command );
\r
71 menu.onEscape = function()
\r
75 if ( CKEDITOR.env.ie )
\r
76 editor.getSelection().unlock( true );
\r
80 var listeners = this._.listeners,
\r
83 var selection = this.editor.getSelection(),
\r
84 element = selection && selection.getStartElement();
\r
86 menu.onHide = CKEDITOR.tools.bind( function()
\r
90 if ( CKEDITOR.env.ie )
\r
92 var selection = editor.getSelection();
\r
93 selection && selection.unlock();
\r
96 this.onHide && this.onHide();
\r
100 // Call all listeners, filling the list of items to be displayed.
\r
101 for ( var i = 0 ; i < listeners.length ; i++ )
\r
103 var listenerItems = listeners[ i ]( element, selection );
\r
105 if ( listenerItems )
\r
107 for ( var itemName in listenerItems )
\r
109 var item = this.editor.getMenuItem( itemName );
\r
113 item.state = listenerItems[ itemName ];
\r
120 // Don't show context menu with zero items.
\r
121 menu.items.length && menu.show( offsetParent, corner || ( editor.lang.dir == 'rtl' ? 2 : 1 ), offsetX, offsetY );
\r
127 addTarget : function( element, nativeContextMenuOnCtrl )
\r
129 // Opera doesn't support 'contextmenu' event, we have duo approaches employed here:
\r
130 // 1. Inherit the 'button override' hack we introduced in v2 (#4530), while this require the Opera browser
\r
131 // option 'Allow script to detect context menu/right click events' to be always turned on.
\r
132 // 2. Considering the fact that ctrl/meta key is not been occupied
\r
133 // for multiple range selecting (like Gecko), we use this key
\r
134 // combination as a fallback for triggering context-menu. (#4530)
\r
135 if ( CKEDITOR.env.opera )
\r
137 var contextMenuOverrideButton;
\r
138 element.on( 'mousedown', function( evt )
\r
141 if( evt.$.button != 2 )
\r
143 if ( evt.getKeystroke() == CKEDITOR.CTRL + 1 )
\r
144 element.fire( 'contextmenu', evt );
\r
148 if ( nativeContextMenuOnCtrl
\r
149 && ( evt.$.ctrlKey || evt.$.metaKey ) )
\r
152 var target = evt.getTarget();
\r
154 if( !contextMenuOverrideButton )
\r
156 var ownerDoc = target.getDocument();
\r
157 contextMenuOverrideButton = ownerDoc.createElement( 'input' ) ;
\r
158 contextMenuOverrideButton.$.type = 'button' ;
\r
159 ownerDoc.getBody().append( contextMenuOverrideButton ) ;
\r
162 contextMenuOverrideButton.setAttribute( 'style', 'position:absolute;top:' + ( evt.$.clientY - 2 ) +
\r
163 'px;left:' + ( evt.$.clientX - 2 ) +
\r
164 'px;width:5px;height:5px;opacity:0.01' );
\r
168 element.on( 'mouseup', function ( evt )
\r
170 if ( contextMenuOverrideButton )
\r
172 contextMenuOverrideButton.remove();
\r
173 contextMenuOverrideButton = undefined;
\r
174 // Simulate 'contextmenu' event.
\r
175 element.fire( 'contextmenu', evt.data );
\r
180 element.on( 'contextmenu', function( event )
\r
182 var domEvent = event.data;
\r
184 if ( nativeContextMenuOnCtrl &&
\r
185 // Safari on Windows always show 'ctrlKey' as true in 'contextmenu' event,
\r
186 // which make this property unreliable. (#4826)
\r
187 ( CKEDITOR.env.webkit ? holdCtrlKey : domEvent.$.ctrlKey || domEvent.$.metaKey ) )
\r
190 // Selection will be unavailable after context menu shows up
\r
191 // in IE, lock it now.
\r
192 if ( CKEDITOR.env.ie )
\r
194 var selection = this.editor.getSelection();
\r
195 selection && selection.lock();
\r
198 // Cancel the browser context menu.
\r
199 domEvent.preventDefault();
\r
201 var offsetParent = domEvent.getTarget().getDocument().getDocumentElement(),
\r
202 offsetX = domEvent.$.clientX,
\r
203 offsetY = domEvent.$.clientY;
\r
205 CKEDITOR.tools.setTimeout( function()
\r
207 this._.onMenu( offsetParent, null, offsetX, offsetY );
\r
213 if( CKEDITOR.env.webkit )
\r
216 onKeyDown = function( event )
\r
218 holdCtrlKey = event.data.$.ctrlKey || event.data.$.metaKey;
\r
220 resetOnKeyUp = function()
\r
225 element.on( 'keydown', onKeyDown );
\r
226 element.on( 'keyup', resetOnKeyUp );
\r
227 element.on( 'contextmenu', resetOnKeyUp );
\r
231 addListener : function( listenerFn )
\r
233 this._.listeners.push( listenerFn );
\r
236 show : function( offsetParent, corner, offsetX, offsetY )
\r
238 this.editor.focus();
\r
239 this._.onMenu( offsetParent || CKEDITOR.document.getDocumentElement(), corner, offsetX || 0, offsetY || 0 );
\r
245 * Whether to show the browser native context menu when the CTRL or the
\r
246 * META (Mac) key is pressed while opening the context menu.
\r
247 * @name CKEDITOR.config.browserContextMenuOnCtrl
\r
252 * config.browserContextMenuOnCtrl = false;
\r