/**
* @license Copyright (c) 2003-2015, 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,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.
*/