X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/784f914b1e4b1c62d6657e86397c2e83bcee4295..ef91a7f4f3c6468973e192335a27ec0e0faca0b5:/wp-admin/js/inline-edit-tax.js diff --git a/wp-admin/js/inline-edit-tax.js b/wp-admin/js/inline-edit-tax.js index 17095afe..daad73fd 100644 --- a/wp-admin/js/inline-edit-tax.js +++ b/wp-admin/js/inline-edit-tax.js @@ -1,10 +1,36 @@ /* global inlineEditL10n, ajaxurl */ +/** + * This file is used on the term overview page to power quick-editing terms. + */ + window.wp = window.wp || {}; +/** + * Consists of functions relevant to the inline taxonomy editor. + * + * @namespace inlineEditTax + * + * @property {string} type The type of inline edit we are currently on. + * @property {string} what The type property with a hash prefixed and a dash + * suffixed. + */ var inlineEditTax; + ( function( $, wp ) { + inlineEditTax = { + /** + * @summary Initializes the inline taxonomy editor. + * + * Adds event handlers to be able to quick edit. + * + * @since 2.7.0 + * + * @this inlineEditTax + * @memberof inlineEditTax + * @returns {void} + */ init : function() { var t = this, row = $('#inline-edit'); @@ -16,46 +42,93 @@ inlineEditTax = { return false; }); - // prepare the edit row + /* + * @summary Cancels inline editing when pressing escape inside the inline editor. + * + * @param {Object} e The keyup event that has been triggered. + */ row.keyup( function( e ) { + // 27 = [escape] if ( e.which === 27 ) { return inlineEditTax.revert(); } }); + /** + * @summary Cancels inline editing when clicking the cancel button. + */ $( '.cancel', row ).click( function() { return inlineEditTax.revert(); }); + + /** + * @summary Saves the inline edits when clicking the save button. + */ $( '.save', row ).click( function() { return inlineEditTax.save(this); }); + + /** + * @summary Saves the inline edits when pressing enter inside the inline editor. + */ $( 'input, select', row ).keydown( function( e ) { + // 13 = [enter] if ( e.which === 13 ) { return inlineEditTax.save( this ); } }); + /** + * @summary Saves the inline edits on submitting the inline edit form. + */ $( '#posts-filter input[type="submit"]' ).mousedown( function() { t.revert(); }); }, + /** + * Toggles the quick edit based on if it is currently shown or hidden. + * + * @since 2.7.0 + * + * @this inlineEditTax + * @memberof inlineEditTax + * + * @param {HTMLElement} el An element within the table row or the table row + * itself that we want to quick edit. + * @returns {void} + */ toggle : function(el) { var t = this; + $(t.what+t.getId(el)).css('display') === 'none' ? t.revert() : t.edit(el); }, + /** + * Shows the quick editor + * + * @since 2.7.0 + * + * @this inlineEditTax + * @memberof inlineEditTax + * + * @param {string|HTMLElement} id The ID of the term we want to quick edit or an + * element within the table row or the + * table row itself. + * @returns {boolean} Always returns false. + */ edit : function(id) { var editRow, rowData, val, t = this; t.revert(); + // Makes sure we can pass an HTMLElement as the ID. if ( typeof(id) === 'object' ) { id = t.getId(id); } editRow = $('#inline-edit').clone(true), rowData = $('#inline_'+id); - $( 'td', editRow ).attr( 'colspan', $( 'th:visible, td:visible', '.widefat:first thead' ).length ); + $( 'td', editRow ).attr( 'colspan', $( 'th:visible, td:visible', '.wp-list-table.widefat:first thead' ).length ); $(t.what+id).hide().after(editRow).after('