/** * @license Copyright (c) 2003-2014, CKSource - Frederico Knabben. All rights reserved. * For licensing, see LICENSE.md or http://ckeditor.com/license */ CKEDITOR.plugins.add( 'link', { requires: 'dialog,fakeobjects', 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,id,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,ug,uk,vi,zh,zh-cn', // %REMOVE_LINE_CORE% icons: 'anchor,anchor-rtl,link,unlink', // %REMOVE_LINE_CORE% hidpi: true, // %REMOVE_LINE_CORE% onLoad: function() { // Add the CSS styles for anchor placeholders. var iconPath = CKEDITOR.getUrl( this.path + 'images' + ( CKEDITOR.env.hidpi ? '/hidpi' : '' ) + '/anchor.png' ), baseStyle = 'background:url(' + iconPath + ') no-repeat %1 center;border:1px dotted #00f;background-size:16px;'; var template = '.%2 a.cke_anchor,' + '.%2 a.cke_anchor_empty' + ',.cke_editable.%2 a[name]' + ',.cke_editable.%2 a[data-cke-saved-name]' + '{' + baseStyle + 'padding-%1:18px;' + // Show the arrow cursor for the anchor image (FF at least). 'cursor:auto;' + '}' + ( CKEDITOR.plugins.link.synAnchorSelector ? ( 'a.cke_anchor_empty' + '{' + // Make empty anchor selectable on IE. 'display:inline-block;' + // IE11 doesn't display empty inline-block elements. ( CKEDITOR.env.ie && CKEDITOR.env.version > 10 ? 'min-height:16px;vertical-align:middle' : '' ) + '}' ) : '' ) + '.%2 img.cke_anchor' + '{' + baseStyle + 'width:16px;' + 'min-height:15px;' + // The default line-height on IE. 'height:1.15em;' + // Opera works better with "middle" (even if not perfect) 'vertical-align:' + ( CKEDITOR.env.opera ? 'middle' : 'text-bottom' ) + ';' + '}'; // Styles with contents direction awareness. function cssWithDir( dir ) { return template.replace( /%1/g, dir == 'rtl' ? 'right' : 'left' ).replace( /%2/g, 'cke_contents_' + dir ); } CKEDITOR.addCss( cssWithDir( 'ltr' ) + cssWithDir( 'rtl' ) ); }, init: function( editor ) { var allowed = 'a[!href]', required = 'a[href]'; if ( CKEDITOR.dialog.isTabEnabled( editor, 'link', 'advanced' ) ) allowed = allowed.replace( ']', ',accesskey,charset,dir,id,lang,name,rel,tabindex,title,type]{*}(*)' ); if ( CKEDITOR.dialog.isTabEnabled( editor, 'link', 'target' ) ) allowed = allowed.replace( ']', ',target,onclick]' ); // Add the link and unlink buttons. editor.addCommand( 'link', new CKEDITOR.dialogCommand( 'link', { allowedContent: allowed, requiredContent: required } ) ); editor.addCommand( 'anchor', new CKEDITOR.dialogCommand( 'anchor', { allowedContent: 'a[!name,id]', requiredContent: 'a[name]' } ) ); editor.addCommand( 'unlink', new CKEDITOR.unlinkCommand() ); editor.addCommand( 'removeAnchor', new CKEDITOR.removeAnchorCommand() ); editor.setKeystroke( CKEDITOR.CTRL + 76 /*L*/, 'link' ); if ( editor.ui.addButton ) { editor.ui.addButton( 'Link', { label: editor.lang.link.toolbar, command: 'link', toolbar: 'links,10' } ); editor.ui.addButton( 'Unlink', { label: editor.lang.link.unlink, command: 'unlink', toolbar: 'links,20' } ); editor.ui.addButton( 'Anchor', { label: editor.lang.link.anchor.toolbar, command: 'anchor', toolbar: 'links,30' } ); } CKEDITOR.dialog.add( 'link', this.path + 'dialogs/link.js' ); CKEDITOR.dialog.add( 'anchor', this.path + 'dialogs/anchor.js' ); editor.on( 'doubleclick', function( evt ) { var element = CKEDITOR.plugins.link.getSelectedLink( editor ) || evt.data.element; if ( !element.isReadOnly() ) { if ( element.is( 'a' ) ) { evt.data.dialog = ( element.getAttribute( 'name' ) && ( !element.getAttribute( 'href' ) || !element.getChildCount() ) ) ? 'anchor' : 'link'; editor.getSelection().selectElement( element ); } else if ( CKEDITOR.plugins.link.tryRestoreFakeAnchor( editor, element ) ) evt.data.dialog = 'anchor'; } } ); // If the "menu" plugin is loaded, register the menu items. if ( editor.addMenuItems ) { editor.addMenuItems( { anchor: { label: editor.lang.link.anchor.menu, command: 'anchor', group: 'anchor', order: 1 }, removeAnchor: { label: editor.lang.link.anchor.remove, command: 'removeAnchor', group: 'anchor', order: 5 }, link: { label: editor.lang.link.menu, command: 'link', group: 'link', order: 1 }, unlink: { label: editor.lang.link.unlink, command: 'unlink', group: 'link', order: 5 } } ); } // If the "contextmenu" plugin is loaded, register the listeners. if ( editor.contextMenu ) { editor.contextMenu.addListener( function( element, selection ) { if ( !element || element.isReadOnly() ) return null; var anchor = CKEDITOR.plugins.link.tryRestoreFakeAnchor( editor, element ); if ( !anchor && !( anchor = CKEDITOR.plugins.link.getSelectedLink( editor ) ) ) return null; var menu = {}; if ( anchor.getAttribute( 'href' ) && anchor.getChildCount() ) menu = { link: CKEDITOR.TRISTATE_OFF, unlink: CKEDITOR.TRISTATE_OFF }; if ( anchor && anchor.hasAttribute( 'name' ) ) menu.anchor = menu.removeAnchor = CKEDITOR.TRISTATE_OFF; return menu; } ); } }, afterInit: function( editor ) { // Register a filter to displaying placeholders after mode change. var dataProcessor = editor.dataProcessor, dataFilter = dataProcessor && dataProcessor.dataFilter, htmlFilter = dataProcessor && dataProcessor.htmlFilter, pathFilters = editor._.elementsPath && editor._.elementsPath.filters; if ( dataFilter ) { dataFilter.addRules( { elements: { a: function( element ) { var attributes = element.attributes; if ( !attributes.name ) return null; var isEmpty = !element.children.length; if ( CKEDITOR.plugins.link.synAnchorSelector ) { // IE needs a specific class name to be applied // to the anchors, for appropriate styling. var ieClass = isEmpty ? 'cke_anchor_empty' : 'cke_anchor'; var cls = attributes[ 'class' ]; if ( attributes.name && ( !cls || cls.indexOf( ieClass ) < 0 ) ) attributes[ 'class' ] = ( cls || '' ) + ' ' + ieClass; if ( isEmpty && CKEDITOR.plugins.link.emptyAnchorFix ) { attributes.contenteditable = 'false'; attributes[ 'data-cke-editable' ] = 1; } } else if ( CKEDITOR.plugins.link.fakeAnchor && isEmpty ) return editor.createFakeParserElement( element, 'cke_anchor', 'anchor' ); return null; } } } ); } if ( CKEDITOR.plugins.link.emptyAnchorFix && htmlFilter ) { htmlFilter.addRules( { elements: { a: function( element ) { delete element.attributes.contenteditable; } } } ); } if ( pathFilters ) { pathFilters.push( function( element, name ) { if ( name == 'a' ) { if ( CKEDITOR.plugins.link.tryRestoreFakeAnchor( editor, element ) || ( element.getAttribute( 'name' ) && ( !element.getAttribute( 'href' ) || !element.getChildCount() ) ) ) return 'anchor'; } } ); } } } ); /** * Set of Link plugin helpers. * * @class * @singleton */ CKEDITOR.plugins.link = { /** * Get the surrounding link element of the current selection. * * CKEDITOR.plugins.link.getSelectedLink( editor ); * * // The following selections will all return the link element. * * li^nk * [link] * text[link] * li[nk] * [li]nk] * [li]nk * * @since 3.2.1 * @param {CKEDITOR.editor} editor */ getSelectedLink: function( editor ) { var selection = editor.getSelection(); var selectedElement = selection.getSelectedElement(); if ( selectedElement && selectedElement.is( 'a' ) ) return selectedElement; var range = selection.getRanges()[ 0 ]; if ( range ) { range.shrink( CKEDITOR.SHRINK_TEXT ); return editor.elementPath( range.getCommonAncestor() ).contains( 'a', 1 ); } return null; }, /** * Collects anchors available in the editor (i.e. used by the Link plugin). * Note that the scope of search is different for inline (the "global" document) and * classic (`iframe`-based) editors (the "inner" document). * * @since 4.3.3 * @param {CKEDITOR.editor} editor * @returns {CKEDITOR.dom.element[]} An array of anchor elements. */ getEditorAnchors: function( editor ) { var editable = editor.editable(), // The scope of search for anchors is the entire document for inline editors // and editor's editable for classic editor/divarea (#11359). scope = ( editable.isInline() && !editor.plugins.divarea ) ? editor.document : editable, links = scope.getElementsByTag( 'a' ), anchors = [], i = 0, item; // Retrieve all anchors within the scope. while ( ( item = links.getItem( i++ ) ) ) { if ( item.data( 'cke-saved-name' ) || item.hasAttribute( 'name' ) ) { anchors.push( { name: item.data( 'cke-saved-name' ) || item.getAttribute( 'name' ), id: item.getAttribute( 'id' ) } ); } } // Retrieve all "fake anchors" within the scope. if ( this.fakeAnchor ) { var imgs = scope.getElementsByTag( 'img' ); i = 0; while ( ( item = imgs.getItem( i++ ) ) ) { if ( ( item = this.tryRestoreFakeAnchor( editor, item ) ) ) { anchors.push( { name: item.getAttribute( 'name' ), id: item.getAttribute( 'id' ) } ); } } } return anchors; }, /** * Opera and WebKit do not make it possible to select empty anchors. Fake * elements must be used for them. * * @readonly * @property {Boolean} */ fakeAnchor: CKEDITOR.env.opera || CKEDITOR.env.webkit, /** * For browsers that do not support CSS3 `a[name]:empty()`. Note that IE9 is included because of #7783. * * @readonly * @property {Boolean} */ synAnchorSelector: CKEDITOR.env.ie, /** * For browsers that have editing issues with an empty anchor. * * @readonly * @property {Boolean} */ emptyAnchorFix: CKEDITOR.env.ie && CKEDITOR.env.version < 8, /** * Returns an element representing a real anchor restored from a fake anchor. * * @param {CKEDITOR.editor} editor * @param {CKEDITOR.dom.element} element * @returns {CKEDITOR.dom.element} Restored anchor element or nothing if the * passed element was not a fake anchor. */ tryRestoreFakeAnchor: function( editor, element ) { if ( element && element.data( 'cke-real-element-type' ) && element.data( 'cke-real-element-type' ) == 'anchor' ) { var link = editor.restoreRealElement( element ); if ( link.data( 'cke-saved-name' ) ) return link; } } }; // TODO Much probably there's no need to expose these as public objects. CKEDITOR.unlinkCommand = function() {}; CKEDITOR.unlinkCommand.prototype = { exec: function( editor ) { var style = new CKEDITOR.style( { element: 'a', type: CKEDITOR.STYLE_INLINE, alwaysRemoveElement: 1 } ); editor.removeStyle( style ); }, refresh: function( editor, path ) { // Despite our initial hope, document.queryCommandEnabled() does not work // for this in Firefox. So we must detect the state by element paths. var element = path.lastElement && path.lastElement.getAscendant( 'a', true ); if ( element && element.getName() == 'a' && element.getAttribute( 'href' ) && element.getChildCount() ) this.setState( CKEDITOR.TRISTATE_OFF ); else this.setState( CKEDITOR.TRISTATE_DISABLED ); }, contextSensitive: 1, startDisabled: 1, requiredContent: 'a[href]' }; CKEDITOR.removeAnchorCommand = function() {}; CKEDITOR.removeAnchorCommand.prototype = { exec: function( editor ) { var sel = editor.getSelection(), bms = sel.createBookmarks(), anchor; if ( sel && ( anchor = sel.getSelectedElement() ) && ( CKEDITOR.plugins.link.fakeAnchor && !anchor.getChildCount() ? CKEDITOR.plugins.link.tryRestoreFakeAnchor( editor, anchor ) : anchor.is( 'a' ) ) ) anchor.remove( 1 ); else { if ( ( anchor = CKEDITOR.plugins.link.getSelectedLink( editor ) ) ) { if ( anchor.hasAttribute( 'href' ) ) { anchor.removeAttributes( { name: 1, 'data-cke-saved-name': 1 } ); anchor.removeClass( 'cke_anchor' ); } else anchor.remove( 1 ); } } sel.selectBookmarks( bms ); }, requiredContent: 'a[name]' }; CKEDITOR.tools.extend( CKEDITOR.config, { /** * Whether to show the Advanced tab in the Link dialog window. * * @cfg {Boolean} [linkShowAdvancedTab=true] * @member CKEDITOR.config */ linkShowAdvancedTab: true, /** * Whether to show the Target tab in the Link dialog window. * * @cfg {Boolean} [linkShowTargetTab=true] * @member CKEDITOR.config */ linkShowTargetTab: true } );