X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/ff81ee6e8304a1982a3ec4f5b134764a29d502cf..febc815b2c9d85be5717da9e8d164bd2daa97e31:/wp-includes/js/quicktags.js
diff --git a/wp-includes/js/quicktags.js b/wp-includes/js/quicktags.js
index be628e07..6d00901a 100644
--- a/wp-includes/js/quicktags.js
+++ b/wp-includes/js/quicktags.js
@@ -1,389 +1,712 @@
+/* global adminpage, wpActiveEditor, quicktagsL10n, wpLink, prompt */
+/*
+ * Quicktags
+ *
+ * This is the HTML editor in WordPress. It can be attached to any textarea and will
+ * append a toolbar above it. This script is self-contained (does not require external libraries).
+ *
+ * Run quicktags(settings) to initialize it, where settings is an object containing up to 3 properties:
+ * settings = {
+ * id : 'my_id', the HTML ID of the textarea, required
+ * buttons: '' Comma separated list of the names of the default buttons to show. Optional.
+ * Current list of default button names: 'strong,em,link,block,del,ins,img,ul,ol,li,code,more,close';
+ * }
+ *
+ * The settings can also be a string quicktags_id.
+ *
+ * quicktags_id string The ID of the textarea that will be the editor canvas
+ * buttons string Comma separated list of the default buttons names that will be shown in that instance.
+ */
+
// new edit toolbar used with permission
// by Alex King
// http://www.alexking.org/
-var edButtons = new Array();
-var edLinks = new Array();
-var edOpenTags = new Array();
-
-function edButton(id, display, tagStart, tagEnd, access, open) {
- this.id = id; // used to name the toolbar button
- this.display = display; // label on button
- this.tagStart = tagStart; // open tag
- this.tagEnd = tagEnd; // close tag
- this.access = access; // access key
- this.open = open; // set to -1 if tag does not need to be closed
+var QTags, edCanvas,
+ edButtons = [];
+
+/* jshint ignore:start */
+
+/**
+ * Back-compat
+ *
+ * Define all former global functions so plugins that hack quicktags.js directly don't cause fatal errors.
+ */
+var edAddTag = function(){},
+edCheckOpenTags = function(){},
+edCloseAllTags = function(){},
+edInsertImage = function(){},
+edInsertLink = function(){},
+edInsertTag = function(){},
+edLink = function(){},
+edQuickLink = function(){},
+edRemoveTag = function(){},
+edShowButton = function(){},
+edShowLinks = function(){},
+edSpell = function(){},
+edToolbar = function(){};
+
+/**
+ * Initialize new instance of the Quicktags editor
+ */
+function quicktags(settings) {
+ return new QTags(settings);
}
-function zeroise(number, threshold) {
- // FIXME: or we could use an implementation of printf in js here
- var str = number.toString();
- if (number < 0) { str = str.substr(1, str.length) }
- while (str.length < threshold) { str = "0" + str }
- if (number < 0) { str = '-' + str }
- return str;
+/**
+ * Inserts content at the caret in the active editor (textarea)
+ *
+ * Added for back compatibility
+ * @see QTags.insertContent()
+ */
+function edInsertContent(bah, txt) {
+ return QTags.insertContent(txt);
}
-var now = new Date();
-var datetime = now.getUTCFullYear() + '-' +
-zeroise(now.getUTCMonth() + 1, 2) + '-' +
-zeroise(now.getUTCDate(), 2) + 'T' +
-zeroise(now.getUTCHours(), 2) + ':' +
-zeroise(now.getUTCMinutes(), 2) + ':' +
-zeroise(now.getUTCSeconds() ,2) +
-'+00:00';
-
-edButtons[edButtons.length] =
-new edButton('ed_strong'
-,'b'
-,''
-,' '
-,'b'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_em'
-,'i'
-,''
-,' '
-,'i'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_link'
-,'link'
-,''
-,''
-,'a'
-); // special case
-
-edButtons[edButtons.length] =
-new edButton('ed_block'
-,'b-quote'
-,'\n\n'
-,' \n\n'
-,'q'
-);
-
-
-edButtons[edButtons.length] =
-new edButton('ed_del'
-,'del'
-,''
-,''
-,'d'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_ins'
-,'ins'
-,''
-,' '
-,'s'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_img'
-,'img'
-,''
-,''
-,'m'
-,-1
-); // special case
-
-edButtons[edButtons.length] =
-new edButton('ed_ul'
-,'ul'
-,'\n\n'
-,'u'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_ol'
-,'ol'
-,'\n'
-,' \n\n'
-,'o'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_li'
-,'li'
-,'\t'
-,' \n'
-,'l'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_code'
-,'code'
-,''
-,''
-,'c'
-);
-
-edButtons[edButtons.length] =
-new edButton('ed_more'
-,'more'
-,''
-,''
-,'t'
-,-1
-);
-/*
-edButtons[edButtons.length] =
-new edButton('ed_next'
-,'page'
-,''
-,''
-,'p'
-,-1
-);
-*/
-function edLink() {
- this.display = '';
- this.URL = '';
- this.newWin = 0;
+/**
+ * Adds a button to all instances of the editor
+ *
+ * Added for back compatibility, use QTags.addButton() as it gives more flexibility like type of button, button placement, etc.
+ * @see QTags.addButton()
+ */
+function edButton(id, display, tagStart, tagEnd, access) {
+ return QTags.addButton( id, display, tagStart, tagEnd, access, '', -1 );
}
-edLinks[edLinks.length] = new edLink('WordPress'
- ,'http://wordpress.org/'
- );
+/* jshint ignore:end */
+
+(function(){
+ // private stuff is prefixed with an underscore
+ var _domReady = function(func) {
+ var t, i, DOMContentLoaded, _tryReady;
+
+ if ( typeof jQuery !== 'undefined' ) {
+ jQuery(document).ready(func);
+ } else {
+ t = _domReady;
+ t.funcs = [];
+
+ t.ready = function() {
+ if ( ! t.isReady ) {
+ t.isReady = true;
+ for ( i = 0; i < t.funcs.length; i++ ) {
+ t.funcs[i]();
+ }
+ }
+ };
+
+ if ( t.isReady ) {
+ func();
+ } else {
+ t.funcs.push(func);
+ }
-edLinks[edLinks.length] = new edLink('alexking.org'
- ,'http://www.alexking.org/'
- );
+ if ( ! t.eventAttached ) {
+ if ( document.addEventListener ) {
+ DOMContentLoaded = function(){document.removeEventListener('DOMContentLoaded', DOMContentLoaded, false);t.ready();};
+ document.addEventListener('DOMContentLoaded', DOMContentLoaded, false);
+ window.addEventListener('load', t.ready, false);
+ } else if ( document.attachEvent ) {
+ DOMContentLoaded = function(){if (document.readyState === 'complete'){ document.detachEvent('onreadystatechange', DOMContentLoaded);t.ready();}};
+ document.attachEvent('onreadystatechange', DOMContentLoaded);
+ window.attachEvent('onload', t.ready);
+
+ _tryReady = function() {
+ try {
+ document.documentElement.doScroll('left');
+ } catch(e) {
+ setTimeout(_tryReady, 50);
+ return;
+ }
+
+ t.ready();
+ };
+ _tryReady();
+ }
+
+ t.eventAttached = true;
+ }
+ }
+ },
-function edShowButton(button, i) {
- if (button.id == 'ed_img') {
- document.write('(Quick Links) ';
- for (i = 0; i < edLinks.length; i++) {
- tempStr += '' + edLinks[i].display + ' ';
- }
- tempStr += ''
- + edLinks[i].display
- + ' ';
- thisSelect.selectedIndex = 0;
- edInsertContent(edCanvas, tempStr);
- }
- else {
- thisSelect.selectedIndex = 0;
- }
-}
-function edSpell(myField) {
- var word = '';
- if (document.selection) {
- myField.focus();
- var sel = document.selection.createRange();
- if (sel.text.length > 0) {
- word = sel.text;
+ canvas.parentNode.insertBefore(tb, canvas);
+ t.toolbar = tb;
+
+ // listen for click events
+ onclick = function(e) {
+ e = e || window.event;
+ var target = e.target || e.srcElement, visible = target.clientWidth || target.offsetWidth, i;
+
+ // don't call the callback on pressing the accesskey when the button is not visible
+ if ( !visible ) {
+ return;
+ }
+
+ // as long as it has the class ed_button, execute the callback
+ if ( / ed_button /.test(' ' + target.className + ' ') ) {
+ // we have to reassign canvas here
+ t.canvas = canvas = document.getElementById(id);
+ i = target.id.replace(name + '_', '');
+
+ if ( t.theButtons[i] ) {
+ t.theButtons[i].callback.call(t.theButtons[i], target, canvas, t);
+ }
+ }
+ };
+
+ setActiveEditor = function() {
+ window.wpActiveEditor = id;
+ };
+
+ wrap = document.getElementById( 'wp-' + id + '-wrap' );
+
+ if ( tb.addEventListener ) {
+ tb.addEventListener( 'click', onclick, false );
+
+ if ( wrap ) {
+ wrap.addEventListener( 'click', setActiveEditor, false );
+ }
+ } else if ( tb.attachEvent ) {
+ tb.attachEvent( 'onclick', onclick );
+
+ if ( wrap ) {
+ wrap.attachEvent( 'onclick', setActiveEditor );
+ }
}
- }
- else if (myField.selectionStart || myField.selectionStart == '0') {
- var startPos = myField.selectionStart;
- var endPos = myField.selectionEnd;
- if (startPos != endPos) {
- word = myField.value.substring(startPos, endPos);
+
+ t.getButton = function(id) {
+ return t.theButtons[id];
+ };
+
+ t.getButtonElement = function(id) {
+ return document.getElementById(name + '_' + id);
+ };
+
+ qt.instances[id] = t;
+
+ if ( ! qt.instances['0'] ) {
+ qt.instances['0'] = qt.instances[id];
+ _domReady( function(){ qt._buttonsInit(); } );
}
- }
- if (word == '') {
- word = prompt('Enter a word to look up:', '');
- }
- if (word !== null && /^\w[\w ]*$/.test(word)) {
- window.open('http://www.answers.com/' + escape(word));
- }
-}
+ };
-function edToolbar() {
- document.write('');
- for (i = 0; i < edButtons.length; i++) {
- edShowButton(edButtons[i], i);
+ function _escape( text ) {
+ text = text || '';
+ text = text.replace( /&([^#])(?![a-z1-4]{1,8};)/gi, '&$1' );
+ return text.replace( //g, '>' ).replace( /"/g, '"' ).replace( /'/g, ''' );
}
- document.write('
');
-}
-// insertion code
+ qt.instances = {};
+
+ qt.getInstance = function(id) {
+ return qt.instances[id];
+ };
+
+ qt._buttonsInit = function() {
+ var t = this, canvas, name, settings, theButtons, html, inst, ed, id, i, use,
+ defaults = ',strong,em,link,block,del,ins,img,ul,ol,li,code,more,close,';
+
+ for ( inst in t.instances ) {
+ if ( '0' === inst ) {
+ continue;
+ }
+
+ ed = t.instances[inst];
+ canvas = ed.canvas;
+ name = ed.name;
+ settings = ed.settings;
+ html = '';
+ theButtons = {};
+ use = '';
+
+ // set buttons
+ if ( settings.buttons ) {
+ use = ','+settings.buttons+',';
+ }
+
+ for ( i in edButtons ) {
+ if ( !edButtons[i] ) {
+ continue;
+ }
+
+ id = edButtons[i].id;
+ if ( use && defaults.indexOf( ',' + id + ',' ) !== -1 && use.indexOf( ',' + id + ',' ) === -1 ) {
+ continue;
+ }
+
+ if ( !edButtons[i].instance || edButtons[i].instance === inst ) {
+ theButtons[id] = edButtons[i];
+
+ if ( edButtons[i].html ) {
+ html += edButtons[i].html(name + '_');
+ }
+ }
+ }
+
+ if ( use && use.indexOf(',dfw,') !== -1 ) {
+ theButtons.dfw = new qt.DFWButton();
+ html += theButtons.dfw.html( name + '_' );
+ }
+
+ if ( 'rtl' === document.getElementsByTagName('html')[0].dir ) {
+ theButtons.textdirection = new qt.TextDirectionButton();
+ html += theButtons.textdirection.html(name + '_');
+ }
-function edInsertTag(myField, i) {
- //IE support
- if (document.selection) {
- myField.focus();
- sel = document.selection.createRange();
- if (sel.text.length > 0) {
- sel.text = edButtons[i].tagStart + sel.text + edButtons[i].tagEnd;
+ ed.toolbar.innerHTML = html;
+ ed.theButtons = theButtons;
+
+ if ( typeof jQuery !== 'undefined' ) {
+ jQuery( document ).triggerHandler( 'quicktags-init', [ ed ] );
+ }
+ }
+ t.buttonsInitDone = true;
+ };
+
+ /**
+ * Main API function for adding a button to Quicktags
+ *
+ * Adds qt.Button or qt.TagButton depending on the args. The first three args are always required.
+ * To be able to add button(s) to Quicktags, your script should be enqueued as dependent
+ * on "quicktags" and outputted in the footer. If you are echoing JS directly from PHP,
+ * use add_action( 'admin_print_footer_scripts', 'output_my_js', 100 ) or add_action( 'wp_footer', 'output_my_js', 100 )
+ *
+ * Minimum required to add a button that calls an external function:
+ * QTags.addButton( 'my_id', 'my button', my_callback );
+ * function my_callback() { alert('yeah!'); }
+ *
+ * Minimum required to add a button that inserts a tag:
+ * QTags.addButton( 'my_id', 'my button', '', ' ' );
+ * QTags.addButton( 'my_id2', 'my button', '" or a callback that is executed when the button is clicked.
+ * @param string arg2 Optional. Ending tag like " "
+ * @param string access_key Deprecated Not used
+ * @param string title Optional. Button's title="..."
+ * @param int priority Optional. Number representing the desired position of the button in the toolbar. 1 - 9 = first, 11 - 19 = second, 21 - 29 = third, etc.
+ * @param string instance Optional. Limit the button to a specific instance of Quicktags, add to all instances if not present.
+ * @param attr object Optional. Used to pass additional attributes. Currently supports `ariaLabel` and `ariaLabelClose` (for "close tag" state)
+ * @return mixed null or the button object that is needed for back-compat.
+ */
+ qt.addButton = function( id, display, arg1, arg2, access_key, title, priority, instance, attr ) {
+ var btn;
+
+ if ( !id || !display ) {
+ return;
+ }
+
+ priority = priority || 0;
+ arg2 = arg2 || '';
+ attr = attr || {};
+
+ if ( typeof(arg1) === 'function' ) {
+ btn = new qt.Button( id, display, access_key, title, instance, attr );
+ btn.callback = arg1;
+ } else if ( typeof(arg1) === 'string' ) {
+ btn = new qt.TagButton( id, display, arg1, arg2, access_key, title, instance, attr );
+ } else {
+ return;
+ }
+
+ if ( priority === -1 ) { // back-compat
+ return btn;
+ }
+
+ if ( priority > 0 ) {
+ while ( typeof(edButtons[priority]) !== 'undefined' ) {
+ priority++;
+ }
+
+ edButtons[priority] = btn;
+ } else {
+ edButtons[edButtons.length] = btn;
+ }
+
+ if ( this.buttonsInitDone ) {
+ this._buttonsInit(); // add the button HTML to all instances toolbars if addButton() was called too late
+ }
+ };
+
+ qt.insertContent = function(content) {
+ var sel, startPos, endPos, scrollTop, text, canvas = document.getElementById(wpActiveEditor);
+
+ if ( !canvas ) {
+ return false;
}
- else {
- if (!edCheckOpenTags(i) || edButtons[i].tagEnd == '') {
- sel.text = edButtons[i].tagStart;
- edAddTag(i);
+
+ if ( document.selection ) { //IE
+ canvas.focus();
+ sel = document.selection.createRange();
+ sel.text = content;
+ canvas.focus();
+ } else if ( canvas.selectionStart || canvas.selectionStart === 0 ) { // FF, WebKit, Opera
+ text = canvas.value;
+ startPos = canvas.selectionStart;
+ endPos = canvas.selectionEnd;
+ scrollTop = canvas.scrollTop;
+
+ canvas.value = text.substring(0, startPos) + content + text.substring(endPos, text.length);
+
+ canvas.selectionStart = startPos + content.length;
+ canvas.selectionEnd = startPos + content.length;
+ canvas.scrollTop = scrollTop;
+ canvas.focus();
+ } else {
+ canvas.value += content;
+ canvas.focus();
+ }
+ return true;
+ };
+
+ // a plain, dumb button
+ qt.Button = function( id, display, access, title, instance, attr ) {
+ this.id = id;
+ this.display = display;
+ this.access = '';
+ this.title = title || '';
+ this.instance = instance || '';
+ this.attr = attr || {};
+ };
+ qt.Button.prototype.html = function(idPrefix) {
+ var active, on, wp,
+ title = this.title ? ' title="' + _escape( this.title ) + '"' : '',
+ ariaLabel = this.attr && this.attr.ariaLabel ? ' aria-label="' + _escape( this.attr.ariaLabel ) + '"' : '',
+ val = this.display ? ' value="' + _escape( this.display ) + '"' : '',
+ id = this.id ? ' id="' + _escape( idPrefix + this.id ) + '"' : '',
+ dfw = ( wp = window.wp ) && wp.editor && wp.editor.dfw;
+
+ if ( this.id === 'fullscreen' ) {
+ return '';
+ qt.TagButton.prototype.callback.call(t, e, c, ed);
}
+ } else {
+ qt.TagButton.prototype.callback.call(t, e, c, ed);
}
- myField.focus();
- myField.selectionStart = cursorPos;
- myField.selectionEnd = cursorPos;
- myField.scrollTop = scrollTop;
- }
- else {
- if (!edCheckOpenTags(i) || edButtons[i].tagEnd == '') {
- myField.value += edButtons[i].tagStart;
- edAddTag(i);
+ };
+
+ // the img button
+ qt.ImgButton = function() {
+ var attr = {
+ ariaLabel: quicktagsL10n.image
+ };
+
+ qt.TagButton.call( this, 'img', 'img', '', '', '', '', '', attr );
+ };
+ qt.ImgButton.prototype = new qt.TagButton();
+ qt.ImgButton.prototype.callback = function(e, c, ed, defaultValue) {
+ if ( ! defaultValue ) {
+ defaultValue = 'http://';
}
- else {
- myField.value += edButtons[i].tagEnd;
- edRemoveTag(i);
+ var src = prompt(quicktagsL10n.enterImageURL, defaultValue), alt;
+ if ( src ) {
+ alt = prompt(quicktagsL10n.enterImageDescription, '');
+ this.tagStart = ' ';
- edInsertTag(myField, i);
+ if ( ! ( wp = window.wp ) || ! wp.editor || ! wp.editor.dfw ) {
+ return;
}
- }
- else {
- edInsertTag(myField, i);
- }
-}
-function edInsertImage(myField) {
- var myValue = prompt('Enter the URL of the image', 'http://');
- if (myValue) {
- myValue = '', ' ', '', '', '', { ariaLabel: quicktagsL10n.strong, ariaLabelClose: quicktagsL10n.strongClose } );
+ edButtons[20] = new qt.TagButton( 'em', 'i', '', ' ', '', '', '', { ariaLabel: quicktagsL10n.em, ariaLabelClose: quicktagsL10n.emClose } );
+ edButtons[30] = new qt.LinkButton(); // special case
+ edButtons[40] = new qt.TagButton( 'block', 'b-quote', '\n\n', ' \n\n', '', '', '', { ariaLabel: quicktagsL10n.blockquote, ariaLabelClose: quicktagsL10n.blockquoteClose } );
+ edButtons[50] = new qt.TagButton( 'del', 'del', '', '', '', '', '', { ariaLabel: quicktagsL10n.del, ariaLabelClose: quicktagsL10n.delClose } );
+ edButtons[60] = new qt.TagButton( 'ins', 'ins', '', ' ', '', '', '', { ariaLabel: quicktagsL10n.ins, ariaLabelClose: quicktagsL10n.insClose } );
+ edButtons[70] = new qt.ImgButton(); // special case
+ edButtons[80] = new qt.TagButton( 'ul', 'ul', '\n\n', '', '', '', { ariaLabel: quicktagsL10n.ul, ariaLabelClose: quicktagsL10n.ulClose } );
+ edButtons[90] = new qt.TagButton( 'ol', 'ol', '\n', ' \n\n', '', '', '', { ariaLabel: quicktagsL10n.ol, ariaLabelClose: quicktagsL10n.olClose } );
+ edButtons[100] = new qt.TagButton( 'li', 'li', '\t', ' \n', '', '', '', { ariaLabel: quicktagsL10n.li, ariaLabelClose: quicktagsL10n.liClose } );
+ edButtons[110] = new qt.TagButton( 'code', 'code', '', '', '', '', '', { ariaLabel: quicktagsL10n.code, ariaLabelClose: quicktagsL10n.codeClose } );
+ edButtons[120] = new qt.TagButton( 'more', 'more', '\n\n', '', '', '', '', { ariaLabel: quicktagsL10n.more } );
+ edButtons[140] = new qt.CloseButton();
+
+})();