/** * SCEditor * http://www.sceditor.com/ * * Copyright (C) 2011-2013, Sam Clarke (samclarke.com) * * SCEditor is licensed under the MIT license: * http://www.opensource.org/licenses/mit-license.php * * @fileoverview SCEditor - A lightweight WYSIWYG BBCode and HTML editor * @author Sam Clarke * @requires jQuery */ // ==ClosureCompiler== // @output_file_name jquery.sceditor.min.js // @compilation_level SIMPLE_OPTIMIZATIONS // ==/ClosureCompiler== /*jshint smarttabs: true, scripturl: true, jquery: true, devel:true, eqnull:true, curly: false */ /*global Range: true, browser*/ ;(function ($, window, document) { 'use strict'; /** * HTML templates used by the editor and default commands * @type {Object} * @private */ var _templates = { html: '' + '' + '
' + '' + '' + '' + '' + '' + '', toolbarButton: 'Replaces any params in a template with the passed params.
* *If createHTML is passed it will use jQuery to create the HTML. The * same as doing: $(editor.tmpl("html", {params...}));
* * @param {string} templateName * @param {Object} params * @param {Boolean} createHTML * @private */ var _tmpl = function(name, params, createHTML) { var template = _templates[name]; $.each(params, function(name, val) { template = template.replace(new RegExp('\\{' + name + '\\}', 'g'), val); }); if(createHTML) template = $(template); return template; }; /** * SCEditor - A lightweight WYSIWYG editor * * @param {Element} el The textarea to be converted * @return {Object} options * @class sceditor * @name jQuery.sceditor */ $.sceditor = function (el, options) { /** * Alias of this * @private */ var base = this; /** * The textarea element being replaced * @private */ var original = el.get ? el.get(0) : el; var $original = $(original); /** * The div which contains the editor and toolbar * @private */ var $editorContainer; /** * The editors toolbar * @private */ var $toolbar; /** * The editors iframe which should be in design mode * @private */ var $wysiwygEditor; var wysiwygEditor; /** * The WYSIWYG editors body element * @private */ var $wysiwygBody; /** * The WYSIWYG editors document * @private */ var $wysiwygDoc; /** * The editors textarea for viewing source * @private */ var $sourceEditor; var sourceEditor; /** * The current dropdown * @private */ var $dropdown; /** * Array of all the commands key press functions * @private * @type {Array} */ var keyPressFuncs = []; /** * Store the last cursor position. Needed for IE because it forgets * @private */ var lastRange; /** * The editors locale * @private */ var locale; /** * Stores a cache of preloaded images * @private * @type {Array} */ var preLoadCache = []; /** * The editors rangeHelper instance * @type {jQuery.sceditor.rangeHelper} * @private */ var rangeHelper; /** * Tags which require the new line fix * @type {Array} * @private */ var requireNewLineFix = []; /** * An array of button state handlers * @type {Array} * @private */ var btnStateHandlers = []; /** * Element which gets focused to blur the editor. * * This will be null until blur() is called. * @type {HTMLElement} * @private */ var $blurElm; /** * Plugin manager instance * @type {jQuery.sceditor.PluginManager} * @private */ var pluginManager; /** * The current node containing the selection/caret * @type {Node} * @private */ var currentNode; /** * The first block level parent of the current node * @type {node} * @private */ var currentBlockNode; /** * The current node selection/caret * @type {Object} * @private */ var currentSelection; /** * Used to make sure only 1 selection changed check is called every 100ms. * Helps improve performance as it is checked a lot. * @type {Boolean} * @private */ var isSelectionCheckPending; /** * If content is required (equivalent to the HTML5 required attribute) * @type {Boolean} * @private */ var isRequired; /** * The inline CSS style element. Will be undefined until css() is called * for the first time. * @type {HTMLElement} * @private */ var inlineCss; /** * Object containing a list of shortcut handlers * @type {Object} * @private */ var shortcutHandlers = {}; /** * An array of all the current emoticons. * * Only used or populated when emoticonsCompat is enabled. * @type {Array} * @private */ var currentEmoticons = []; /** * Private functions * @private */ var init, replaceEmoticons, handleCommand, saveRange, initEditor, initPlugins, initLocale, initToolBar, initOptions, initEvents, initCommands, initResize, initEmoticons, getWysiwygDoc, handlePasteEvt, handlePasteData, handleKeyDown, handleBackSpace, handleKeyPress, handleFormReset, handleMouseDown, handleEvent, handleDocumentClick, handleWindowResize, updateToolBar, updateActiveButtons, sourceEditorSelectedText, appendNewLine, checkSelectionChanged, checkNodeChanged, autofocus, emoticonsKeyPress, emoticonsCheckWhitespace, currentStyledBlockNode; /** * All the commands supported by the editor * @name commands * @memberOf jQuery.sceditor.prototype */ base.commands = $.extend(true, {}, (options.commands || $.sceditor.commands)); /** * Options for this editor instance * @name opts * @memberOf jQuery.sceditor.prototype */ base.opts = options = $.extend({}, $.sceditor.defaultOptions, options); /** * Creates the editor iframe and textarea * @private */ init = function () { $original.data("sceditor", base); // Clone any objects in options $.each(options, function(key, val) { if($.isPlainObject(val)) options[key] = $.extend(true, {}, val); }); // Load locale if(options.locale && options.locale !== 'en') initLocale(); $editorContainer = $('') .insertAfter($original) .css('z-index', options.zIndex); // Add IE version to the container to allow IE specific CSS // fixes without using CSS hacks or conditional comments if($.sceditor.ie) $editorContainer.addClass('ie ie' + $.sceditor.ie); isRequired = !!$original.attr('required'); $original.removeAttr('required'); // create the editor initPlugins(); initEmoticons(); initToolBar(); initEditor(); initCommands(); initOptions(); initEvents(); // force into source mode if is a browser that can't handle // full editing if(!$.sceditor.isWysiwygSupported) base.toggleSourceMode(); var loaded = function() { $(window).unbind('load', loaded); if(options.autofocus) autofocus(); if(options.autoExpand) base.expandToContent(); // Page width might have changed after CSS is loaded so // call handleWindowResize to update any % based dimensions handleWindowResize(); }; $(window).load(loaded); if(document.readyState && document.readyState === 'complete') loaded(); updateActiveButtons(); pluginManager.call('ready'); }; initPlugins = function() { var plugins = options.plugins; plugins = plugins ? plugins.toString().split(',') : []; pluginManager = new $.sceditor.PluginManager(base); $.each(plugins, function(idx, plugin) { pluginManager.register($.trim(plugin)); }); }; /** * Init the locale variable with the specified locale if possible * @private * @return void */ initLocale = function() { var lang; if($.sceditor.locale[options.locale]) locale = $.sceditor.locale[options.locale]; else { lang = options.locale.split('-'); if($.sceditor.locale[lang[0]]) locale = $.sceditor.locale[lang[0]]; } if(locale && locale.dateFormat) options.dateFormat = locale.dateFormat; }; /** * Creates the editor iframe and textarea * @private */ initEditor = function () { var doc, tabIndex; // @SMF code: tabindex applied to the editor $sourceEditor = $('').attr('tabindex', $original.attr('tabindex')).hide(); $wysiwygEditor = $('').attr('tabindex', $original.attr('tabindex')); if(!options.spellcheck) $sourceEditor.attr('spellcheck', 'false'); if(window.location.protocol === 'https:') $wysiwygEditor.attr('src', 'javascript:false'); // add the editor to the HTML and store the editors element $editorContainer.append($wysiwygEditor).append($sourceEditor); wysiwygEditor = $wysiwygEditor[0]; sourceEditor = $sourceEditor[0]; base.width(options.width || $original.width()); base.height(options.height || $original.height()); doc = getWysiwygDoc(); doc.open(); doc.write(_tmpl('html', { spellcheck: options.spellcheck ? '' : 'spellcheck="false"', charset: options.charset, style: options.style })); doc.close(); $wysiwygDoc = $(doc); $wysiwygBody = $(doc.body); base.readOnly(!!options.readOnly); // Add IE version class to the HTML element so can apply // conditional styling without CSS hacks if($.sceditor.ie) $wysiwygDoc.find('html').addClass('ie ie' + $.sceditor.ie); // iframe overflow fix for iOS, also fixes an IE issue with the // editor not getting focus when clicking inside if($.sceditor.ios || $.sceditor.ie) { $wysiwygBody.height('100%'); if(!$.sceditor.ie) $wysiwygBody.bind('touchend', base.focus); } rangeHelper = new $.sceditor.rangeHelper(wysiwygEditor.contentWindow); // load any textarea value into the editor base.val($original.hide().val()); tabIndex = $original.attr('tabindex'); $sourceEditor.attr('tabindex', tabIndex); $wysiwygEditor.attr('tabindex', tabIndex); }; /** * Initialises options * @private */ initOptions = function() { // auto-update original textbox on blur if option set to true if(options.autoUpdate) { $wysiwygBody.bind('blur', base.updateOriginal); $sourceEditor.bind('blur', base.updateOriginal); } if(options.rtl === null) options.rtl = $sourceEditor.css('direction') === 'rtl'; base.rtl(!!options.rtl); if(options.autoExpand) $wysiwygDoc.bind('keyup', base.expandToContent); if(options.resizeEnabled) initResize(); $editorContainer.attr('id', options.id); base.emoticons(options.emoticonsEnabled); }; /** * Initialises events * @private */ initEvents = function() { $(document).click(handleDocumentClick); $(original.form) .bind('reset', handleFormReset) .submit(base.updateOriginal); $(window).bind('resize orientationChanged', handleWindowResize); $wysiwygBody .keypress(handleKeyPress) .keydown(handleKeyDown) .keydown(handleBackSpace) .keyup(appendNewLine) .bind('paste', handlePasteEvt) .bind($.sceditor.ie ? 'selectionchange' : 'keyup focus blur contextmenu mouseup touchend click', checkSelectionChanged) .bind('keydown keyup keypress focus blur contextmenu', handleEvent); if(options.emoticonsCompat && window.getSelection) $wysiwygBody.keyup(emoticonsCheckWhitespace); $sourceEditor.bind('keydown keyup keypress focus blur contextmenu', handleEvent).keydown(handleKeyDown); $wysiwygDoc .keypress(handleKeyPress) .mousedown(handleMouseDown) .bind($.sceditor.ie ? 'selectionchange' : 'focus blur contextmenu mouseup click', checkSelectionChanged) .bind('beforedeactivate keyup', saveRange) .keyup(appendNewLine) .focus(function() { lastRange = null; }); $editorContainer .bind('selectionchanged', checkNodeChanged) .bind('selectionchanged', updateActiveButtons) .bind('selectionchanged', handleEvent) .bind('nodechanged', handleEvent); }; /** * Creates the toolbar and appends it to the container * @private */ initToolBar = function () { var $group, $button, exclude = (options.toolbarExclude || '').split(','), groups = options.toolbar.split('|'); $toolbar = $(''); $.each(groups, function(idx, group) { $group = $(''); $.each(group.split(','), function(idx, button) { // The button must be a valid command and not excluded if(!base.commands[button] || $.inArray(button, exclude) > -1) return; $button = _tmpl('toolbarButton', { name: button, dispName: base._(base.commands[button].tooltip || button) }, true); $button.data('sceditor-txtmode', !!base.commands[button].txtExec); $button.data('sceditor-wysiwygmode', !!base.commands[button].exec); $button.click(function() { var $this = $(this); if(!$this.hasClass('disabled')) handleCommand($this, base.commands[button]); updateActiveButtons(); return false; }); if(base.commands[button].tooltip) $button.attr('title', base._(base.commands[button].tooltip)); if(!base.commands[button].exec) $button.addClass('disabled'); if(base.commands[button].shortcut) base.addShortcut(base.commands[button].shortcut, button); $group.append($button); }); // Exclude empty groups if($group[0].firstChild) $toolbar.append($group); }); // append the toolbar to the toolbarContainer option if given $(options.toolbarContainer || $editorContainer).append($toolbar); }; /** * Creates an array of all the key press functions * like emoticons, ect. * @private */ initCommands = function () { $.each(base.commands, function (name, cmd) { if(cmd.keyPress) keyPressFuncs.push(cmd.keyPress); if(cmd.forceNewLineAfter && $.isArray(cmd.forceNewLineAfter)) requireNewLineFix = $.merge(requireNewLineFix, cmd.forceNewLineAfter); if(cmd.state) btnStateHandlers.push({ name: name, state: cmd.state }); // exec string commands can be passed to queryCommandState else if(typeof cmd.exec === 'string') btnStateHandlers.push({ name: name, state: cmd.exec }); }); appendNewLine(); }; /** * Creates the resizer. * @private */ initResize = function () { var minHeight, maxHeight, minWidth, maxWidth, mouseMoveFunc, mouseUpFunc, $grip = $(''), // cover is used to cover the editor iframe so document still gets mouse move events $cover = $(''), startX = 0, startY = 0, startWidth = 0, startHeight = 0, origWidth = $editorContainer.width(), origHeight = $editorContainer.height(), dragging = false, rtl = base.rtl(); minHeight = options.resizeMinHeight || origHeight / 1.5; maxHeight = options.resizeMaxHeight || origHeight * 2.5; minWidth = options.resizeMinWidth || origWidth / 1.25; maxWidth = options.resizeMaxWidth || origWidth * 1.25; mouseMoveFunc = function (e) { // iOS must use window.event if(e.type === 'touchmove') e = window.event; var newHeight = startHeight + (e.pageY - startY), newWidth = rtl ? startWidth - (e.pageX - startX) : startWidth + (e.pageX - startX); if(maxWidth > 0 && newWidth > maxWidth) newWidth = maxWidth; if(maxHeight > 0 && newHeight > maxHeight) newHeight = maxHeight; if(!options.resizeWidth || newWidth < minWidth || (maxWidth > 0 && newWidth > maxWidth)) newWidth = false; if(!options.resizeHeight || newHeight < minHeight || (maxHeight > 0 && newHeight > maxHeight)) newHeight = false; if(newWidth || newHeight) { base.dimensions(newWidth, newHeight); // The resize cover will not fill the container in IE6 unless a height is specified. if($.sceditor.ie < 7) $editorContainer.height(newHeight); } e.preventDefault(); }; mouseUpFunc = function (e) { if(!dragging) return; dragging = false; $cover.hide(); $editorContainer.removeClass('resizing').height('auto'); $(document).unbind('touchmove mousemove', mouseMoveFunc); $(document).unbind('touchend mouseup', mouseUpFunc); e.preventDefault(); }; $editorContainer.append($grip); $editorContainer.append($cover.hide()); $grip.bind('touchstart mousedown', function (e) { // iOS must use window.event if(e.type === 'touchstart') e = window.event; startX = e.pageX; startY = e.pageY; startWidth = $editorContainer.width(); startHeight = $editorContainer.height(); dragging = true; $editorContainer.addClass('resizing'); $cover.show(); $(document).bind('touchmove mousemove', mouseMoveFunc); $(document).bind('touchend mouseup', mouseUpFunc); // The resize cover will not fill the container in IE6 unless a height is specified. if($.sceditor.ie < 7) $editorContainer.height(startHeight); e.preventDefault(); }); }; /** * Prefixes and preloads the emoticon images * @private */ initEmoticons = function () { var emoticon, emoticons = options.emoticons, root = options.emoticonsRoot; if(!$.isPlainObject(emoticons) || !options.emoticonsEnabled) return; $.each(emoticons, function (idx, val) { $.each(val, function (key, url) { // @SMF code: In SMF an empty entry means a new line if (url == '') emoticon = document.createElement('br'); // Prefix emoticon root to emoticon urls if(root) { url = { url: root + (url.url || url), tooltip: url.tooltip || key }; emoticons[idx][key] = url; } // Preload the emoticon // Idea from: http://engineeredweb.com/blog/09/12/preloading-images-jquery-and-javascript emoticon = document.createElement('img'); emoticon.src = url.url || url; preLoadCache.push(emoticon); }); }); }; /** * Autofocus the editor * @private */ autofocus = function() { var rng, elm, txtPos, doc = $wysiwygDoc[0], body = $wysiwygBody[0], focusEnd = !!options.autofocusEnd; // Can't focus invisible elements if(!$editorContainer.is(':visible')) return; if(base.sourceMode()) { txtPos = sourceEditor.value.length; if(sourceEditor.setSelectionRange) sourceEditor.setSelectionRange(txtPos, txtPos); else if (sourceEditor.createTextRange) { rng = sourceEditor.createTextRange(); rng.moveEnd('character', txtPos); rng.moveStart('character', txtPos); rangeHelper.selectRange(rng); } } else // WYSIWYG mode { $.sceditor.dom.removeWhiteSpace(body); if(focusEnd) { if(!(elm = body.lastChild)) $wysiwygBody.append((elm = doc.createElement('div'))); while(elm.lastChild) { elm = elm.lastChild; if(/br/i.test(elm.nodeName) && elm.previousSibling) elm = elm.previousSibling; } } else elm = body.firstChild; if(doc.createRange) { rng = doc.createRange(); if(/br/i.test(elm.nodeName)) rng.setStartBefore(elm); else rng.selectNodeContents(elm); rng.collapse(false); } else { rng = body.createTextRange(); rng.moveToElementText(elm.nodeType !== 3 ? elm : elm.parentNode); rng.collapse(false); } rangeHelper.selectRange(rng); if(focusEnd) { $wysiwygDoc.scrollTop(body.scrollHeight); $wysiwygBody.scrollTop(body.scrollHeight); } } base.focus(); }; /** * Gets if the editor is read only * * @since 1.3.5 * @function * @memberOf jQuery.sceditor.prototype * @name readOnly * @return {Boolean} */ /** * Sets if the editor is read only * * @param {boolean} readOnly * @since 1.3.5 * @function * @memberOf jQuery.sceditor.prototype * @name readOnly^2 * @return {this} */ base.readOnly = function(readOnly) { if(typeof readOnly !== 'boolean') return $sourceEditor.attr('readonly') === 'readonly'; $wysiwygBody[0].contentEditable = !readOnly; if(!readOnly) $sourceEditor.removeAttr('readonly'); else $sourceEditor.attr('readonly', 'readonly'); updateToolBar(readOnly); return this; }; /** * Gets if the editor is in RTL mode * * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name rtl * @return {Boolean} */ /** * Sets if the editor is in RTL mode * * @param {boolean} rtl * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name rtl^2 * @return {this} */ base.rtl = function(rtl) { var dir = rtl ? 'rtl' : 'ltr'; if(typeof rtl !== 'boolean') return $sourceEditor.attr('dir') === 'rtl'; $wysiwygBody.attr('dir', dir); $sourceEditor.attr('dir', dir); $editorContainer .removeClass('rtl') .removeClass('ltr') .addClass(dir); return this; }; /** * Updates the toolbar to disable/enable the appropriate buttons * @private */ updateToolBar = function(disable) { var inSourceMode = base.inSourceMode(); $toolbar.find('.sceditor-button').removeClass('disabled').each(function () { var button = $(this); if(disable === true || (inSourceMode && !button.data('sceditor-txtmode'))) button.addClass('disabled'); else if (!inSourceMode && !button.data('sceditor-wysiwygmode')) button.addClass('disabled'); }); }; /** * Gets the width of the editor in pixels * * @since 1.3.5 * @function * @memberOf jQuery.sceditor.prototype * @name width * @return {int} */ /** * Sets the width of the editor * * @param {int} width Width in pixels * @since 1.3.5 * @function * @memberOf jQuery.sceditor.prototype * @name width^2 * @return {this} */ /** * Sets the width of the editor * * The saveWidth specifies if to save the width. The stored width can be * used for things like restoring from maximized state. * * @param {int} height Width in pixels * @param {boolean} [saveWidth=true] If to store the width * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name width^3 * @return {this} */ base.width = function (width, saveWidth) { if(!width && width !== 0) return $editorContainer.width(); base.dimensions(width, null, saveWidth); return this; }; /** * Returns an object with the properties width and height * which are the width and height of the editor in px. * * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name dimensions * @return {object} */ /** *Sets the width and/or height of the editor.
* *If width or height is not numeric it is ignored.
* * @param {int} width Width in px * @param {int} height Height in px * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name dimensions^2 * @return {this} */ /** *Sets the width and/or height of the editor.
* *If width or height is not numeric it is ignored.
* *The save argument specifies if to save the new sizes. * The saved sizes can be used for things like restoring from * maximized state. This should normally be left as true.
* * @param {int} width Width in px * @param {int} height Height in px * @param {boolean} [save=true] If to store the new sizes * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name dimensions^3 * @return {this} */ base.dimensions = function(width, height, save) { // IE6 & IE7 add 2 pixels to the source mode textarea height which must be ignored. // Doesn't seem to be any way to fix it with only CSS var ieBorderBox = $.sceditor.ie < 8 || document.documentMode < 8 ? 2 : 0; // set undefined width/height to boolean false width = (!width && width !== 0) ? false : width; height = (!height && height !== 0) ? false : height; if(width === false && height === false) return { width: base.width(), height: base.height() }; if(typeof $wysiwygEditor.data('outerWidthOffset') === 'undefined') base.updateStyleCache(); if(width !== false) { if(save !== false) options.width = width; if(height === false) { height = $editorContainer.height(); save = false; } $editorContainer.width(width); if(width && width.toString().indexOf('%') > -1) width = $editorContainer.width(); $wysiwygEditor.width(width - $wysiwygEditor.data('outerWidthOffset')); $sourceEditor.width(width - $sourceEditor.data('outerWidthOffset')); // Fix overflow issue with iOS not breaking words unless a width is set if($.sceditor.ios && $wysiwygBody) $wysiwygBody.width(width - $wysiwygEditor.data('outerWidthOffset') - ($wysiwygBody.outerWidth(true) - $wysiwygBody.width())); } if(height !== false) { if(save !== false) options.height = height; // Convert % based heights to px if(height && height.toString().indexOf('%') > -1) { height = $editorContainer.height(height).height(); $editorContainer.height('auto'); } height -= !options.toolbarContainer ? $toolbar.outerHeight(true) : 0; $wysiwygEditor.height(height - $wysiwygEditor.data('outerHeightOffset')); $sourceEditor.height(height - ieBorderBox - $sourceEditor.data('outerHeightOffset')); } return this; }; /** * Updates the CSS styles cache. Shouldn't be needed unless changing the editors theme. * * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name updateStyleCache * @return {int} */ base.updateStyleCache = function() { // caching these improves FF resize performance $wysiwygEditor.data('outerWidthOffset', $wysiwygEditor.outerWidth(true) - $wysiwygEditor.width()); $sourceEditor.data('outerWidthOffset', $sourceEditor.outerWidth(true) - $sourceEditor.width()); $wysiwygEditor.data('outerHeightOffset', $wysiwygEditor.outerHeight(true) - $wysiwygEditor.height()); $sourceEditor.data('outerHeightOffset', $sourceEditor.outerHeight(true) - $sourceEditor.height()); }; /** * Gets the height of the editor in px * * @since 1.3.5 * @function * @memberOf jQuery.sceditor.prototype * @name height * @return {int} */ /** * Sets the height of the editor * * @param {int} height Height in px * @since 1.3.5 * @function * @memberOf jQuery.sceditor.prototype * @name height^2 * @return {this} */ /** * Sets the height of the editor * * The saveHeight specifies if to save the height. The stored height can be * used for things like restoring from maximized state. * * @param {int} height Height in px * @param {boolean} [saveHeight=true] If to store the height * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name height^3 * @return {this} */ base.height = function (height, saveHeight) { if(!height && height !== 0) return $editorContainer.height(); base.dimensions(null, height, saveHeight); return this; }; /** * Gets if the editor is maximised or not * * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name maximize * @return {boolean} */ /** * Sets if the editor is maximised or not * * @param {boolean} maximize If to maximise the editor * @since 1.4.1 * @function * @memberOf jQuery.sceditor.prototype * @name maximize^2 * @return {this} */ base.maximize = function(maximize) { if(typeof maximize === 'undefined') return $editorContainer.is('.sceditor-maximize'); maximize = !!maximize; // IE 6 fix if($.sceditor.ie < 7) $('html, body').toggleClass('sceditor-maximize', maximize); $editorContainer.toggleClass('sceditor-maximize', maximize); base.width(maximize ? '100%' : options.width, false); base.height(maximize ? '100%' : options.height, false); return this; }; /** * Expands the editors height to the height of it's content * * Unless ignoreMaxHeight is set to true it will not expand * higher than the maxHeight option. * * @since 1.3.5 * @param {Boolean} [ignoreMaxHeight=false] * @function * @name expandToContent * @memberOf jQuery.sceditor.prototype * @see #resizeToContent */ base.expandToContent = function(ignoreMaxHeight) { var currentHeight = $editorContainer.height(), height = $wysiwygBody[0].scrollHeight || $wysiwygDoc[0].documentElement.scrollHeight, padding = (currentHeight - $wysiwygEditor.height()), maxHeight = options.resizeMaxHeight || ((options.height || $original.height()) * 2); height += padding; if(ignoreMaxHeight !== true && height > maxHeight) height = maxHeight; if(height > currentHeight) base.height(height); }; /** * Destroys the editor, removing all elements and * event handlers. * * Leaves only the original textarea. * * @function * @name destroy * @memberOf jQuery.sceditor.prototype */ base.destroy = function () { pluginManager.destroy(); rangeHelper = null; lastRange = null; pluginManager = null; $(document).unbind('click', handleDocumentClick); $(window).unbind('resize orientationChanged', handleWindowResize); $(original.form) .unbind('reset', handleFormReset) .unbind('submit', base.updateOriginal); $wysiwygBody.unbind(); $wysiwygDoc.unbind().find('*').remove(); $sourceEditor.unbind().remove(); $toolbar.remove(); $editorContainer.unbind().find('*').unbind().remove(); $editorContainer.remove(); $original .removeData('sceditor') .removeData('sceditorbbcode') .show(); if(isRequired) $original.attr('required', 'required'); }; /** * Creates a menu item drop down * * @param {HTMLElement} menuItem The button to align the drop down with * @param {string} dropDownName Used for styling the dropown, will be a class sceditor-dropDownName * @param {HTMLElement} content The HTML content of the dropdown * @param {bool} [ieUnselectable=true] If to add the unselectable attribute to all the contents elements. Stops IE from deselecting the text in the editor * @function * @name createDropDown * @memberOf jQuery.sceditor.prototype */ base.createDropDown = function (menuItem, dropDownName, content, ieUnselectable) { // first click for create second click for close var css, onlyclose = $dropdown && $dropdown.is('.sceditor-' + dropDownName); base.closeDropDown(); if (onlyclose) return; // IE needs unselectable attr to stop it from unselecting the text in the editor. // The editor can cope if IE does unselect the text it's just not nice. if (ieUnselectable !== false) { $(content) .find(':not(input,textarea)') .filter(function() { return this.nodeType===1; }) .attr('unselectable', 'on'); } css = { top: menuItem.offset().top, left: menuItem.offset().left, marginTop: menuItem.outerHeight() }; $.extend(css, options.dropDownCss); $dropdown = $('') .css(css) .append(content) .appendTo($('body')) .click(function (e) { // stop clicks within the dropdown from being handled e.stopPropagation(); }); }; /** * Handles any document click and closes the dropdown if open * @private */ handleDocumentClick = function (e) { // ignore right clicks if(e.which !== 3) base.closeDropDown(); }; /** * Handles the WYSIWYG editors paste event * @private */ handlePasteEvt = function(e) { var html, handlePaste, elm = $wysiwygBody[0], doc = $wysiwygDoc[0], checkCount = 0, pastearea = document.createElement('div'), prePasteContent = doc.createDocumentFragment(); if (options.disablePasting) return false; if (!options.enablePasteFiltering) return; rangeHelper.saveRange(); document.body.appendChild(pastearea); if (e && e.clipboardData && e.clipboardData.getData) { if ((html = e.clipboardData.getData('text/html')) || (html = e.clipboardData.getData('text/plain'))) { pastearea.innerHTML = html; handlePasteData(elm, pastearea); return false; } } while(elm.firstChild) prePasteContent.appendChild(elm.firstChild); // try make pastearea contenteditable and redirect to that? Might work. // Check the tests if still exist, if not re-0create handlePaste = function (elm, pastearea) { if (elm.childNodes.length > 0) { while(elm.firstChild) pastearea.appendChild(elm.firstChild); while(prePasteContent.firstChild) elm.appendChild(prePasteContent.firstChild); handlePasteData(elm, pastearea); } else { // Allow max 25 checks before giving up. // Needed in case an empty string is pasted or // something goes wrong. if(checkCount > 25) { while(prePasteContent.firstChild) elm.appendChild(prePasteContent.firstChild); rangeHelper.restoreRange(); return; } ++checkCount; setTimeout(function () { handlePaste(elm, pastearea); }, 20); } }; handlePaste(elm, pastearea); base.focus(); return true; }; /** * Gets the pasted data, filters it and then inserts it. * @param {Element} elm * @param {Element} pastearea * @private */ handlePasteData = function(elm, pastearea) { // fix any invalid nesting $.sceditor.dom.fixNesting(pastearea); // TODO: Trigger custom paste event to allow filtering (pre and post converstion?) var pasteddata = pastearea.innerHTML; if(pluginManager.hasHandler('toSource')) pasteddata = pluginManager.callOnlyFirst('toSource', pasteddata, $(pastearea)); pastearea.parentNode.removeChild(pastearea); if(pluginManager.hasHandler('toWysiwyg')) pasteddata = pluginManager.callOnlyFirst('toWysiwyg', pasteddata, true); rangeHelper.restoreRange(); base.wysiwygEditorInsertHtml(pasteddata, null, true); }; /** * Closes any currently open drop down * * @param {bool} [focus=false] If to focus the editor after closing the drop down * @function * @name closeDropDown * @memberOf jQuery.sceditor.prototype */ base.closeDropDown = function (focus) { if($dropdown) { $dropdown.unbind().remove(); $dropdown = null; } if(focus === true) base.focus(); }; /** * Gets the WYSIWYG editors document * @private */ getWysiwygDoc = function () { if (wysiwygEditor.contentDocument) return wysiwygEditor.contentDocument; if (wysiwygEditor.contentWindow && wysiwygEditor.contentWindow.document) return wysiwygEditor.contentWindow.document; if (wysiwygEditor.document) return wysiwygEditor.document; return null; }; /** *Inserts HTML into WYSIWYG editor.
* *If endHtml is specified, any selected text will be placed between html * and endHtml. If there is no selected text html and endHtml will just be * concated together.
* * @param {string} html * @param {string} [endHtml=null] * @param {boolean} [overrideCodeBlocking=false] If to insert the html into code tags, by default code tags only support text. * @function * @name wysiwygEditorInsertHtml * @memberOf jQuery.sceditor.prototype */ base.wysiwygEditorInsertHtml = function (html, endHtml, overrideCodeBlocking) { var scrollTo, $marker, marker = ' '; base.focus(); // TODO: This code tag should be configurable and should maybe convert the HTML into text // don't apply to code elements if(!overrideCodeBlocking && ($(currentBlockNode).is('code') || $(currentBlockNode).parents('code').length !== 0)) return; if(endHtml) endHtml += marker; else html += marker; rangeHelper.insertHTML(html, endHtml); // Scroll the editor to after the inserted HTML $marker = $wysiwygBody.find('#sceditor-cursor'); scrollTo = ($marker.offset().top + ($marker.outerHeight(true) * 2)) - $wysiwygEditor.height(); $marker.remove(); // TODO: check if already in range and don't scroll if it is $wysiwygDoc.scrollTop(scrollTo); $wysiwygBody.scrollTop(scrollTo); rangeHelper.saveRange(); replaceEmoticons($wysiwygBody[0]); rangeHelper.restoreRange(); appendNewLine(); }; /** * Like wysiwygEditorInsertHtml except it will convert any HTML into text * before inserting it. * * @param {String} text * @param {String} [endText=null] * @function * @name wysiwygEditorInsertText * @memberOf jQuery.sceditor.prototype */ base.wysiwygEditorInsertText = function (text, endText) { base.wysiwygEditorInsertHtml($.sceditor.escapeEntities(text), $.sceditor.escapeEntities(endText)); }; /** *Inserts text into the WYSIWYG or source editor depending on which * mode the editor is in.
* *If endText is specified any selected text will be placed between * text and endText. If no text is selected text and endText will * just be concated together.
* * @param {String} text * @param {String} [endText=null] * @since 1.3.5 * @function * @name insertText * @memberOf jQuery.sceditor.prototype */ base.insertText = function (text, endText) { if(base.inSourceMode()) base.sourceEditorInsertText(text, endText); else base.wysiwygEditorInsertText(text, endText); return this; }; /** *Like wysiwygEditorInsertHtml but inserts text into the * source mode editor instead.
* *If endText is specified any selected text will be placed between * text and endText. If no text is selected text and endText will * just be concated together.
* *The cursor will be placed after the text param. If endText is
* specified the cursor will be placed before endText, so passing:
*
* '[b]', '[/b]'
Would cause the cursor to be placed:
*
* [b]Selected text|[/b]
Gets the value of the editor.
* *If the editor is in WYSIWYG mode it will return the filtered * HTML from it (converted to BBCode if using the BBCode plugin). * It it's in Source Mode it will return the unfiltered contents * of the source editor (if using the BBCode plugin this will be * BBCode again).
* * @since 1.3.5 * @return {string} * @function * @name val * @memberOf jQuery.sceditor.prototype */ /** *Sets the value of the editor.
* *If filter set true the val will be passed through the filter * function. If using the BBCode plugin it will pass the val to * the BBCode filter to convert any BBCode into HTML.
* * @param {String} val * @param {Boolean} [filter=true] * @return {this} * @since 1.3.5 * @function * @name val^2 * @memberOf jQuery.sceditor.prototype */ base.val = function (val, filter) { if(typeof val === "string") { if(base.inSourceMode()) base.setSourceEditorValue(val); else { if(filter !== false && pluginManager.hasHandler('toWysiwyg')) val = pluginManager.callOnlyFirst('toWysiwyg', val); base.setWysiwygEditorValue(val); } return this; } return base.inSourceMode() ? base.getSourceEditorValue(false) : base.getWysiwygEditorValue(); }; /** *Inserts HTML/BBCode into the editor
* *If end is supplied any selected text will be placed between * start and end. If there is no selected text start and end * will be concated together.
* *If the filter param is set to true, the HTML/BBCode will be * passed through any plugin filters. If using the BBCode plugin * this will convert any BBCode into HTML.
* * @param {String} start * @param {String} [end=null] * @param {Boolean} [filter=true] * @param {Boolean} [convertEmoticons=true] If to convert emoticons * @return {this} * @since 1.3.5 * @function * @name insert * @memberOf jQuery.sceditor.prototype */ /** *Inserts HTML/BBCode into the editor
* *If end is supplied any selected text will be placed between * start and end. If there is no selected text start and end * will be concated together.
* *If the filter param is set to true, the HTML/BBCode will be * passed through any plugin filters. If using the BBCode plugin * this will convert any BBCode into HTML.
* *If the allowMixed param is set to true, HTML any will not be escaped
* * @param {String} start * @param {String} [end=null] * @param {Boolean} [filter=true] * @param {Boolean} [convertEmoticons=true] If to convert emoticons * @param {Boolean} [allowMixed=false] * @return {this} * @since 1.4.3 * @function * @name insert^2 * @memberOf jQuery.sceditor.prototype */ base.insert = function (start, end, filter, convertEmoticons, allowMixed) { if(base.inSourceMode()) base.sourceEditorInsertText(start, end); else { // Add the selection between start and end if(end) { var html = base.getRangeHelper().selectedHtml(), frag = $('' + ($.sceditor.ie ? '' : '
') + '
Gets the current node that contains the selection/caret in WYSIWYG mode.
* *Will be null in sourceMode or if there is no selection.
* @return {Node} * @function * @name currentNode * @memberOf jQuery.sceditor.prototype */ base.currentNode = function() { return currentNode; }; /** *Gets the first block level node that contains the selection/caret in WYSIWYG mode.
* *Will be null in sourceMode or if there is no selection.
* @return {Node} * @function * @name currentBlockNode * @memberOf jQuery.sceditor.prototype * @since 1.4.4 */ base.currentBlockNode = function() { return currentBlockNode; }; /** * Updates if buttons are active or not * @private */ updateActiveButtons = function(e) { var state, stateHandler, firstBlock, $button, parent, doc = $wysiwygDoc[0], i = btnStateHandlers.length, inSourceMode = base.sourceMode(); if(!base.sourceMode() && !base.readOnly()) { parent = e ? e.newNode : rangeHelper.parentNode(); firstBlock = rangeHelper.getFirstBlockParent(parent); while(i--) { state = 0; stateHandler = btnStateHandlers[i]; $button = $toolbar.find('.sceditor-button-' + stateHandler.name); if(inSourceMode && !$button.data('sceditor-txtmode')) $button.addClass('disabled'); else if (!inSourceMode && !$button.data('sceditor-wysiwygmode')) $button.addClass('disabled'); else { if(typeof stateHandler.state === 'string') { try { state = doc.queryCommandEnabled(stateHandler.state) ? 0 : -1; if(state > -1) state = doc.queryCommandState(stateHandler.state) ? 1 : 0; } catch(ex) {} } else state = stateHandler.state.call(base, parent, firstBlock); if(state < 0) $button.addClass('disabled'); else $button.removeClass('disabled'); if(state > 0) $button.addClass('active'); else $button.removeClass('active'); } } } else $toolbar.find('.sceditor-button').removeClass('active'); }; /** * Handles any key press in the WYSIWYG editor * * @private */ handleKeyPress = function(e) { var $parentNode, i = keyPressFuncs.length; base.closeDropDown(); $parentNode = $(currentNode); // "Fix" (OK it's a cludge) for blocklevel elements being duplicated in some browsers when // enter is pressed instead of inserting a newline if(e.which === 13) { if($parentNode.is('code,blockquote,pre') || $parentNode.parents('code,blockquote,pre').length !== 0) { lastRange = null; base.wysiwygEditorInsertHtml('or
Binds a handler to the specified events
* *This function only binds to a limited list of supported events.
* The supported events are:
*
The events param should be a string containing the event(s) * to bind this handler to. If multiple, they should be separated * by spaces.
* * @param {String} events * @param {Function} handler * @param {Boolean} excludeWysiwyg If to exclude adding this handler to the WYSIWYG editor * @param {Boolean} excludeSource if to exclude adding this handler to the source editor * @return {this} * @function * @name bind * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.bind = function(events, handler, excludeWysiwyg, excludeSource) { var i = events.length; events = events.split(" "); while(i--) { if($.isFunction(handler)) { // Use custom events to allow passing the instance as the 2nd argument. // Also allows unbinding without unbinding the editors own event handlers. if(!excludeWysiwyg) $editorContainer.bind('scewys' + events[i], handler); if(!excludeSource) $editorContainer.bind('scesrc' + events[i], handler); } } return this; }; /** * Unbinds an event that was bound using bind(). * * @param {String} events * @param {Function} handler * @param {Boolean} excludeWysiwyg If to exclude unbinding this handler from the WYSIWYG editor * @param {Boolean} excludeSource if to exclude unbinding this handler from the source editor * @return {this} * @function * @name unbind * @memberOf jQuery.sceditor.prototype * @since 1.4.1 * @see bind */ base.unbind = function(events, handler, excludeWysiwyg, excludeSource) { var i = events.length; events = events.split(" "); while(i--) { if($.isFunction(handler)) { if(!excludeWysiwyg) $editorContainer.unbind('scewys' + events[i], handler); if(!excludeSource) $editorContainer.unbind('scesrc' + events[i], handler); } } return this; }; /** * Blurs the editors input area * * @return {this} * @function * @name blur * @memberOf jQuery.sceditor.prototype * @since 1.3.6 */ /** * Adds a handler to the editors blur event * * @param {Function} handler * @param {Boolean} excludeWysiwyg If to exclude adding this handler to the WYSIWYG editor * @param {Boolean} excludeSource if to exclude adding this handler to the source editor * @return {this} * @function * @name blur^2 * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.blur = function(handler, excludeWysiwyg, excludeSource) { if($.isFunction(handler)) base.bind('blur', handler, excludeWysiwyg, excludeSource); else if(!base.sourceMode()) { // Must use an element that isn't display:hidden or visibility:hidden for iOS // so create a special blur element to use if(!$blurElm) $blurElm = $('').appendTo($editorContainer); $blurElm.removeAttr('disabled').show().focus().blur().hide().attr('disabled', 'disabled'); } else $sourceEditor.blur(); return this; }; /** * Fucuses the editors input area * * @return {this} * @function * @name focus * @memberOf jQuery.sceditor.prototype */ /** * Adds an event handler to the focus event * * @param {Function} handler * @param {Boolean} excludeWysiwyg If to exclude adding this handler to the WYSIWYG editor * @param {Boolean} excludeSource if to exclude adding this handler to the source editor * @return {this} * @function * @name focus^2 * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.focus = function (handler, excludeWysiwyg, excludeSource) { if($.isFunction(handler)) base.bind('focus', handler, excludeWysiwyg, excludeSource); else { if(!base.inSourceMode()) { wysiwygEditor.contentWindow.focus(); $wysiwygBody[0].focus(); // Needed for IE < 9 if(lastRange) { rangeHelper.selectRange(lastRange); // remove the stored range after being set. // If the editor loses focus it should be // saved again. lastRange = null; } } else sourceEditor.focus(); } return this; }; /** * Adds a handler to the key down event * * @param {Function} handler * @param {Boolean} excludeWysiwyg If to exclude adding this handler to the WYSIWYG editor * @param {Boolean} excludeSource if to exclude adding this handler to the source editor * @return {this} * @function * @name keyDown * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.keyDown = function(handler, excludeWysiwyg, excludeSource) { return base.bind('keydown', handler, excludeWysiwyg, excludeSource); }; /** * Adds a handler to the key press event * * @param {Function} handler * @param {Boolean} excludeWysiwyg If to exclude adding this handler to the WYSIWYG editor * @param {Boolean} excludeSource if to exclude adding this handler to the source editor * @return {this} * @function * @name keyPress * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.keyPress = function(handler, excludeWysiwyg, excludeSource) { return base.bind('keypress', handler, excludeWysiwyg, excludeSource); }; /** * Adds a handler to the key up event * * @param {Function} handler * @param {Boolean} excludeWysiwyg If to exclude adding this handler to the WYSIWYG editor * @param {Boolean} excludeSource if to exclude adding this handler to the source editor * @return {this} * @function * @name keyUp * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.keyUp = function(handler, excludeWysiwyg, excludeSource) { return base.bind('keyup', handler, excludeWysiwyg, excludeSource); }; /** *Adds a handler to the node changed event.
* *Happends whenever the node containing the selection/caret changes in WYSIWYG mode.
* * @param {Function} handler * @return {this} * @function * @name nodeChanged * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.nodeChanged = function(handler) { return base.bind('nodechanged', handler, false, true); }; /** *Adds a handler to the selection changed event
* *Happens whenever the selection changes in WYSIWYG mode.
* * @param {Function} handler * @return {this} * @function * @name selectionChanged * @memberOf jQuery.sceditor.prototype * @since 1.4.1 */ base.selectionChanged = function(handler) { return base.bind('selectionchanged', handler, false, true); }; /** * Emoticons keypress handler * @private */ emoticonsKeyPress = function (e) { var pos = 0, curChar = String.fromCharCode(e.which); // TODO: Make configurable if($(currentBlockNode).is('code') || $(currentBlockNode).parents('code').length) return; if(!base.emoticonsCache) { base.emoticonsCache = []; $.each($.extend({}, options.emoticons.more, options.emoticons.dropdown, options.emoticons.hidden), function(key, url) { base.emoticonsCache[pos++] = [ key, _tmpl('emoticon', { key: key, url: url.url || url, tooltip: url.tooltip || key }) ]; }); base.emoticonsCache.sort(function(a, b) { return a[0].length - b[0].length; }); base.longestEmoticonCode = base.emoticonsCache[base.emoticonsCache.length - 1][0].length; } if(base.getRangeHelper().raplaceKeyword(base.emoticonsCache, true, true, base.longestEmoticonCode, options.emoticonsCompat, curChar)) { if(options.emoticonsCompat) currentEmoticons = $wysiwygBody.find('img[data-sceditor-emoticon]'); return (/^\s$/.test(curChar) && options.emoticonsCompat); } }; /** * Makes sure emoticons are surrounded by whitespace * @private */ emoticonsCheckWhitespace = function() { if(!currentEmoticons.length) return; var prev, next, parent, range, previousText, rangeStartContainer, currentBlock = base.currentBlockNode(), rangeStart = false, noneWsRegex = /[^\s\xA0\u2002\u2003\u2009]+/; currentEmoticons = $.map(currentEmoticons, function(emoticon) { // Ignore emotiocons that have been removed from DOM if(!emoticon || !emoticon.parentNode) return null; if(!$.contains(currentBlock, emoticon)) return emoticon; prev = emoticon.previousSibling; next = emoticon.nextSibling; previousText = prev.nodeValue; // For IE's HTMLPhraseElement if(previousText === null) previousText = prev.innerText || ''; if((!prev || !noneWsRegex.test(prev.nodeValue.slice(-1))) && (!next || !noneWsRegex.test((next.nodeValue || '')[0]))) return emoticon; parent = emoticon.parentNode; range = rangeHelper.cloneSelected(); rangeStartContainer = range.startContainer; previousText = previousText + $(emoticon).data('sceditor-emoticon'); // Store current caret position if(rangeStartContainer === next) rangeStart = previousText.length + range.startOffset; else if(rangeStartContainer === currentBlock && currentBlock.childNodes[range.startOffset] === next) rangeStart = previousText.length; else if(rangeStartContainer === prev) rangeStart = range.startOffset; if(!next || next.nodeType !== 3) next = parent.insertBefore(parent.ownerDocument.createTextNode(''), next); next.insertData(0, previousText); parent.removeChild(prev); parent.removeChild(emoticon); // Need to update the range starting position if it has been modified if(rangeStart !== false) { range.setStart(next, rangeStart); range.collapse(true); rangeHelper.selectRange(range); } return null; }); }; /** * Gets if emoticons are currently enabled * @return {boolean} * @function * @name emoticons * @memberOf jQuery.sceditor.prototype * @since 1.4.2 */ /** * Enables/disables emoticons * * @param {boolean} enable * @return {this} * @function * @name emoticons^2 * @memberOf jQuery.sceditor.prototype * @since 1.4.2 */ base.emoticons = function(enable) { if(!enable && enable !== false) return options.emoticonsEnabled; options.emoticonsEnabled = enable; if(enable) { $wysiwygBody.keypress(emoticonsKeyPress); if(!base.sourceMode()) { rangeHelper.saveRange(); replaceEmoticons($wysiwygBody[0]); currentEmoticons = $wysiwygBody.find('img[data-sceditor-emoticon]'); rangeHelper.restoreRange(); } } else { $wysiwygBody.find('img[data-sceditor-emoticon]').replaceWith(function() { return $(this).data('sceditor-emoticon'); }); currentEmoticons = []; $wysiwygBody.unbind('keypress', emoticonsKeyPress); } return this; }; /** * Gets the current WYSIWYG editors inline CSS * * @return {string} * @function * @name css * @memberOf jQuery.sceditor.prototype * @since 1.4.3 */ /** * Sets inline CSS for the WYSIWYG editor * * @param {string} css * @return {this} * @function * @name css^2 * @memberOf jQuery.sceditor.prototype * @since 1.4.3 */ base.css = function(css) { if(!inlineCss) inlineCss = $('').appendTo($wysiwygDoc.find('head'))[0]; if(typeof css != 'string') return inlineCss.styleSheet ? inlineCss.styleSheet.cssText : inlineCss.innerHTML; if(inlineCss.styleSheet) inlineCss.styleSheet.cssText = css; else inlineCss.innerHTML = css; return this; }; /** * Handles the keydown event, used for shortcuts * @private */ handleKeyDown = function(e) { var shortcut = [], shift_keys = { '`':'~', '1':'!', '2':'@', '3':'#', '4':'$', '5':'%', '6':'^', '7':'&', '8':'*', '9':'(', '0':')', '-':'_', '=':'+', ';':':', '\'':'"', ',':'<', '.':'>', '/':'?', '\\':'|', '[':'{', ']':'}' }, special_keys = { 8:'backspace', 9:'tab', 13:'enter', 19:'pause', 20:'capslock', 27:'esc', 32:'space', 33:'pageup', 34:'pagedown', 35:'end', 36:'home', 37:'left', 38:'up', 39:'right', 40:'down', 45:'insert', 46:'del', 91: 'win', 92: 'win', 93:'select', 96:'0', 97:'1', 98:'2', 99:'3', 100:'4', 101:'5', 102:'6', 103:'7', 104:'8', 105:'9', 106:'*', 107:'+', 109:'-', 110:'.', 111:'/', 112:'f1', 113:'f2', 114:'f3', 115:'f4', 116:'f5', 117:'f6', 118:'f7', 119:'f8', 120:'f9', 121:'f10', 122:'f11', 123:'f12', 144:'numlock', 145:'scrolllock', 186:';', 187:'=', 188:',', 189:'-', 190:'.', 191:'/', 192:'`', 219:'[', 220:'\\', 221:']', 222:'\'' }, numpad_shift_keys = { 109:'-', 110:'del', 111:'/', 96:'0', 97:'1', 98:'2', 99:'3', 100:'4', 101:'5', 102:'6', 103:'7', 104:'8', 105:'9' }, which = e.which, character = special_keys[which] || String.fromCharCode(which).toLowerCase(); if(e.ctrlKey) shortcut.push('ctrl'); if(e.altKey) shortcut.push('alt'); if(e.shiftKey) { shortcut.push('shift'); if(numpad_shift_keys[which]) character = numpad_shift_keys[which]; else if(shift_keys[character]) character = shift_keys[character]; } // Shift is 16, ctrl is 17 and alt is 18 if(character && (which < 16 || which > 18)) shortcut.push(character); shortcut = shortcut.join('+'); if(shortcutHandlers[shortcut]) return shortcutHandlers[shortcut].call(base); }; /** * Adds a shortcut handler to the editor * @param {String} shortcut * @param {String|Function} cmd * @return {jQuery.sceditor} */ base.addShortcut = function(shortcut, cmd) { shortcut = shortcut.toLowerCase(); if(typeof cmd === "string") { shortcutHandlers[shortcut] = function() { handleCommand($toolbar.find('.sceditor-button-' + cmd), base.commands[cmd]); return false; }; } else shortcutHandlers[shortcut] = cmd; return this; }; /** * Removes a shortcut handler * @param {String} shortcut * @return {jQuery.sceditor} */ base.removeShortcut = function(shortcut) { delete shortcutHandlers[shortcut.toLowerCase()]; return this; }; /** * Handles the backspace key press * * Will remove block styling like quotes/code ect if at the start. * @private */ handleBackSpace = function(e) { var node, offset, tmpRange, range, parent; // 8 is the backspace key if($.sceditor.ie || options.disableBlockRemove || e.which !== 8 || !(range = rangeHelper.selectedRange())) return; if(!window.getSelection) { node = range.parentElement(); tmpRange = $wysiwygDoc[0].selection.createRange(); // Select te entire parent and set the end as start of the current range tmpRange.moveToElementText(node); tmpRange.setEndPoint('EndToStart', range); // Number of characters selected is the start offset // relative to the parent node offset = tmpRange.text.length; } else { node = range.startContainer; offset = range.startOffset; } if(offset !== 0 || !(parent = currentStyledBlockNode())) return; while(node !== parent) { while(node.previousSibling) { node = node.previousSibling; // Everything but empty text nodes before the cursor // should prevent the style from being removed if(node.nodeType !== 3 || node.nodeValue) return; } if(!(node = node.parentNode)) return; } if(!parent || $(parent).is('body')) return; // The backspace was pressed at the start of // the container so clear the style base.clearBlockFormatting(parent); return false; }; /** * Gets the first styled block node that contains the cursor * @return {HTMLElement} */ currentStyledBlockNode = function() { var block = currentBlockNode; while(!$.sceditor.dom.hasStyling(block)) { if(!(block = block.parentNode) || $(block).is('body')) return; } return block; }; /** * Clears the formatting of the passed block element. * * If block is false, if will clear the styling of the first * block level element that contains the cursor. * @param {HTMLElement} block * @since 1.4.4 */ base.clearBlockFormatting = function(block) { block = block || currentStyledBlockNode(); if(!block || $(block).is('body')) return this; rangeHelper.saveRange(); lastRange = null; block.className = ''; $(block).attr('style', ''); if(!$(block).is('p,div')) $.sceditor.dom.convertElement(block, 'p'); rangeHelper.restoreRange(); return this; }; // run the initializer init(); }; /** *Detects the version of IE is being used if any.
* *Returns the IE version number or undefined if not IE.
* *Source: https://gist.github.com/527683 with extra code for IE 10 detection
* @function * @name ie * @memberOf jQuery.sceditor * @type {int} */ $.sceditor.ie = (function(){ var undef, v = 3, div = document.createElement('div'), all = div.getElementsByTagName('i'); do { div.innerHTML = ''; } while (all[0]); // Detect IE 10 as it doesn't support conditional comments. if((document.documentMode && document.all && window.atob)) v = 10; // Detect IE 11 if(v === 4 && document.documentMode) v = 11; return v > 4 ? v : undef; }()); /** *Detects if the browser is iOS
* *Needed to fix iOS specific bugs/
* * @function * @name ios * @memberOf jQuery.sceditor * @type {Boolean} */ $.sceditor.ios = /iPhone|iPod|iPad| wosbrowser\//i.test(navigator.userAgent); /** * If the browser supports WYSIWYG editing (e.g. older mobile browsers). * @function * @name isWysiwygSupported * @memberOf jQuery.sceditor * @return {Boolean} */ $.sceditor.isWysiwygSupported = (function() { var match, isUnsupported, contentEditable = $('' + ($.sceditor.ie ? '' : ' ') + ' | ';
html += '
', '
');
},
tooltip: 'Code'
},
// END_COMMAND
// START_COMMAND: Image
image: {
exec: function (caller) {
var editor = this,
content = _tmpl('image', {
url: editor._('URL:'),
width: editor._('Width (optional):'),
height: editor._('Height (optional):'),
insert: editor._('Insert')
}, true);
content.find('.button').click(function (e) {
var val = content.find('#image').val(),
width = content.find('#width').val(),
height = content.find('#height').val(),
attrs = '';
if(width)
attrs += ' width="' + width + '"';
if(height)
attrs += ' height="' + height + '"';
if(val && val !== 'http://')
editor.wysiwygEditorInsertHtml('');
editor.closeDropDown(true);
e.preventDefault();
});
editor.createDropDown(caller, 'insertimage', content);
},
tooltip: 'Insert an image'
},
// END_COMMAND
// START_COMMAND: E-mail
email: {
exec: function (caller) {
var editor = this,
content = _tmpl('email', {
label: editor._('E-mail:'),
insert: editor._('Insert')
}, true);
content.find('.button').click(function (e) {
var val = content.find('#email').val();
if(val)
{
// needed for IE to reset the last range
editor.focus();
if(!editor.getRangeHelper().selectedHtml())
editor.wysiwygEditorInsertHtml('' + val + '');
else
editor.execCommand('createlink', 'mailto:' + val);
}
editor.closeDropDown(true);
e.preventDefault();
});
editor.createDropDown(caller, 'insertemail', content);
},
tooltip: 'Insert an email'
},
// END_COMMAND
// START_COMMAND: Link
link: {
exec: function (caller) {
var editor = this,
content = _tmpl('link', {
url: editor._('URL:'),
desc: editor._('Description (optional):'),
ins: editor._('Insert')
}, true);
content.find('.button').click(function (e) {
var val = content.find('#link').val(),
description = content.find('#des').val();
if(val && val !== 'http://') {
// needed for IE to reset the last range
editor.focus();
if(!editor.getRangeHelper().selectedHtml() || description)
{
if(!description)
description = val;
// @SMF code: otherwise all the urls become iurl
editor.wysiwygEditorInsertHtml('' + description + '');
}
else
editor.execCommand('createlink', val);
}
editor.closeDropDown(true);
e.preventDefault();
});
editor.createDropDown(caller, 'insertlink', content);
},
tooltip: 'Insert a link'
},
// END_COMMAND
// START_COMMAND: Unlink
unlink: {
state: function() {
var $current = $(this.currentNode());
return $current.is('a') || $current.parents('a').length > 0 ? 0 : -1;
},
exec: function() {
var $current = $(this.currentNode()),
$anchor = $current.is('a') ? $current : $current.parents('a').first();
if($anchor.length)
$anchor.replaceWith($anchor.contents());
},
tooltip: 'Unlink'
},
// END_COMMAND
// START_COMMAND: Quote
quote: {
forceNewLineAfter: ['blockquote'],
exec: function (caller, html, author) {
var before = '', end = ''; // if there is HTML passed set end to null so any selected // text is replaced if(html) { author = (author ? '' + author + '' : ''); before = before + author + html + end; end = null; } // if not add a newline to the end of the inserted quote else if(this.getRangeHelper().selectedHtml() === '') end = $.sceditor.ie ? '' : '
Inserts HTML into the current range replacing any selected * text.
* *If endHTML is specified the selected contents will be put between * html and endHTML. If there is nothing selected html and endHTML are * just concated together.
* * @param {string} html * @param {string} endHTML * @return False on fail * @function * @name insertHTML * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.insertHTML = function(html, endHTML) { var node, div, range = base.selectedRange(); if(endHTML) html += base.selectedHtml() + endHTML; if(isW3C) { div = doc.createElement('div'); node = doc.createDocumentFragment(); div.innerHTML = html; while(div.firstChild) node.appendChild(div.firstChild); base.insertNode(node); } else { if(!range) return false; range.pasteHTML(html); } }; /** *The same as insertHTML except with DOM nodes instead
* *Warning: the nodes must belong to the * document they are being inserted into. Some browsers * will throw exceptions if they don't.
* * @param {Node} node * @param {Node} endNode * @return False on fail * @function * @name insertNode * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.insertNode = function(node, endNode) { if(isW3C) { var selection, selectAfter, toInsert = doc.createDocumentFragment(), range = base.selectedRange(); if(!range) return false; toInsert.appendChild(node); if(endNode) { toInsert.appendChild(range.extractContents()); toInsert.appendChild(endNode); } selectAfter = toInsert.lastChild; // If the last child is undefined then there is nothing to insert so return if(!selectAfter) return; range.deleteContents(); range.insertNode(toInsert); selection = doc.createRange(); selection.setStartAfter(selectAfter); base.selectRange(selection); } else base.insertHTML(node.outerHTML, endNode?endNode.outerHTML:null); }; /** *Clones the selected Range
* *IE <= 8 will return a TextRange, all other browsers * will return a Range object.
* * @return {Range|TextRange} * @function * @name cloneSelected * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.cloneSelected = function() { var range = base.selectedRange(); if(range) return isW3C ? range.cloneRange() : range.duplicate(); }; /** *Gets the selected Range
* *IE <= 8 will return a TextRange, all other browsers * will return a Range object.
* * @return {Range|TextRange} * @function * @name selectedRange * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.selectedRange = function() { var range, firstChild, sel = isW3C ? win.getSelection() : doc.selection; if(!sel) return; // When creating a new range, set the start to the body // element to avoid errors in FF. if(sel.getRangeAt && sel.rangeCount <= 0) { firstChild = doc.body; while(firstChild.firstChild) firstChild = firstChild.firstChild; range = doc.createRange(); range.setStart(firstChild, 0); sel.addRange(range); } if(isW3C) range = sel.getRangeAt(0); if(!isW3C && sel.type !== 'Control') range = sel.createRange(); // IE fix to make sure only return selections that are part of the WYSIWYG iframe return _isOwner(range) ? range : null; }; /** * Checks if an IE TextRange range belongs to * this document or not. * * Returns true if the range isn't an IE range or * if the range is null. * * @private */ _isOwner = function(range) { var parent; // IE fix to make sure only return selections that are part of the WYSIWYG iframe return (range && range.parentElement && (parent = range.parentElement())) ? parent.ownerDocument === doc : true; }; /** * Gets if there is currently a selection * * @return {Boolean} * @function * @name hasSelection * @since 1.4.4 * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.hasSelection = function() { var range, sel = isW3C ? win.getSelection() : doc.selection; if(isW3C || !sel) return sel && sel.rangeCount > 0; range = sel.createRange(); return range && _isOwner(range); }; /** * Gets the currently selected HTML * * @return {string} * @function * @name selectedHtml * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.selectedHtml = function() { var div, range = base.selectedRange(); if(!range) return ''; // IE < 9 if(!isW3C && range.text !== '' && range.htmlText) return range.htmlText; // IE9+ and all other browsers if(isW3C) { div = doc.createElement('div'); div.appendChild(range.cloneContents()); return div.innerHTML; } return ''; }; /** * Gets the parent node of the selected contents in the range * * @return {HTMLElement} * @function * @name parentNode * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.parentNode = function() { var range = base.selectedRange(); if(range) return range.parentElement ? range.parentElement() : range.commonAncestorContainer; }; /** * Gets the first block level parent of the selected * contents of the range. * * @return {HTMLElement} * @function * @name getFirstBlockParent * @memberOf jQuery.sceditor.rangeHelper.prototype */ /** * Gets the first block level parent of the selected * contents of the range. * * @param {Node} n The element to get the first block level parent from * @return {HTMLElement} * @function * @name getFirstBlockParent^2 * @since 1.4.1 * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.getFirstBlockParent = function(n) { var func = function(node) { if(!$.sceditor.dom.isInline(node, true)) return node; node = node ? node.parentNode : null; return node ? func(node) : null; }; return func(n || base.parentNode()); }; /** * Inserts a node at either the start or end of the current selection * * @param {Bool} start * @param {Node} node * @function * @name insertNodeAt * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.insertNodeAt = function(start, node) { var currentRange = base.selectedRange(), range = base.cloneSelected(); if(!range) return false; range.collapse(start); if(range.insertNode) range.insertNode(node); else range.pasteHTML(node.outerHTML); // Reselect the current range. // Fixes issue with Chrome losing the selection. Issue#82 base.selectRange(currentRange); }; /** * Creates a marker node * * @param {String} id * @return {Node} * @private */ _createMarker = function(id) { base.removeMarker(id); var marker = doc.createElement('span'); marker.id = id; marker.style.lineHeight = '0'; marker.style.display = 'none'; marker.className = 'sceditor-selection sceditor-ignore'; marker.innerHTML = ' '; return marker; }; /** * Inserts start/end markers for the current selection * which can be used by restoreRange to re-select the * range. * * @memberOf jQuery.sceditor.rangeHelper.prototype * @function * @name insertMarkers */ base.insertMarkers = function() { base.insertNodeAt(true, _createMarker(startMarker)); base.insertNodeAt(false, _createMarker(endMarker)); }; /** * Gets the marker with the specified ID * * @param {String} id * @return {Node} * @function * @name getMarker * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.getMarker = function(id) { return doc.getElementById(id); }; /** * Removes the marker with the specified ID * * @param {String} id * @function * @name removeMarker * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.removeMarker = function(id) { var marker = base.getMarker(id); if(marker) marker.parentNode.removeChild(marker); }; /** * Removes the start/end markers * * @function * @name removeMarkers * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.removeMarkers = function() { base.removeMarker(startMarker); base.removeMarker(endMarker); }; /** * Saves the current range location. Alias of insertMarkers() * * @function * @name saveRage * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.saveRange = function() { base.insertMarkers(); }; /** * Select the specified range * * @param {Range|TextRange} range * @function * @name selectRange * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.selectRange = function(range) { if(isW3C) { win.getSelection().removeAllRanges(); win.getSelection().addRange(range); } else range.select(); }; /** * Restores the last range saved by saveRange() or insertMarkers() * * @function * @name restoreRange * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.restoreRange = function() { var marker, range = base.selectedRange(), start = base.getMarker(startMarker), end = base.getMarker(endMarker); if(!start || !end || !range) return false; if(!isW3C) { range = doc.body.createTextRange(); marker = doc.body.createTextRange(); marker.moveToElementText(start); range.setEndPoint('StartToStart', marker); range.moveStart(characterStr, 0); marker.moveToElementText(end); range.setEndPoint('EndToStart', marker); range.moveEnd(characterStr, 0); base.selectRange(range); } else { range = doc.createRange(); range.setStartBefore(start); range.setEndAfter(end); base.selectRange(range); } base.removeMarkers(); }; /** * Selects the text left and right of the current selection * @param {int} left * @param {int} right * @since 1.4.3 * @function * @name selectOuterText * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.selectOuterText = function(left, right) { var range = base.cloneSelected(); if(!range) return false; range.collapse(false); if(!isW3C) { range.moveStart(characterStr, 0-left); range.moveEnd(characterStr, right); } else { range.setStart(range.startContainer, range.startOffset-left); range.setEnd(range.endContainer, range.endOffset+right); } base.selectRange(range); }; /** * Gets the text left or right of the current selection * @param {Boolean} before * @param {Int} length * @since 1.4.3 * @function * @name selectOuterText * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.getOuterText = function(before, length) { var ret = '', range = base.cloneSelected(); if(!range) return ''; range.collapse(false); if(before) { if(!isW3C) { range.moveStart(characterStr, 0-length); ret = range.text; } else { ret = range.startContainer.textContent.substr(0, range.startOffset); ret = ret.substr(Math.max(0, ret.length - length)); } } else { if(!isW3C) { range.moveEnd(characterStr, length); ret = range.text; } else ret = range.startContainer.textContent.substr(range.startOffset, length); } return ret; }; /** * Replaces keywords with values based on the current caret position * * @param {Array} keywords * @param {Boolean} includeAfter If to include the text after the current caret position or just text before * @param {Boolean} keywordsSorted If the keywords array is pre sorted shortest to longest * @param {Int} longestKeyword Length of the longest keyword * @param {Boolean} requireWhiteSpace If the key must be surrounded by whitespace * @param {String} currrentChar If this is being called from a keypress event, this should be set to the pressed character * @return {Boolean} * @function * @name raplaceKeyword * @memberOf jQuery.sceditor.rangeHelper.prototype */ base.raplaceKeyword = function(keywords, includeAfter, keywordsSorted, longestKeyword, requireWhiteSpace, currrentChar) { if(!keywordsSorted) { keywords.sort(function(a, b){ return a.length - b.length; }); } var beforeStr, str, keywordIdx, numberCharsLeft, keywordRegex, startIdx, keyword, i = keywords.length, maxKeyLen = longestKeyword || keywords[i-1][0].length; if(requireWhiteSpace) { // requireWhiteSpace doesn't work with textRanges as they select text on the // other side of elements causing space-img-key to match when it shouldn't. if(!isW3C) return false; ++maxKeyLen; } beforeStr = base.getOuterText(true, maxKeyLen); str = beforeStr + (currrentChar != null ? currrentChar : ''); if(includeAfter) str += base.getOuterText(false, maxKeyLen); while(i--) { keyword = keywords[i][0]; keywordRegex = new RegExp('(?:[\\s\xA0\u2002\u2003\u2009])' + $.sceditor.regexEscape(keyword) + '(?=[\\s\xA0\u2002\u2003\u2009])'); startIdx = beforeStr.length - 1 - keyword.length; if(requireWhiteSpace) --startIdx; startIdx = Math.max(0, startIdx); if((keywordIdx = requireWhiteSpace ? str.substr(startIdx).search(keywordRegex) : str.indexOf(keyword, startIdx)) > -1) { if(requireWhiteSpace) keywordIdx += startIdx + 1; // Make sure the substr is between beforeStr and after not entirely in one or the other if(keywordIdx > beforeStr.length || (keywordIdx + keyword.length + (requireWhiteSpace ? 1 : 0)) < beforeStr.length) continue; numberCharsLeft = beforeStr.length - keywordIdx; base.selectOuterText(numberCharsLeft, keyword.length - numberCharsLeft - (currrentChar != null && /^\S/.test(currrentChar) ? 1 : 0)); base.insertHTML(keywords[i][1]); return true; } } return false; }; /** * Compares two ranges. * @param {Range|TextRange} rangeA * @param {Range|TextRange} rangeB If undefined it will be set to the current selected range * @return {Boolean} */ base.compare = function(rangeA, rangeB) { if(!rangeB) rangeB = base.selectedRange(); if(!rangeA || !rangeB) return !rangeA && !rangeB; if(!isW3C) { return _isOwner(rangeA) && _isOwner(rangeB) && rangeA.compareEndPoints('EndToEnd', rangeB) === 0 && rangeA.compareEndPoints('StartToStart', rangeB) === 0; } return rangeA.compareBoundaryPoints(Range.END_TO_END, rangeB) === 0 && rangeA.compareBoundaryPoints(Range.START_TO_START, rangeB) === 0; }; }; /** * Static DOM helper class * @class dom * @name jQuery.sceditor.dom */ $.sceditor.dom = /** @lends jQuery.sceditor.dom */ { /** * Loop all child nodes of the passed node * * The function should accept 1 parameter being the node. * If the function returns false the loop will be exited. * * @param {HTMLElement} node * @param {function} func Function that is called for every node, should accept 1 param for the node * @param {bool} innermostFirst If the innermost node should be passed to the function before it's parents * @param {bool} siblingsOnly If to only traverse the nodes siblings * @param {bool} reverse If to traverse the nodes in reverse */ traverse: function(node, func, innermostFirst, siblingsOnly, reverse) { if(node) { node = reverse ? node.lastChild : node.firstChild; while(node != null) { var next = reverse ? node.previousSibling : node.nextSibling; if(!innermostFirst && func(node) === false) return false; // traverse all children if(!siblingsOnly && this.traverse(node, func, innermostFirst, siblingsOnly, reverse) === false) return false; if(innermostFirst && func(node) === false) return false; // move to next child node = next; } } }, /** * Like traverse but loops in reverse * @see traverse */ rTraverse: function(node, func, innermostFirst, siblingsOnly) { this.traverse(node, func, innermostFirst, siblingsOnly, true); }, /** * Parses HTML * @param * @since 1.4.4 * @return {Array} */ parseHTML: function(html, context) { var ret = [], tmp = (context || document).createElement('div'); tmp.innerHTML = html; $.merge(ret, tmp.childNodes); return ret; }, /** * Checks if an element is not a p or div element and if it has any styling. * @param {HTMLElement} elm * @return {Boolean} * @since 1.4.4 */ hasStyling: function(elm) { var $elm = $(elm); return elm && (!$elm.is('p,div') || elm.className || $elm.attr('style') || !$.isEmptyObject($elm.data())); }, /** * Converts an element from one type to another. * * For example it can convert the element to * @param {HTMLElement} elm * @param {String} newElement * @return {HTMLElement} * @since 1.4.4 */ convertElement: function(elm, newElement) { var child, attr, i = elm.attributes.length, newTag = elm.ownerDocument.createElement(newElement); while(i--) { attr = elm.attributes[i]; // IE < 8 returns all possible attribtues, not just specified ones if(!$.sceditor.ie || attr.specified) { // IE < 8 doesn't return the CSS for the style attribute if($.sceditor.ie < 8 && /style/i.test(attr.name)) elm.style.cssText = elm.style.cssText; else newTag.setAttribute(attr.name, attr.value); } } while((child = elm.firstChild)) newTag.appendChild(child); elm.parentNode.replaceChild(newTag, elm); return newTag; }, /** * List of block level elements separated by bars (|) * @type {string} */ blockLevelList: '|body|hr|p|div|h1|h2|h3|h4|h5|h6|address|pre|form|table|tbody|thead|tfoot|th|tr|td|li|ol|ul|blockquote|center|', /** * Checks if an element is inline * * @return {bool} */ isInline: function(elm, includeCodeAsBlock) { if(!elm || elm.nodeType !== 1) return true; elm = elm.tagName.toLowerCase(); if(elm === 'code') return !includeCodeAsBlock; return $.sceditor.dom.blockLevelList.indexOf('|' + elm + '|') < 0; }, /** *Copys the CSS from 1 node to another.
* *Only copies CSS defined on the element e.g. style attr.
* * @param {HTMLElement} from * @param {HTMLElement} to */ copyCSS: function(from, to) { to.style.cssText = from.style.cssText + to.style.cssText; }, /** * Fixes block level elements inside in inline elements. * * @param {HTMLElement} node */ fixNesting: function(node) { var base = this, getLastInlineParent = function(node) { while(base.isInline(node.parentNode, true)) node = node.parentNode; return node; }; base.traverse(node, function(node) { // if node is an element, and it is blocklevel and the parent isn't block level // then it needs fixing if(node.nodeType === 1 && !base.isInline(node, true) && base.isInline(node.parentNode, true)) { var parent = getLastInlineParent(node), rParent = parent.parentNode, before = base.extractContents(parent, node), middle = node; // copy current styling so when moved out of the parent // it still has the same styling base.copyCSS(parent, middle); rParent.insertBefore(before, parent); rParent.insertBefore(middle, parent); } }); }, /** * Finds the common parent of two nodes * * @param {HTMLElement} node1 * @param {HTMLElement} node2 * @return {HTMLElement} */ findCommonAncestor: function(node1, node2) { // not as fast as making two arrays of parents and comparing // but is a lot smaller and as it's currently only used with // fixing invalid nesting so it doesn't need to be very fast return $(node1).parents().has($(node2)).first(); }, getSibling: function(node, previous) { var sibling; if(!node) return null; if((sibling = node[previous ? 'previousSibling' : 'nextSibling'])) return sibling; return $.sceditor.dom.getSibling(node.parentNode, previous); }, /** * Removes unused whitespace from the root and all it's children * * @name removeWhiteSpace^1 * @param HTMLElement root * @return void */ /** * Removes unused whitespace from the root and all it's children. * * If preserveNewLines is true, new line characters will not be removed * * @name removeWhiteSpace^2 * @param HTMLElement root * @param Boolean preserveNewLines * @return void * @since 1.4.3 */ removeWhiteSpace: function(root, preserveNewLines) { var nodeValue, nodeType, next, previous, cssWS, nextNode, trimStart, sibling, getSibling = $.sceditor.dom.getSibling, isInline = $.sceditor.dom.isInline, node = root.firstChild, whitespace = /[\t ]+/g, witespaceAndLines = /[\t\n\r ]+/g; while(node) { nextNode = node.nextSibling; nodeValue = node.nodeValue; nodeType = node.nodeType; // 1 = element if(nodeType === 1 && node.firstChild) { cssWS = $(node).css('whiteSpace'); // pre || pre-wrap with any vendor prefix if(!/pre(?:\-wrap)?$/i.test(cssWS)) $.sceditor.dom.removeWhiteSpace(node, /line$/i.test(cssWS)); } // 3 = textnode if(nodeType === 3 && nodeValue) { next = getSibling(node); previous = getSibling(node, true); sibling = previous; trimStart = false; while($(sibling).hasClass('sceditor-ignore')) sibling = getSibling(sibling, true); // If last sibling is not inline or is a textnode ending in whitespace, // the start whitespace should be stripped if(isInline(node) && sibling) { while(sibling.lastChild) sibling = sibling.lastChild; trimStart = sibling.nodeType === 3 ? /[\t\n\r ]$/.test(sibling.nodeValue) : !isInline(sibling); } if(!isInline(node) || !previous || !isInline(previous) || trimStart) nodeValue = nodeValue.replace(/^[\t\n\r ]+/, ''); if(!isInline(node) || !next || !isInline(next)) nodeValue = nodeValue.replace(/[\t\n\r ]+$/, ''); // Remove empty text nodes if(!nodeValue.length) root.removeChild(node); else node.nodeValue = nodeValue.replace(preserveNewLines ? whitespace : witespaceAndLines, ' '); } node = nextNode; } }, /** * Extracts all the nodes between the start and end nodes * * @param {HTMLElement} startNode The node to start extracting at * @param {HTMLElement} endNode The node to stop extracting at * @return {DocumentFragment} */ extractContents: function(startNode, endNode) { var base = this, $commonAncestor = base.findCommonAncestor(startNode, endNode), commonAncestor = !$commonAncestor ? null : $commonAncestor[0], startReached = false, endReached = false; return (function extract(root) { var df = startNode.ownerDocument.createDocumentFragment(); base.traverse(root, function(node) { // if end has been reached exit loop if(endReached || (node === endNode && startReached)) { endReached = true; return false; } if(node === startNode) startReached = true; var c, n; if(startReached) { // if the start has been reached and this elm contains // the end node then clone it if(jQuery.contains(node, endNode) && node.nodeType === 1) { c = extract(node); n = node.cloneNode(false); n.appendChild(c); df.appendChild(n); } // otherwise just move it else df.appendChild(node); } // if this node contains the start node then add it else if(jQuery.contains(node, startNode) && node.nodeType === 1) { c = extract(node); n = node.cloneNode(false); n.appendChild(c); df.appendChild(n); } }, false); return df; }(commonAncestor)); } }; /** * Object containing SCEditor plugins * @type {Object} * @name plugins * @memberOf jQuery.sceditor */ $.sceditor.plugins = {}; /** * Plugin Manager class * @class PluginManager * @name jQuery.sceditor.PluginManager */ $.sceditor.PluginManager = function(owner) { /** * Alias of this * @private * @type {Object} */ var base = this; /** * Array of all currently registered plugins * @type {Array} * @private */ var plugins = []; /** * Editor instance this plugin manager belongs to * @type {jQuery.sceditor} * @private */ var editorInstance = owner; /** * Changes a signals name from "name" into "signalName". * @param {String} signal * @return {String} * @private */ var formatSignalName = function(signal) { return 'signal' + signal.charAt(0).toUpperCase() + signal.slice(1); }; /** * Calls handlers for a signal * @see call() * @see callOnlyFirst() * @param {Array} args * @param {Boolean} returnAtFirst * @return {Mixed} * @private */ var callHandlers = function(args, returnAtFirst) { args = [].slice.call(args); var i = plugins.length, signal = formatSignalName(args.shift()); while(i--) { if(signal in plugins[i]) { if(returnAtFirst) return plugins[i][signal].apply(editorInstance, args); plugins[i][signal].apply(editorInstance, args); } } }; /** * Calls all handlers for the passed signal * @param {String} signal * @param {...String} args * @return {Void} * @function * @name call * @memberOf jQuery.sceditor.PluginManager.prototype */ base.call = function() { callHandlers(arguments, false); }; /** * Calls the first handler for a signal, and returns the result * @param {String} signal * @param {...String} args * @return {Mixed} The result of calling the handler * @function * @name callOnlyFirst * @memberOf jQuery.sceditor.PluginManager.prototype */ base.callOnlyFirst = function() { return callHandlers(arguments, true); }; /** *Returns an object which has callNext and hasNext methods.
* *callNext takes arguments to pass to the handler and returns the * result of calling the handler
* *hasNext checks if there is another handler
* * @param {String} signal * @return {Object} Object with hasNext and callNext methods * @function * @name iter * @memberOf jQuery.sceditor.PluginManager.prototype */ base.iter = function(signal) { signal = formatSignalName(signal); return (function () { var i = plugins.length; return { callNext: function(args) { while(i--) if(plugins[i] && signal in plugins[i]) return plugins[i].apply(editorInstance, args); }, hasNext: function() { var j = i; while(j--) if(plugins[j] && signal in plugins[j]) return true; return false; } }; }()); }; /** * Checks if a signal has a handler * @param {String} signal * @return {Boolean} * @function * @name hasHandler * @memberOf jQuery.sceditor.PluginManager.prototype */ base.hasHandler = function(signal) { var i = plugins.length; signal = formatSignalName(signal); while(i--) if(signal in plugins[i]) return true; return false; }; /** * Checks if the plugin exists in jQuery.sceditor.plugins * @param {String} plugin * @return {Boolean} * @function * @name exists * @memberOf jQuery.sceditor.PluginManager.prototype */ base.exsists = function(plugin) { if(plugin in $.sceditor.plugins) { plugin = $.sceditor.plugins[plugin]; return typeof plugin === 'function' && typeof plugin.prototype === 'object'; } return false; }; /** * Checks if the passed plugin is currently registered. * @param {String} plugin * @return {Boolean} * @function * @name isRegistered * @memberOf jQuery.sceditor.PluginManager.prototype */ base.isRegistered = function(plugin) { var i = plugins.length; if(!base.exsists(plugin)) return false; while(i--) if(plugins[i] instanceof $.sceditor.plugins[plugin]) return true; return false; }; /** * Registers a plugin to receive signals * @param {String} plugin * @return {Boolean} * @function * @name register * @memberOf jQuery.sceditor.PluginManager.prototype */ base.register = function(plugin) { if(!base.exsists(plugin)) return false; plugin = new $.sceditor.plugins[plugin](); plugins.push(plugin); if('init' in plugin) plugin.init.apply(editorInstance); return true; }; /** * Deregisters a plugin. * @param {String} plugin * @return {Boolean} * @function * @name deregister * @memberOf jQuery.sceditor.PluginManager.prototype */ base.deregister = function(plugin) { var removedPlugin, i = plugins.length, ret = false; if(!base.isRegistered(plugin)) return false; while(i--) { if(plugins[i] instanceof $.sceditor.plugins[plugin]) { removedPlugin = plugins.splice(i, 1)[0]; ret = true; if('destroy' in removedPlugin) removedPlugin.destroy.apply(editorInstance); } } return ret; }; /** *Clears all plugins and removes the owner reference.
* *Calling any functions on this object after calling destroy will cause a JS error.
* @return {Void} * @function * @name destroy * @memberOf jQuery.sceditor.PluginManager.prototype */ base.destroy = function() { var i = plugins.length; while(i--) if('destroy' in plugins[i]) plugins[i].destroy.apply(editorInstance); plugins = null; editorInstance = null; }; }; /** * Static command helper class * @class command * @name jQuery.sceditor.command */ $.sceditor.command = /** @lends jQuery.sceditor.command */ { /** * Gets a command * * @param {String} name * @return {Object|null} * @since v1.3.5 */ get: function(name) { return $.sceditor.commands[name] || null; }, /** *Adds a command to the editor or updates an existing * command if a command with the specified name already exists.
* *Once a command is add it can be included in the toolbar by * adding it's name to the toolbar option in the constructor. It * can also be executed manually by calling {@link jQuery.sceditor.execCommand}
* * @example * $.sceditor.command.set("hello", * { * exec: function() { * alert("Hello World!"); * } * }); * * @param {String} name * @param {Object} cmd * @return {this|false} Returns false if name or cmd is false * @since v1.3.5 */ set: function(name, cmd) { if(!name || !cmd) return false; // merge any existing command properties cmd = $.extend($.sceditor.commands[name] || {}, cmd); cmd.remove = function() { $.sceditor.command.remove(name); }; $.sceditor.commands[name] = cmd; return this; }, /** * Removes a command * * @param {String} name * @return {this} * @since v1.3.5 */ remove: function(name) { if($.sceditor.commands[name]) delete $.sceditor.commands[name]; return this; } }; /** * Default options for SCEditor * @type {Object} * @class defaultOptions * @name jQuery.sceditor.defaultOptions */ $.sceditor.defaultOptions = { /** @lends jQuery.sceditor.defaultOptions */ /** * Toolbar buttons order and groups. Should be comma separated and have a bar | to separate groups * @type {String} */ toolbar: 'bold,italic,underline,strike,subscript,superscript|left,center,right,justify|' + 'font,size,color,removeformat|cut,copy,paste,pastetext|bulletlist,orderedlist|' + 'table|code,quote|horizontalrule,image,email,link,unlink|emoticon,youtube,date,time|' + 'ltr,rtl|print,maximize,source', /** * Comma separated list of commands to excludes from the toolbar * @type {String} */ toolbarExclude: null, /** * Stylesheet to include in the WYSIWYG editor. Will style the WYSIWYG elements * @type {String} */ style: 'jquery.sceditor.default.css', /** * Comma separated list of fonts for the font selector * @type {String} */ fonts: 'Arial,Arial Black,Comic Sans MS,Courier New,Georgia,Impact,Sans-serif,Serif,Times New Roman,Trebuchet MS,Verdana', /** * Colors should be comma separated and have a bar | to signal a new column. * * If null the colors will be auto generated. * @type {string} */ colors: null, /** * The locale to use. * @type {String} */ locale: 'en', /** * The Charset to use * @type {String} */ charset: 'utf-8', /** * Compatibility mode for emoticons. * * Helps if you have emoticons such as :/ which would put an emoticon inside http:// * * This mode requires emoticons to be surrounded by whitespace or end of line chars. * This mode has limited As You Type emoticon conversion support. It will not replace * AYT for end of line chars, only emoticons surrounded by whitespace. They will still * be replaced correctly when loaded just not AYT. * @type {Boolean} */ emoticonsCompat: false, /** * If to enable emoticons. Can be changes at runtime using the emoticons() method. * @type {Boolean} * @since 1.4.2 */ emoticonsEnabled: true, /** * Emoticon root URL * @type {String} */ emoticonsRoot: '', emoticons: { dropdown: { ':)': 'emoticons/smile.png', ':angel:': 'emoticons/angel.png', ':angry:': 'emoticons/angry.png', '8-)': 'emoticons/cool.png', ":'(": 'emoticons/cwy.png', ':ermm:': 'emoticons/ermm.png', ':D': 'emoticons/grin.png', '<3': 'emoticons/heart.png', ':(': 'emoticons/sad.png', ':O': 'emoticons/shocked.png', ':P': 'emoticons/tongue.png', ';)': 'emoticons/wink.png' }, more: { ':alien:': 'emoticons/alien.png', ':blink:': 'emoticons/blink.png', ':blush:': 'emoticons/blush.png', ':cheerful:': 'emoticons/cheerful.png', ':devil:': 'emoticons/devil.png', ':dizzy:': 'emoticons/dizzy.png', ':getlost:': 'emoticons/getlost.png', ':happy:': 'emoticons/happy.png', ':kissing:': 'emoticons/kissing.png', ':ninja:': 'emoticons/ninja.png', ':pinch:': 'emoticons/pinch.png', ':pouty:': 'emoticons/pouty.png', ':sick:': 'emoticons/sick.png', ':sideways:': 'emoticons/sideways.png', ':silly:': 'emoticons/silly.png', ':sleeping:': 'emoticons/sleeping.png', ':unsure:': 'emoticons/unsure.png', ':woot:': 'emoticons/w00t.png', ':wassat:': 'emoticons/wassat.png' }, hidden: { ':whistling:': 'emoticons/whistling.png', ':love:': 'emoticons/wub.png' } }, /** * Width of the editor. Set to null for automatic with * @type {int} */ width: null, /** * Height of the editor including toolbar. Set to null for automatic height * @type {int} */ height: null, /** * If to allow the editor to be resized * @type {Boolean} */ resizeEnabled: true, /** * Min resize to width, set to null for half textarea width or -1 for unlimited * @type {int} */ resizeMinWidth: null, /** * Min resize to height, set to null for half textarea height or -1 for unlimited * @type {int} */ resizeMinHeight: null, /** * Max resize to height, set to null for double textarea height or -1 for unlimited * @type {int} */ resizeMaxHeight: null, /** * Max resize to width, set to null for double textarea width or -1 for unlimited * @type {int} */ resizeMaxWidth: null, /** * If resizing by height is enabled * @type {Boolean} */ resizeHeight: true, /** * If resizing by width is enabled * @type {Boolean} */ resizeWidth: true, getHtmlHandler: null, getTextHandler: null, /** * Date format, will be overridden if locale specifies one. * * The words year, month and day will be replaced with the users current year, month and day. * @type {String} */ dateFormat: 'year-month-day', /** * Element to inset the toolbar into. * @type {HTMLElement} */ toolbarContainer: null, /** * If to enable paste filtering. This is currently experimental, please report any issues. * @type {Boolean} */ enablePasteFiltering: false, /** * If to completely disable pasting into the editor * @type {Boolean} */ disablePasting: false, /** * If the editor is read only. * @type {Boolean} */ readOnly: false, /** * If to set the editor to right-to-left mode. * * If set to null the direction will be automatically detected. * @type {Boolean} */ rtl: false, /** * If to auto focus the editor on page load * @type {Boolean} */ autofocus: false, /** * If to auto focus the editor to the end of the content * @type {Boolean} */ autofocusEnd: true, /** * If to auto expand the editor to fix the content * @type {Boolean} */ autoExpand: false, /** * If to auto update original textbox on blur * @type {Boolean} */ autoUpdate: false, /** * If to enable the browsers built in spell checker * @type {Boolean} */ spellcheck: true, /** * If to run the source editor when there is no WYSIWYG support. Only really applies to mobile OS's. * @type {Boolean} */ runWithoutWysiwygSupport: false, /** * Optional ID to give the editor. * @type {String} */ id: null, /** * Comma separated list of plugins * @type {String} */ plugins: '', /** * z-index to set the editor container to. Needed for jQuery UI dialog. * @type {Int} */ zIndex: null, /** * If to trim the BBCode. Removes any spaces at the start and end of the BBCode string. * @type {Boolean} */ bbcodeTrim: false, /** * If to disable removing block level elements by pressing backspace at the start of them * @type {Boolean} */ disableBlockRemove: false, /** * BBCode parser options, only applies if using the editor in BBCode mode. * * See $.sceditor.BBCodeParser.defaults for list of valid options * @type {Object} */ parserOptions: { }, /** * CSS that will be added to the to dropdown menu (eg. z-index) * @type {Object} */ dropDownCss: { } }; /** * Creates an instance of sceditor on all textareas * matched by the jQuery selector. * * If options is set to "state" it will return bool value * indicating if the editor has been initilised on the * matched textarea(s). If there is only one textarea * it will return the bool value for that textarea. * If more than one textarea is matched it will * return an array of bool values for each textarea. * * If options is set to "instance" it will return the * current editor instance for the textarea(s). Like the * state option, if only one textarea is matched this will * return just the instance for that textarea. If more than * one textarea is matched it will return an array of * instances each textarea. * * @param {Object|String} options Should either be an Object of options or the strings "state" or "instance" * @return {this|Array|jQuery.sceditor|Bool} */ $.fn.sceditor = function (options) { var $this, ret = []; options = options || {}; if(!options.runWithoutWysiwygSupport && !$.sceditor.isWysiwygSupported) return; this.each(function () { $this = this.jquery ? this : $(this); // Don't allow the editor to be initilised on it's own source editor if($this.parents('.sceditor-container').length > 0) return; // Add state of instance to ret if that is what options is set to if(options === 'state') ret.push(!!$this.data('sceditor')); else if(options === 'instance') ret.push($this.data('sceditor')); else if(!$this.data('sceditor')) (new $.sceditor(this, options)); }); // If nothing in the ret array then must be init so return this if(!ret.length) return this; return ret.length === 1 ? ret[0] : $(ret); }; })(jQuery, window, document);