/** * @license Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved. * For licensing, see LICENSE.md or http://ckeditor.com/license */ /** * @fileOverview The "elementspath" plugin. It shows all elements in the DOM * parent tree relative to the current selection in the editing area. */ ( function() { var commands = { toolbarFocus: { editorFocus: false, readOnly: 1, exec: function( editor ) { var idBase = editor._.elementsPath.idBase; var element = CKEDITOR.document.getById( idBase + '0' ); // Make the first button focus accessible for IE. (#3417) // Adobe AIR instead need while of delay. element && element.focus( CKEDITOR.env.ie || CKEDITOR.env.air ); } } }; var emptyHtml = ' '; var extra = ''; // Some browsers don't cancel key events in the keydown but in the // keypress. // TODO: Check if really needed. if ( CKEDITOR.env.gecko && CKEDITOR.env.mac ) extra += ' onkeypress="return false;"'; // With Firefox, we need to force the button to redraw, otherwise it // will remain in the focus state. if ( CKEDITOR.env.gecko ) extra += ' onblur="this.style.cssText = this.style.cssText;"'; var pathItemTpl = CKEDITOR.addTemplate( 'pathItem', '' + '{text}' + '' ); CKEDITOR.plugins.add( 'elementspath', { // jscs:disable maximumLineLength lang: 'af,ar,bg,bn,bs,ca,cs,cy,da,de,de-ch,el,en,en-au,en-ca,en-gb,eo,es,et,eu,fa,fi,fo,fr,fr-ca,gl,gu,he,hi,hr,hu,is,it,ja,ka,km,ko,ku,lt,lv,mk,mn,ms,nb,nl,no,pl,pt,pt-br,ro,ru,si,sk,sl,sq,sr,sr-latn,sv,th,tr,tt,ug,uk,vi,zh,zh-cn', // %REMOVE_LINE_CORE% // jscs:enable maximumLineLength init: function( editor ) { editor._.elementsPath = { idBase: 'cke_elementspath_' + CKEDITOR.tools.getNextNumber() + '_', filters: [] }; editor.on( 'uiSpace', function( event ) { if ( event.data.space == 'bottom' ) initElementsPath( editor, event.data ); } ); } } ); function initElementsPath( editor, bottomSpaceData ) { var spaceId = editor.ui.spaceId( 'path' ), spaceElement, getSpaceElement = function() { if ( !spaceElement ) spaceElement = CKEDITOR.document.getById( spaceId ); return spaceElement; }, elementsPath = editor._.elementsPath, idBase = elementsPath.idBase; bottomSpaceData.html += '' + editor.lang.elementspath.eleLabel + '' + '' + emptyHtml + ''; // Register the ui element to the focus manager. editor.on( 'uiReady', function() { var element = editor.ui.space( 'path' ); element && editor.focusManager.add( element, 1 ); } ); function onClick( elementIndex ) { var element = elementsPath.list[ elementIndex ]; if ( element.equals( editor.editable() ) || element.getAttribute( 'contenteditable' ) == 'true' ) { var range = editor.createRange(); range.selectNodeContents( element ); range.select(); } else { editor.getSelection().selectElement( element ); } // It is important to focus() *after* the above selection // manipulation, otherwise Firefox will have troubles. #10119 editor.focus(); } elementsPath.onClick = onClick; var onClickHanlder = CKEDITOR.tools.addFunction( onClick ), onKeyDownHandler = CKEDITOR.tools.addFunction( function( elementIndex, ev ) { var idBase = elementsPath.idBase, element; ev = new CKEDITOR.dom.event( ev ); var rtl = editor.lang.dir == 'rtl'; switch ( ev.getKeystroke() ) { case rtl ? 39 : 37: // LEFT-ARROW case 9: // TAB element = CKEDITOR.document.getById( idBase + ( elementIndex + 1 ) ); if ( !element ) element = CKEDITOR.document.getById( idBase + '0' ); element.focus(); return false; case rtl ? 37 : 39: // RIGHT-ARROW case CKEDITOR.SHIFT + 9: // SHIFT + TAB element = CKEDITOR.document.getById( idBase + ( elementIndex - 1 ) ); if ( !element ) element = CKEDITOR.document.getById( idBase + ( elementsPath.list.length - 1 ) ); element.focus(); return false; case 27: // ESC editor.focus(); return false; case 13: // ENTER // Opera case 32: // SPACE onClick( elementIndex ); return false; } return true; } ); editor.on( 'selectionChange', function() { var html = [], elementsList = elementsPath.list = [], namesList = [], filters = elementsPath.filters, isContentEditable = true, // Use elementPath to consider children of editable only (#11124). elementsChain = editor.elementPath().elements, name; // Starts iteration from body element, skipping html. for ( var j = elementsChain.length; j--; ) { var element = elementsChain[ j ], ignore = 0; if ( element.data( 'cke-display-name' ) ) name = element.data( 'cke-display-name' ); else if ( element.data( 'cke-real-element-type' ) ) name = element.data( 'cke-real-element-type' ); else name = element.getName(); isContentEditable = element.hasAttribute( 'contenteditable' ) ? element.getAttribute( 'contenteditable' ) == 'true' : isContentEditable; // If elem is non-contenteditable, and it's not specifying contenteditable // attribute - then elem should be ignored. if ( !isContentEditable && !element.hasAttribute( 'contenteditable' ) ) ignore = 1; for ( var i = 0; i < filters.length; i++ ) { var ret = filters[ i ]( element, name ); if ( ret === false ) { ignore = 1; break; } name = ret || name; } if ( !ignore ) { elementsList.unshift( element ); namesList.unshift( name ); } } for ( var iterationLimit = elementsList.length, index = 0; index < iterationLimit; index++ ) { name = namesList[ index ]; var label = editor.lang.elementspath.eleTitle.replace( /%1/, name ), item = pathItemTpl.output( { id: idBase + index, label: label, text: name, jsTitle: 'javascript:void(\'' + name + '\')', // jshint ignore:line index: index, keyDownFn: onKeyDownHandler, clickFn: onClickHanlder } ); html.unshift( item ); } var space = getSpaceElement(); space.setHtml( html.join( '' ) + emptyHtml ); editor.fire( 'elementsPathUpdate', { space: space } ); } ); function empty() { spaceElement && spaceElement.setHtml( emptyHtml ); delete elementsPath.list; } editor.on( 'readOnly', empty ); editor.on( 'contentDomUnload', empty ); editor.addCommand( 'elementsPathFocus', commands.toolbarFocus ); editor.setKeystroke( CKEDITOR.ALT + 122 /*F11*/, 'elementsPathFocus' ); } } )(); /** * Fired when the contents of the elementsPath are changed. * * @event elementsPathUpdate * @member CKEDITOR.editor * @param {CKEDITOR.editor} editor This editor instance. * @param data * @param {CKEDITOR.dom.element} data.space The elementsPath container. */