Editor: Improve post.js documentation.

Props jipmoors, boblinthorst.
Fixes #38118.

git-svn-id: https://develop.svn.wordpress.org/trunk@38637 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov 2016-09-21 08:56:28 +00:00
parent 2515aab673
commit 9ee1f662cb

View File

@ -1,18 +1,42 @@
/* global postL10n, ajaxurl, wpAjax, setPostThumbnailL10n, postboxes, pagenow, tinymce, alert, deleteUserSetting */
/* global theList:true, theExtraList:true, getUserSetting, setUserSetting, commentReply */
/**
* Contains all dynamic functionality needed on post and term pages.
*
* @summary Control page and term functionality.
*/
var commentsBox, WPSetThumbnailHTML, WPSetThumbnailID, WPRemoveThumbnail, wptitlehint, makeSlugeditClickable, editPermalink;
// Back-compat: prevent fatal errors
// Backwards compatibility: prevent fatal errors.
makeSlugeditClickable = editPermalink = function(){};
// Make sure the wp object exists.
window.wp = window.wp || {};
( function( $ ) {
var titleHasFocus = false;
commentsBox = {
/**
* Control loading of comments on the post and term edit pages.
*
* @type {{st: number, get: commentsBox.get, load: commentsBox.load}}
*
* @namespace commentsBox
*/
commentsBox = {
// Comment offset to use when fetching new comments.
st : 0,
/**
* Fetch comments using AJAX and display them in the box.
*
* @param {int} total Total number of comments for this post.
* @param {int} num Optional. Number of comments to fetch, defaults to 20.
* @returns {boolean} Always returns false.
*
* @memberof commentsBox
*/
get : function(total, num) {
var st = this.st, data;
if ( ! num )
@ -31,7 +55,9 @@ commentsBox = {
'number' : num
};
$.post(ajaxurl, data,
$.post(
ajaxurl,
data,
function(r) {
r = wpAjax.parseAjaxResponse(r);
$('#commentsdiv .widefat').show();
@ -43,6 +69,7 @@ commentsBox = {
theList = theExtraList = null;
$( 'a[className*=\':\']' ).unbind();
// If the offset is over the total number of comments we cannot fetch any more, so hide the button.
if ( commentsBox.st > commentsBox.total )
$('#show-comments').hide();
else
@ -61,27 +88,61 @@ commentsBox = {
return false;
},
/**
* Load the next batch of comments.
*
* @param {int} total Total number of comments to load.
*
* @memberof commentsBox
*/
load: function(total){
this.st = jQuery('#the-comment-list tr.comment:visible').length;
this.get(total);
}
};
};
WPSetThumbnailHTML = function(html){
/**
* Overwrite the content of the Featured Image postbox
*
* @param {string} html New HTML to be displayed in the content area of the postbox.
*
* @global
*/
WPSetThumbnailHTML = function(html){
$('.inside', '#postimagediv').html(html);
};
};
WPSetThumbnailID = function(id){
/**
* Set the Image ID of the Featured Image
*
* @param {int} id The post_id of the image to use as Featured Image.
*
* @global
*/
WPSetThumbnailID = function(id){
var field = $('input[value="_thumbnail_id"]', '#list-table');
if ( field.length > 0 ) {
$('#meta\\[' + field.attr('id').match(/[0-9]+/) + '\\]\\[value\\]').text(id);
}
};
};
WPRemoveThumbnail = function(nonce){
/**
* Remove the Featured Image
*
* @param {string} nonce Nonce to use in the request.
*
* @global
*/
WPRemoveThumbnail = function(nonce){
$.post(ajaxurl, {
action: 'set-post-thumbnail', post_id: $( '#post_ID' ).val(), thumbnail_id: -1, _ajax_nonce: nonce, cookie: encodeURIComponent( document.cookie )
}, function(str){
},
/**
* Handle server response
*
* @param {string} str Response, will be '0' when an error occured otherwise contains link to add Featured Image.
*/
function(str){
if ( str == '0' ) {
alert( setPostThumbnailL10n.error );
} else {
@ -89,9 +150,17 @@ WPRemoveThumbnail = function(nonce){
}
}
);
};
};
$(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
/**
* Heartbeat locks.
*
* Used to lock editing of an object by only one user at a time.
*
* When the user does not send a heartbeat in a heartbeat-time
* the user is no longer editing and another user can start editing.
*/
$(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
var lock = $('#active_post_lock').val(),
post_id = $('#post_ID').val(),
send = {};
@ -106,20 +175,20 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
data['wp-refresh-post-lock'] = send;
}).on( 'heartbeat-tick.refresh-lock', function( e, data ) {
// Post locks: update the lock string or show the dialog if somebody has taken over editing
}).on( 'heartbeat-tick.refresh-lock', function( e, data ) {
// Post locks: update the lock string or show the dialog if somebody has taken over editing.
var received, wrap, avatar;
if ( data['wp-refresh-post-lock'] ) {
received = data['wp-refresh-post-lock'];
if ( received.lock_error ) {
// show "editing taken over" message
// Show "editing taken over" message.
wrap = $('#post-lock-dialog');
if ( wrap.length && ! wrap.is(':visible') ) {
if ( wp.autosave ) {
// Save the latest changes and disable
// Save the latest changes and disable.
$(document).one( 'heartbeat-tick', function() {
wp.autosave.server.suspend();
wrap.removeClass('saving').addClass('saved');
@ -142,11 +211,14 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
$('#active_post_lock').val( received.new_lock );
}
}
}).on( 'before-autosave.update-post-slug', function() {
}).on( 'before-autosave.update-post-slug', function() {
titleHasFocus = document.activeElement && document.activeElement.id === 'title';
}).on( 'after-autosave.update-post-slug', function() {
// Create slug area only if not already there
// and the title field was not focused (user was not typing a title) when autosave ran
}).on( 'after-autosave.update-post-slug', function() {
/*
* Create slug area only if not already there
* and the title field was not focused (user was not typing a title) when autosave ran.
*/
if ( ! $('#edit-slug-box > *').length && ! titleHasFocus ) {
$.post( ajaxurl, {
action: 'sample-permalink',
@ -161,13 +233,19 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
}
);
}
});
});
}(jQuery));
/**
* Heartbeat refresh nonces.
*/
(function($) {
var check, timeout;
/**
* Only allow to check for nonce refresh every 30 seconds.
*/
function schedule() {
check = false;
window.clearTimeout( timeout );
@ -205,6 +283,9 @@ $(document).on( 'heartbeat-send.refresh-lock', function( e, data ) {
});
}(jQuery));
/**
* All post and postbox controls and functionality.
*/
jQuery(document).ready( function($) {
var stamp, visibility, $submitButtons, updateVisibility, updateText,
sticky = '',
@ -220,32 +301,37 @@ jQuery(document).ready( function($) {
postboxes.add_postbox_toggles(pagenow);
// Clear the window name. Otherwise if this is a former preview window where the user navigated to edit another post,
// and the first post is still being edited, clicking Preview there will use this window to show the preview.
/*
* Clear the window name. Otherwise if this is a former preview window where the user navigated to edit another post,
* and the first post is still being edited, clicking Preview there will use this window to show the preview.
*/
window.name = '';
// Post locks: contain focus inside the dialog. If the dialog is shown, focus the first item.
$('#post-lock-dialog .notification-dialog').on( 'keydown', function(e) {
// Don't do anything when [tab] is pressed.
if ( e.which != 9 )
return;
var target = $(e.target);
// [shift] + [tab] on first tab cycles back to last tab.
if ( target.hasClass('wp-tab-first') && e.shiftKey ) {
$(this).find('.wp-tab-last').focus();
e.preventDefault();
// [tab] on last tab cycles back to first tab.
} else if ( target.hasClass('wp-tab-last') && ! e.shiftKey ) {
$(this).find('.wp-tab-first').focus();
e.preventDefault();
}
}).filter(':visible').find('.wp-tab-first').focus();
// Set the heartbeat interval to 15 sec. if post lock dialogs are enabled
// Set the heartbeat interval to 15 sec. if post lock dialogs are enabled.
if ( wp.heartbeat && $('#post-lock-dialog').length ) {
wp.heartbeat.interval( 15 );
}
// The form is being submitted by the user
// The form is being submitted by the user.
$submitButtons = $submitpost.find( ':submit, a.submitdelete, #post-preview' ).on( 'click.edit-post', function( event ) {
var $button = $(this);
@ -265,7 +351,7 @@ jQuery(document).ready( function($) {
return;
}
// Stop autosave
// Stop auto save.
if ( wp.autosave ) {
wp.autosave.server.suspend();
}
@ -350,7 +436,7 @@ jQuery(document).ready( function($) {
}
});
// Autosave new posts after a title is typed
// Auto save new posts after a title is typed.
if ( $( '#auto_draft' ).val() ) {
$( '#title' ).blur( function() {
var cancel;
@ -359,7 +445,7 @@ jQuery(document).ready( function($) {
return;
}
// Cancel the autosave when the blur was triggered by the user submitting the form
// Cancel the auto save when the blur was triggered by the user submitting the form.
$('form#post').one( 'submit', function() {
cancel = true;
});
@ -388,6 +474,10 @@ jQuery(document).ready( function($) {
}
});
/*
* When the user is trying to load another page, or reloads current page
* show a confirmation dialog when there are unsaved changes.
*/
$(window).on( 'beforeunload.edit-post', function() {
var editor = typeof tinymce !== 'undefined' && tinymce.get('content');
@ -401,8 +491,10 @@ jQuery(document).ready( function($) {
return;
}
// Unload is triggered (by hand) on removing the Thickbox iframe.
// Make sure we process only the main document unload.
/*
* Unload is triggered (by hand) on removing the Thickbox iframe.
* Make sure we process only the main document unload.
*/
if ( event.target && event.target.nodeName != '#document' ) {
return;
}
@ -435,7 +527,7 @@ jQuery(document).ready( function($) {
});
});
// multi-taxonomies
// Multiple Taxonomies.
if ( $('#tagsdiv-post_tag').length ) {
window.tagBox && window.tagBox.init();
} else {
@ -447,7 +539,7 @@ jQuery(document).ready( function($) {
});
}
// categories
// Handle categories.
$('.categorydiv').each( function(){
var this_id = $(this).attr('id'), catAddBefore, catAddAfter, taxonomyParts, taxonomy, settingName;
@ -455,8 +547,10 @@ jQuery(document).ready( function($) {
taxonomyParts.shift();
taxonomy = taxonomyParts.join('-');
settingName = taxonomy + '_tab';
if ( taxonomy == 'category' )
if ( taxonomy == 'category' ) {
settingName = 'cats';
}
// TODO: move to jQuery 1.3+, support for multiple hierarchical taxonomies, see wp-lists.js
$('a', '#' + taxonomy + '-tabs').click( function( e ) {
@ -465,34 +559,62 @@ jQuery(document).ready( function($) {
$(this).parent().addClass('tabs').siblings('li').removeClass('tabs');
$('#' + taxonomy + '-tabs').siblings('.tabs-panel').hide();
$(t).show();
if ( '#' + taxonomy + '-all' == t )
if ( '#' + taxonomy + '-all' == t ) {
deleteUserSetting( settingName );
else
} else {
setUserSetting( settingName, 'pop' );
}
});
if ( getUserSetting( settingName ) )
$('a[href="#' + taxonomy + '-pop"]', '#' + taxonomy + '-tabs').click();
// Ajax Cat
$( '#new' + taxonomy ).one( 'focus', function() { $( this ).val( '' ).removeClass( 'form-input-tip' ); } );
// Add category button controls.
$('#new' + taxonomy).one( 'focus', function() {
$( this ).val( '' ).removeClass( 'form-input-tip' );
});
// On [enter] submit the taxonomy.
$('#new' + taxonomy).keypress( function(event){
if( 13 === event.keyCode ) {
event.preventDefault();
$('#' + taxonomy + '-add-submit').click();
}
});
$('#' + taxonomy + '-add-submit').click( function(){ $('#new' + taxonomy).focus(); });
// After submitting a new taxonomy, re-focus the input field.
$('#' + taxonomy + '-add-submit').click( function() {
$('#new' + taxonomy).focus();
});
/**
* Before adding a new taxonomy, disable submit button.
*
* @param {Object} s Taxonomy object which will be added.
*
* @returns {Object}
*/
catAddBefore = function( s ) {
if ( !$('#new'+taxonomy).val() )
if ( !$('#new'+taxonomy).val() ) {
return false;
}
s.data += '&' + $( ':checked', '#'+taxonomy+'checklist' ).serialize();
$( '#' + taxonomy + '-add-submit' ).prop( 'disabled', true );
return s;
};
/**
* Re-enable submit button after a taxonomy has been added.
*
* Re-enable submit button.
* If the taxonomy has a parent place the taxonomy underneath the parent.
*
* @param {Object} r Response.
* @param {Object} s Taxonomy data.
*
* @returns void
*/
catAddAfter = function( r, s ) {
var sup, drop = $('#new'+taxonomy+'_parent');
@ -510,6 +632,7 @@ jQuery(document).ready( function($) {
addAfter: catAddAfter
});
// Add new taxonomy button toggles input form visibility.
$('#' + taxonomy + '-add-toggle').click( function( e ) {
e.preventDefault();
$('#' + taxonomy + '-adder').toggleClass( 'wp-hidden-children' );
@ -517,6 +640,7 @@ jQuery(document).ready( function($) {
$('#new'+taxonomy).focus();
});
// Sync checked items between "All {taxonomy}" and "Most used" lists.
$('#' + taxonomy + 'checklist, #' + taxonomy + 'checklist-pop').on( 'click', 'li.popular-category > label input[type="checkbox"]', function() {
var t = $(this), c = t.is(':checked'), id = t.val();
if ( id && t.parents('#taxonomy-'+taxonomy).length )
@ -525,29 +649,51 @@ jQuery(document).ready( function($) {
}); // end cats
// Custom Fields
// Custom Fields postbox.
if ( $('#postcustom').length ) {
$( '#the-list' ).wpList( { addAfter: function() {
$('table#list-table').show();
}, addBefore: function( s ) {
$( '#the-list' ).wpList( {
/**
* Add current post_ID to request to fetch custom fields
*
* @param {Object} s Request object.
*
* @returns {Object} Data modified with post_ID attached.
*/
addBefore: function( s ) {
s.data += '&post_id=' + $('#post_ID').val();
return s;
},
/**
* Show the listing of custom fields after fetching.
*/
addAfter: function() {
$('table#list-table').show();
}
});
}
// submitdiv
/*
* Publish Post box (#submitdiv)
*/
if ( $('#submitdiv').length ) {
stamp = $('#timestamp').html();
visibility = $('#post-visibility-display').html();
/**
* When the visibility of a post changes sub-options should be shown or hidden.
*
* @returns void
*/
updateVisibility = function() {
// Show sticky for public posts.
if ( $postVisibilitySelect.find('input:radio:checked').val() != 'public' ) {
$('#sticky').prop('checked', false);
$('#sticky-span').hide();
} else {
$('#sticky-span').show();
}
// Show password input field for password protected post.
if ( $postVisibilitySelect.find('input:radio:checked').val() != 'password' ) {
$('#password-span').hide();
} else {
@ -555,6 +701,11 @@ jQuery(document).ready( function($) {
}
};
/**
* Make sure all labels represent the current settings.
*
* @returns {boolean} False when an invalid timestamp has been selected, otherwise True.
*/
updateText = function() {
if ( ! $timestampdiv.length )
@ -568,6 +719,7 @@ jQuery(document).ready( function($) {
originalDate = new Date( $('#hidden_aa').val(), $('#hidden_mm').val() -1, $('#hidden_jj').val(), $('#hidden_hh').val(), $('#hidden_mn').val() );
currentDate = new Date( $('#cur_aa').val(), $('#cur_mm').val() -1, $('#cur_jj').val(), $('#cur_hh').val(), $('#cur_mn').val() );
// Catch unexpected date problems.
if ( attemptedDate.getFullYear() != aa || (1 + attemptedDate.getMonth()) != mm || attemptedDate.getDate() != jj || attemptedDate.getMinutes() != mn ) {
$timestampdiv.find('.timestamp-wrap').addClass('form-invalid');
return false;
@ -575,6 +727,7 @@ jQuery(document).ready( function($) {
$timestampdiv.find('.timestamp-wrap').removeClass('form-invalid');
}
// Determine what the publish should be depending on the date and post status.
if ( attemptedDate > currentDate && $('#original_post_status').val() != 'future' ) {
publishOn = postL10n.publishOnFuture;
$('#publish').val( postL10n.schedule );
@ -585,7 +738,10 @@ jQuery(document).ready( function($) {
publishOn = postL10n.publishOnPast;
$('#publish').val( postL10n.update );
}
if ( originalDate.toUTCString() == attemptedDate.toUTCString() ) { //hack
// If the date is the same, set it to trigger update events.
if ( originalDate.toUTCString() == attemptedDate.toUTCString() ) {
// Re-set to the current value.
$('#timestamp').html(stamp);
} else {
$('#timestamp').html(
@ -600,6 +756,7 @@ jQuery(document).ready( function($) {
);
}
// Add "privately published" to post status when applies.
if ( $postVisibilitySelect.find('input:radio:checked').val() == 'private' ) {
$('#publish').val( postL10n.update );
if ( 0 === optPublish.length ) {
@ -621,7 +778,11 @@ jQuery(document).ready( function($) {
if ( postStatus.is(':hidden') )
$('#misc-publishing-actions .edit-post-status').show();
}
// Update "Status:" to currently selected status.
$('#post-status-display').html($('option:selected', postStatus).text());
// Show or hide the "Save Draft" button.
if ( $('option:selected', postStatus).val() == 'private' || $('option:selected', postStatus).val() == 'publish' ) {
$('#save-post').hide();
} else {
@ -635,6 +796,7 @@ jQuery(document).ready( function($) {
return true;
};
// Show the visibility options and hide the toggle button when opened.
$( '#visibility .edit-visibility').click( function( e ) {
e.preventDefault();
if ( $postVisibilitySelect.is(':hidden') ) {
@ -646,6 +808,7 @@ jQuery(document).ready( function($) {
}
});
// Cancel visibility selection area and hide it from view.
$postVisibilitySelect.find('.cancel-post-visibility').click( function( event ) {
$postVisibilitySelect.slideUp('fast');
$('#visibility-radio-' + $('#hidden-post-visibility').val()).prop('checked', true);
@ -657,6 +820,7 @@ jQuery(document).ready( function($) {
event.preventDefault();
});
// Set the selected visibility as current.
$postVisibilitySelect.find('.save-post-visibility').click( function( event ) { // crazyhorse - multiple ok cancels
$postVisibilitySelect.slideUp('fast');
$('#visibility .edit-visibility').show().focus();
@ -664,7 +828,7 @@ jQuery(document).ready( function($) {
if ( $postVisibilitySelect.find('input:radio:checked').val() != 'public' ) {
$('#sticky').prop('checked', false);
} // WEAPON LOCKED
}
if ( $('#sticky').prop('checked') ) {
sticky = 'Sticky';
@ -676,10 +840,12 @@ jQuery(document).ready( function($) {
event.preventDefault();
});
// When the selection changes, update labels.
$postVisibilitySelect.find('input:radio').change( function() {
updateVisibility();
});
// Edit publish time click.
$timestampdiv.siblings('a.edit-timestamp').click( function( event ) {
if ( $timestampdiv.is( ':hidden' ) ) {
$timestampdiv.slideDown( 'fast', function() {
@ -690,6 +856,7 @@ jQuery(document).ready( function($) {
event.preventDefault();
});
// Cancel editing the publish time and hide the settings.
$timestampdiv.find('.cancel-timestamp').click( function( event ) {
$timestampdiv.slideUp('fast').siblings('a.edit-timestamp').show().focus();
$('#mm').val($('#hidden_mm').val());
@ -701,6 +868,7 @@ jQuery(document).ready( function($) {
event.preventDefault();
});
// Save the changed timestamp.
$timestampdiv.find('.save-timestamp').click( function( event ) { // crazyhorse - multiple ok cancels
if ( updateText() ) {
$timestampdiv.slideUp('fast');
@ -709,6 +877,7 @@ jQuery(document).ready( function($) {
event.preventDefault();
});
// Cancel submit when an invalid timestamp has been selected.
$('#post').on( 'submit', function( event ) {
if ( ! updateText() ) {
event.preventDefault();
@ -722,6 +891,7 @@ jQuery(document).ready( function($) {
}
});
// Post Status edit click.
$postStatusSelect.siblings('a.edit-post-status').click( function( event ) {
if ( $postStatusSelect.is( ':hidden' ) ) {
$postStatusSelect.slideDown( 'fast', function() {
@ -732,21 +902,31 @@ jQuery(document).ready( function($) {
event.preventDefault();
});
// Save the Post Status changes and hide the options.
$postStatusSelect.find('.save-post-status').click( function( event ) {
$postStatusSelect.slideUp( 'fast' ).siblings( 'a.edit-post-status' ).show().focus();
updateText();
event.preventDefault();
});
// Cancel Post Status editing and hide the options.
$postStatusSelect.find('.cancel-post-status').click( function( event ) {
$postStatusSelect.slideUp( 'fast' ).siblings( 'a.edit-post-status' ).show().focus();
$('#post_status').val( $('#hidden_post_status').val() );
updateText();
event.preventDefault();
});
} // end submitdiv
}
// permalink
/**
* Handle the editing of the post_name. Create the required HTML elements and update the changes via AJAX.
*
* @summary Permalink aka slug aka post_name editing
*
* @global
*
* @returns void
*/
function editPermalink() {
var i, slug_value,
$el, revert_e,
@ -760,15 +940,19 @@ jQuery(document).ready( function($) {
buttonsOrig = buttons.html(),
full = $('#editable-post-name-full');
// Deal with Twemoji in the post-name
// Deal with Twemoji in the post-name.
full.find( 'img' ).replaceWith( function() { return this.alt; } );
full = full.html();
permalink.html( permalinkInner );
// Save current content to revert to when cancelling.
$el = $( '#editable-post-name' );
revert_e = $el.html();
buttons.html( '<button type="button" class="save button button-small">' + postL10n.ok + '</button> <button type="button" class="cancel button-link">' + postL10n.cancel + '</button>' );
// Save permalink changes.
buttons.children( '.save' ).click( function() {
var new_slug = $el.children( 'input' ).val();
@ -776,13 +960,17 @@ jQuery(document).ready( function($) {
buttons.children('.cancel').click();
return;
}
$.post(ajaxurl, {
$.post(
ajaxurl,
{
action: 'sample-permalink',
post_id: postId,
new_slug: new_slug,
new_title: $('#title').val(),
samplepermalinknonce: $('#samplepermalinknonce').val()
}, function(data) {
},
function(data) {
var box = $('#edit-slug-box');
box.html(data);
if (box.hasClass('hidden')) {
@ -796,9 +984,11 @@ jQuery(document).ready( function($) {
real_slug.val(new_slug);
$( '.edit-slug' ).focus();
wp.a11y.speak( postL10n.permalinkSaved );
});
}
);
});
// Cancel editing of permalink.
buttons.children( '.cancel' ).click( function() {
$('#view-post-btn').show();
$el.html(revert_e);
@ -808,19 +998,21 @@ jQuery(document).ready( function($) {
$( '.edit-slug' ).focus();
});
// If more than 1/4th of 'full' is '%', make it empty.
for ( i = 0; i < full.length; ++i ) {
if ( '%' == full.charAt(i) )
c++;
}
slug_value = ( c > full.length / 4 ) ? '' : full;
$el.html( '<input type="text" id="new-post-slug" value="' + slug_value + '" autocomplete="off" />' ).children( 'input' ).keydown( function( e ) {
var key = e.which;
// On enter, just save the new slug, don't save the post.
// On [enter], just save the new slug, don't save the post.
if ( 13 === key ) {
e.preventDefault();
buttons.children( '.save' ).click();
}
// On [esc] cancel the editing.
if ( 27 === key ) {
buttons.children( '.cancel' ).click();
}
@ -833,6 +1025,17 @@ jQuery(document).ready( function($) {
editPermalink();
});
/**
* Add screen reader text to the title prompt when needed.
*
* @summary Title screen reader text handler.
*
* @param {string} id Optional. HTML ID to add the screen reader helper text to.
*
* @global
*
* @returns void
*/
wptitlehint = function(id) {
id = id || 'title';
@ -859,19 +1062,24 @@ jQuery(document).ready( function($) {
wptitlehint();
// Resize the visual and text editors
// Resize the WYSIWYG and plain text editors.
( function() {
var editor, offset, mce,
$handle = $('#post-status-info'),
$postdivrich = $('#postdivrich');
// No point for touch devices
// If there are no textareas or we are on a touch device, we can't do anything.
if ( ! $textarea.length || 'ontouchstart' in window ) {
// Hide the resize handle
// Hide the resize handle.
$('#content-resize-handle').hide();
return;
}
/**
* Handle drag event.
*
* @param {Object} event Event containing details about the drag.
*/
function dragging( event ) {
if ( $postdivrich.hasClass( 'wp-editor-expand' ) ) {
return;
@ -886,6 +1094,9 @@ jQuery(document).ready( function($) {
event.preventDefault();
}
/**
* When the dragging stopped make sure we return focus and do a sanity check on the height.
*/
function endDrag() {
var height, toolbarHeight;
@ -909,7 +1120,7 @@ jQuery(document).ready( function($) {
$document.off( '.wp-editor-resize' );
// sanity check
// Sanity check: normalize height to stay within acceptable ranges.
if ( height && height > 50 && height < 5000 ) {
setUserSetting( 'ed_size', height );
}
@ -936,8 +1147,9 @@ jQuery(document).ready( function($) {
}).on( 'mouseup.wp-editor-resize', endDrag );
})();
// TinyMCE specific handling of Post Format changes to reflect in the editor.
if ( typeof tinymce !== 'undefined' ) {
// When changing post formats, change the editor body class
// When changing post formats, change the editor body class.
$( '#post-formats-select input.post-format' ).on( 'change.set-editor-class', function() {
var editor, body, format = this.id;
@ -950,8 +1162,9 @@ jQuery(document).ready( function($) {
});
}
// Save on pressing Ctrl/Command + S in the Text editor
// Save on pressing [ctrl]/[command] + [s] in the Text editor.
$textarea.on( 'keydown.wp-autosave', function( event ) {
// Key [s] has code 83.
if ( event.which === 83 ) {
if ( event.shiftKey || event.altKey || ( isMac && ( ! event.metaKey || event.ctrlKey ) ) || ( ! isMac && ! event.ctrlKey ) ) {
return;
@ -962,6 +1175,7 @@ jQuery(document).ready( function($) {
}
});
// If the last status was auto-draft and the save is triggered, edit the current URL.
if ( $( '#original_post_status' ).val() === 'auto-draft' && window.history.replaceState ) {
var location;
@ -975,6 +1189,9 @@ jQuery(document).ready( function($) {
}
});
/**
* TinyMCE word count display
*/
( function( $, counter ) {
$( function() {
var $content = $( '#content' ),
@ -982,6 +1199,9 @@ jQuery(document).ready( function($) {
prevCount = 0,
contentEditor;
/**
* Get the word count from TinyMCE and display it
*/
function update() {
var text, count;
@ -1000,6 +1220,12 @@ jQuery(document).ready( function($) {
prevCount = count;
}
/**
* Bind the word count update triggers.
*
* When a node change in the main TinyMCE editor has been triggered.
* When a key has been released in the plain text content editor.
*/
$( document ).on( 'tinymce-editor-init', function( event, editor ) {
if ( editor.id !== 'content' ) {
return;