enmi-conf.org: comparison wp/wp-admin/js/inline-edit-post.js

Mercurial Mercurial > enmi-conf.org / comparison

summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help

wp/wp-admin/js/inline-edit-post.js

changeset 9	177826044cd9
parent 7	cf61fcea0001
child 16	a86126ab1dd4

equal deleted inserted replaced

-:c7c34916027a
+:177826044cd9
-/* global inlineEditL10n, ajaxurl, typenow */
 /**
 * This file contains the functions needed for the inline editing of posts.
 *
 * @since 2.7.0
+* @output wp-admin/js/inline-edit-post.js
 */
+/* global inlineEditL10n, ajaxurl, typenow, inlineEditPost */
 window.wp = window.wp || {};
 /**
 * Manages the quick edit and bulk edit windows for editing posts or pages.
 *
-* @namespace
+* @namespace inlineEditPost
 *
 * @since 2.7.0
-* @access public
 *
 * @type {Object}
 *
 * @property {string} type The type of inline editor.
 * @property {string} what The prefix before the post id.
 *
 */
-var inlineEditPost;
 ( function( $, wp ) {
-	inlineEditPost = {
+	window.inlineEditPost = {
 	/**
-	 * @summary Initializes the inline and bulk post editor.
+	 * Initializes the inline and bulk post editor.
 	 *
 	 * Binds event handlers to the escape key to close the inline editor
 	 * and to the save and close buttons. Changes DOM to be ready for inline
 	 * editing. Adds event handler to bulk edit.
 	 *
 		t.type = $('table.widefat').hasClass('pages') ? 'page' : 'post';
 		// Post id prefix.
 		t.what = '#post-';
 		/**
-		 * @summary Bind escape key to revert the changes and close the quick editor.
+		 * Binds the escape key to revert the changes and close the quick editor.
 		 *
 		 * @returns {boolean} The result of revert.
 		 */
 		qeRow.keyup(function(e){
 			// Revert changes if escape key is pressed.
 				return inlineEditPost.revert();
 			}
 		});
 		/**
-		 * @summary Bind escape key to revert the changes and close the bulk editor.
+		 * Binds the escape key to revert the changes and close the bulk editor.
 		 *
 		 * @returns {boolean} The result of revert.
 		 */
 		bulkRow.keyup(function(e){
 			// Revert changes if escape key is pressed.
 				return inlineEditPost.revert();
 			}
 		});
 		/**
-		 * @summary Revert changes and close the quick editor if the cancel button is clicked.
+		 * Reverts changes and close the quick editor if the cancel button is clicked.
 		 *
 		 * @returns {boolean} The result of revert.
 		 */
 		$( '.cancel', qeRow ).click( function() {
 			return inlineEditPost.revert();
 		});
 		/**
-		 * @summary Save changes in the quick editor if the save(named: update) button is clicked.
+		 * Saves changes in the quick editor if the save(named: update) button is clicked.
 		 *
 		 * @returns {boolean} The result of save.
 		 */
 		$( '.save', qeRow ).click( function() {
 			return inlineEditPost.save(this);
 		});
 		/**
-		 * @summary If enter is pressed, and the target is not the cancel button, save the post.
+		 * If enter is pressed, and the target is not the cancel button, save the post.
 		 *
 		 * @returns {boolean} The result of save.
 		 */
 		$('td', qeRow).keydown(function(e){
 			if ( e.which === 13 && ! $( e.target ).hasClass( 'cancel' ) ) {
 				return inlineEditPost.save(this);
 			}
 		});
 		/**
-		 * @summary Revert changes and close the bulk editor if the cancel button is clicked.
+		 * Reverts changes and close the bulk editor if the cancel button is clicked.
 		 *
 		 * @returns {boolean} The result of revert.
 		 */
 		$( '.cancel', bulkRow ).click( function() {
 			return inlineEditPost.revert();
 		});
 		/**
-		 * @summary Disables the password input field when the private post checkbox is checked.
+		 * Disables the password input field when the private post checkbox is checked.
 		 */
 		$('#inline-edit .inline-edit-private input[value="private"]').click( function(){
 			var pw = $('input.inline-edit-password-input');
 			if ( $(this).prop('checked') ) {
 				pw.val('').prop('disabled', true);
 				pw.prop('disabled', false);
 			}
 		});
 		/**
-		 * @summary Bind click event to the .editinline link which opens the quick editor.
+		 * Binds click event to the .editinline button which opens the quick editor.
 		 */
-		$('#the-list').on( 'click', 'a.editinline', function( e ) {
+		$( '#the-list' ).on( 'click', '.editinline', function() {
-			e.preventDefault();
+			$( this ).attr( 'aria-expanded', 'true' );
-			inlineEditPost.edit(this);
+			inlineEditPost.edit( this );
 		});
 		$('#bulk-edit').find('fieldset:first').after(
 			$('#inline-edit fieldset.inline-edit-categories').clone()
 		).siblings( 'fieldset:last' ).prepend(
 		);
 		$('select[name="_status"] option[value="future"]', bulkRow).remove();
 		/**
-		 * @summary Adds onclick events to the apply buttons.
+		 * Adds onclick events to the apply buttons.
 		 */
 		$('#doaction, #doaction2').click(function(e){
 			var n;
 			t.whichBulkButtonId = $( this ).attr( 'id' );
 			}
 		});
 	},
 	/**
-	 * @summary Toggles the quick edit window.
+	 * Toggles the quick edit window, hiding it when it's active and showing it when
-	 *
+	 * inactive.
-	 * Hides the window when it's active and shows the window when inactive.
 	 *
 	 * @memberof inlineEditPost
 	 * @since 2.7.0
 	 *
 	 * @param {Object} el Element within a post table row.
 		var t = this;
 		$( t.what + t.getId( el ) ).css( 'display' ) === 'none' ? t.revert() : t.edit( el );
 	},
 	/**
-	 * @summary Creates the bulk editor row to edit multiple posts at once.
+	 * Creates the bulk editor row to edit multiple posts at once.
 	 *
 	 * @memberof inlineEditPost
 	 * @since 2.7.0
 	 */
 	setBulk : function(){
 		// Insert the editor at the top of the table with an empty row above to maintain zebra striping.
 		$('table.widefat tbody').prepend( $('#bulk-edit') ).prepend('<tr class="hidden"></tr>');
 		$('#bulk-edit').addClass('inline-editor').show();
 		/**
-		 * @summary Create a HTML div with the title and a delete link(cross-icon) for each selected post.
+		 * Create a HTML div with the title and a link(delete-icon) for each selected
+		 * post.
 		 *
 		 * Get the selected posts based on the checked checkboxes in the post table.
-		 * Create a HTML div with the title and a link(delete-icon) for each selected post.
 		 */
 		$( 'tbody th.check-column input[type="checkbox"]' ).each( function() {
 			// If the checkbox for a post is selected, add the post to the edit list.
 			if ( $(this).prop('checked') ) {
 		}
 		// Add onclick events to the delete-icons in the bulk editors the post title list.
 		$('#bulk-titles').html(te);
 		/**
-		 * @summary Binds on click events to the checkboxes before the posts in the table.
+		 * Binds on click events to the checkboxes before the posts in the table.
 		 *
 		 * @listens click
 		 */
 		$('#bulk-titles a').click(function(){
 			var id = $(this).attr('id').substr(1);
 		// Scrolls to the top of the table where the editor is rendered.
 		$('html, body').animate( { scrollTop: 0 }, 'fast' );
 	},
 	/**
-	 * @summary Creates a quick edit window for the post that has been clicked.
+	 * Creates a quick edit window for the post that has been clicked.
 	 *
 	 * @memberof inlineEditPost
 	 * @since 2.7.0
 	 *
 	 * @param {number|Object} id The id of the clicked post or an element within a post
 		for ( f = 0; f < fields.length; f++ ) {
 			val = $('.'+fields[f], rowData);
 			/**
-			 * @summary Replaces the image for a Twemoji(Twitter emoji) with it's alternate text.
+			 * Replaces the image for a Twemoji(Twitter emoji) with it's alternate text.
 			 *
 			 * @returns Alternate text from the image.
 			 */
 			val.find( 'img' ).replaceWith( function() { return this.alt; } );
 			val = val.text();
 		if ( $( '.sticky', rowData ).text() === 'sticky' ) {
 			$( 'input[name="sticky"]', editRow ).prop( 'checked', true );
 		}
 		/**
-		 * @summary Creates the select boxes for the categories.
+		 * Creates the select boxes for the categories.
 		 */
 		$('.post_category', rowData).each(function(){
 			var taxname,
 				term_ids = $(this).text();
 				$('ul.'+taxname+'-checklist :checkbox', editRow).val(term_ids.split(','));
 			}
 		});
 		/**
-		 * @summary Gets all the taxonomies for live auto-fill suggestions.
+		 * Gets all the taxonomies for live auto-fill suggestions when typing the name
-		 * When typing the name of a tag.
+		 * of a tag.
 		 */
 		$('.tags_input', rowData).each(function(){
 			var terms = $(this),
 				taxname = $(this).attr('id').replace('_' + id, ''),
 				textarea = $('textarea.tax_input_' + taxname, editRow),
 		return false;
 	},
 	/**
-	 * @summary Saves the changes made in the quick edit window to the post.
+	 * Saves the changes made in the quick edit window to the post.
 	 * AJAX saving is only for Quick Edit and not for bulk edit.
 	 *
 	 * @since 2.7.0
 	 *
 	 * @param   {int}     id The id for the post that has been changed.
 				if (r) {
 					if ( -1 !== r.indexOf( '<tr' ) ) {
 						$(inlineEditPost.what+id).siblings('tr.hidden').addBack().remove();
 						$('#edit-'+id).before(r).remove();
 						$( inlineEditPost.what + id ).hide().fadeIn( 400, function() {
-							// Move focus back to the Quick Edit link. $( this ) is the row being animated.
+							// Move focus back to the Quick Edit button. $( this ) is the row being animated.
-							$( this ).find( '.editinline' ).focus();
+							$( this ).find( '.editinline' )
+								.attr( 'aria-expanded', 'false' )
+								.focus();
 							wp.a11y.speak( inlineEditL10n.saved );
 						});
 					} else {
 						r = r.replace( /<.[^<>]*?>/g, '' );
 						$errorNotice.removeClass( 'hidden' );
 		// Prevent submitting the form when pressing Enter on a focused field.
 		return false;
 	},
 	/**
-	 * @summary Hides and empties the Quick Edit and/or Bulk Edit windows.
+	 * Hides and empties the Quick Edit and/or Bulk Edit windows.
 	 *
 	 * @memberof    inlineEditPost
 	 * @since 2.7.0
 	 *
 	 * @returns {boolean} Always returns false.
 				// Remove both the inline-editor and its hidden tr siblings.
 				$('#'+id).siblings('tr.hidden').addBack().remove();
 				id = id.substr( id.lastIndexOf('-') + 1 );
-				// Show the post row and move focus back to the Quick Edit link.
+				// Show the post row and move focus back to the Quick Edit button.
-				$( this.what + id ).show().find( '.editinline' ).focus();
+				$( this.what + id ).show().find( '.editinline' )
+					.attr( 'aria-expanded', 'false' )
+					.focus();
 			}
 		}
 		return false;
 	},
 	/**
-	 * @summary Gets the id for a the post that you want to quick edit from the row
+	 * Gets the id for a the post that you want to quick edit from the row in the quick
-	 * in the quick edit table.
+	 * edit table.
 	 *
 	 * @memberof    inlineEditPost
 	 * @since 2.7.0
 	 *
 	 * @param   {Object} o DOM row object to get the id for.

enmi-conf.org