CoreFiles by mySites.guru
postbox.js695 lines, 19,722 bytes, from wordpress-5.6-beta1.zip
Raw History Compare with 5.5-beta4
md5
3caf469fb22ef3dc5f77e3fb41d5c647
sha1
93dcdf1ee91b46c690a4dd29db6ae088371482dd
sha256
ba598e1882e4b8067bf4c9c53895680d2f82f9d2bbe91d30fadcfcdfa21adcde
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695
/**
 * Contains the postboxes logic, opening and closing postboxes, reordering and saving
 * the state and ordering to the database.
 *
 * @since 2.5.0
 * @requires jQuery
 * @output wp-admin/js/postbox.js
 */

/* global ajaxurl, postboxes */

( function( $ ) {
	var $document = $( document ),
		$body = $( 'body' ),
		__ = wp.i18n.__;

	/**
	 * This object contains all function to handle the behaviour of the post boxes. The post boxes are the boxes you see
	 * around the content on the edit page.
	 *
	 * @since 2.7.0
	 *
	 * @namespace postboxes
	 *
	 * @type {Object}
	 */
	window.postboxes = {

		/**
		 * Handles a click on either the postbox heading or the postbox open/close icon.
		 *
		 * Opens or closes the postbox. Expects `this` to equal the clicked element.
		 * Calls postboxes.pbshow if the postbox has been opened, calls postboxes.pbhide
		 * if the postbox has been closed.
		 *
		 * @since 4.4.0
		 *
		 * @memberof postboxes
		 *
		 * @fires postboxes#postbox-toggled
		 *
		 * @return {void}
		 */
		handle_click : function () {
			var $el = $( this ),
				p = $el.closest( '.postbox' ),
				id = p.attr( 'id' ),
				ariaExpandedValue;

			if ( 'dashboard_browser_nag' === id ) {
				return;
			}

			p.toggleClass( 'closed' );
			ariaExpandedValue = ! p.hasClass( 'closed' );

			if ( $el.hasClass( 'handlediv' ) ) {
				// The handle button was clicked.
				$el.attr( 'aria-expanded', ariaExpandedValue );
			} else {
				// The handle heading was clicked.
				$el.closest( '.postbox' ).find( 'button.handlediv' )
					.attr( 'aria-expanded', ariaExpandedValue );
			}

			if ( postboxes.page !== 'press-this' ) {
				postboxes.save_state();
			}

			if ( id ) {
				if ( !p.hasClass('closed') && $.isFunction( postboxes.pbshow ) ) {
					postboxes.pbshow( id );
				} else if ( p.hasClass('closed') && $.isFunction( postboxes.pbhide ) ) {
					postboxes.pbhide( id );
				}
			}

			/**
			 * Fires when a postbox has been opened or closed.
			 *
			 * Contains a jQuery object with the relevant postbox element.
			 *
			 * @since 4.0.0
			 * @ignore
			 *
			 * @event postboxes#postbox-toggled
			 * @type {Object}
			 */
			$document.trigger( 'postbox-toggled', p );
		},

		/**
		 * Handles clicks on the move up/down buttons.
		 *
		 * @since 5.5.0
		 *
		 * @return {void}
		 */
		handleOrder: function() {
			var button = $( this ),
				postbox = button.closest( '.postbox' ),
				postboxId = postbox.attr( 'id' ),
				postboxesWithinSortables = postbox.closest( '.meta-box-sortables' ).find( '.postbox:visible' ),
				postboxesWithinSortablesCount = postboxesWithinSortables.length,
				postboxWithinSortablesIndex = postboxesWithinSortables.index( postbox ),
				firstOrLastPositionMessage;

			if ( 'dashboard_browser_nag' === postboxId ) {
				return;
			}

			// If on the first or last position, do nothing and send an audible message to screen reader users.
			if ( 'true' === button.attr( 'aria-disabled' ) ) {
				firstOrLastPositionMessage = button.hasClass( 'handle-order-higher' ) ?
					__( 'The box is on the first position' ) :
					__( 'The box is on the last position' );

				wp.a11y.speak( firstOrLastPositionMessage );
				return;
			}

			if ( button.hasClass( 'handle-order-higher' ) ) {
				// Move a postbox up.
				// If the box is first within a sortable area, move it to the previous sortable area.
				if ( 0 === postboxWithinSortablesIndex ) {
					postboxes.handleOrderBetweenSortables( 'previous', button, postbox );
					return;
				}

				postbox.prevAll( '.postbox:visible' ).eq( 0 ).before( postbox );
				button.focus();
				postboxes.updateOrderButtonsProperties();
				postboxes.save_order();
			} else if ( button.hasClass( 'handle-order-lower' ) ) {
				// Move a postbox down.
				// If the box is last within a sortable area, move it to the next sortable area.
				if ( postboxWithinSortablesIndex + 1 === postboxesWithinSortablesCount ) {
					postboxes.handleOrderBetweenSortables( 'next', button, postbox );
					return;
				}

				postbox.nextAll( '.postbox:visible' ).eq( 0 ).after( postbox );
				button.focus();
				postboxes.updateOrderButtonsProperties();
				postboxes.save_order();
			}
		},

		/**
		 * Moves postboxes between the sortables areas.
		 *
		 * @since 5.5.0
		 *
		 * @param {string} position The "previous" or "next" sortables area.
		 * @param {Object} button   The jQuery object representing the button that was clicked.
		 * @param {Object} postbox  The jQuery object representing the postbox to be moved.
		 *
		 * @return {void}
		 */
		handleOrderBetweenSortables: function( position, button, postbox ) {
			var closestSortablesId = button.closest( '.meta-box-sortables' ).attr( 'id' ),
				sortablesIds = [],
				sortablesIndex,
				detachedPostbox;

			// Get the list of sortables within the page.
			$( '.meta-box-sortables:visible' ).each( function() {
				sortablesIds.push( $( this ).attr( 'id' ) );
			});

			// Return if there's only one visible sortables area, e.g. in the block editor page.
			if ( 1 === sortablesIds.length ) {
				return;
			}

			// Find the index of the current sortables area within all the sortable areas.
			sortablesIndex = $.inArray( closestSortablesId, sortablesIds );
			// Detach the postbox to be moved.
			detachedPostbox = postbox.detach();

			// Move the detached postbox to its new position.
			if ( 'previous' === position ) {
				$( detachedPostbox ).appendTo( '#' + sortablesIds[ sortablesIndex - 1 ] );
			}

			if ( 'next' === position ) {
				$( detachedPostbox ).prependTo( '#' + sortablesIds[ sortablesIndex + 1 ] );
			}

			postboxes._mark_area();
			button.focus();
			postboxes.save_order();
		},

		showArrangeArrows: function() {
			$( '.postbox-arrange-arrow' )
				.attr( 'aria-disabled', 'false' )
				.removeClass( 'hidden' );

			postboxes._mark_area();
		},

		hideArrangeArrows: function() {
			$( '.postbox-arrange-arrow' )
				.attr( 'aria-disabled', 'true' )
				.addClass( 'hidden' );

			postboxes._mark_area();
		},

		/**
		 * Update the move buttons properties depending on the postbox position.
		 *
		 * @since 5.5.0
		 *
		 * @return {void}
		 */
		updateOrderButtonsProperties: function() {
			var elements  = $( '.postbox:visible' ),
				containers = $( '.meta-box-sortables:visible' )
					.not( '.unused-container' )
					.filter( function( i, container ) {
						if ( i > 0 && container.clientHeight === 0 ) {
							return false;
						}

						return true;
					} );

			// When there's only one "sortables" area (e.g. in the block editor)
			// and only one visible postbox, hide the buttons.
			if ( containers.length === 1 && elements.length === 1 ) {
				$( '.postbox-arrange-arrow' ).addClass( 'hidden' ).attr( 'aria-disabled', 'true' );
				return;
			}

			// Reset.
			if ( $body.hasClass( 'screen-options-open' ) ) {
				$( '.postbox-arrange-arrow' ).removeClass( 'hidden' ).attr( 'aria-disabled', 'false' );
			}

			if ( elements.first().parent()[0] === containers.first()[0] ) {
				// Set an aria-disabled=true attribute on the first visible "move higher" buttons.
				elements.first().find( '.handle-order-higher' ).attr( 'aria-disabled', 'true' );
			}

			if ( elements.last().parent()[0] === containers.last()[0] ) {
				// Set an aria-disabled=true attribute on the last visible "move lower" buttons.
				elements.last().find( '.handle-order-lower' ).attr( 'aria-disabled', 'true' );
			}
		},

		/**
		 * Adds event handlers to all postboxes and screen option on the current page.
		 *
		 * @since 2.7.0
		 *
		 * @memberof postboxes
		 *
		 * @param {string} page The page we are currently on.
		 * @param {Object} [args]
		 * @param {Function} args.pbshow A callback that is called when a postbox opens.
		 * @param {Function} args.pbhide A callback that is called when a postbox closes.
		 * @return {void}
		 */
		add_postbox_toggles: function ( page, args ) {
			var $handles = $( '.postbox .hndle, .postbox .handlediv' ),
				$orderButtons = $( '.postbox .postbox-arrange-arrow' );

			this.page = page;
			this.init( page, args );

			$handles.on( 'click.postboxes', this.handle_click );

			// Handle the order of the postboxes.
			$orderButtons.on( 'click.postboxes', this.handleOrder );

			/**
			 * @since 2.7.0
			 */
			$( '.postbox .hndle a' ).on( 'click', function( event ) {
				event.stopPropagation();
			});

			/**
			 * Hides a postbox.
			 *
			 * Event handler for the postbox dismiss button. After clicking the button
			 * the postbox will be hidden.
			 *
			 * As of WordPress 5.5, this is only used for the browser update nag.
			 *
			 * @since 3.2.0
			 *
			 * @return {void}
			 */
			$( '.postbox a.dismiss' ).on( 'click.postboxes', function( event ) {
				var hide_id = $( this ).parents( '.postbox' ).attr( 'id' ) + '-hide';

				event.preventDefault();
				$( '#' + hide_id ).prop( 'checked', false ).triggerHandler( 'click' );
			});

			/**
			 * Hides the postbox element
			 *
			 * Event handler for the screen options checkboxes. When a checkbox is
			 * clicked this function will hide or show the relevant postboxes.
			 *
			 * @since 2.7.0
			 * @ignore
			 *
			 * @fires postboxes#postbox-toggled
			 *
			 * @return {void}
			 */
			$( '.hide-postbox-tog' ).on( 'click.postboxes', function() {
				var $el = $( this ),
					boxId = $el.val(),
					$postbox = $( '#' + boxId );

				if ( $el.prop( 'checked' ) ) {
					$postbox.show();

					if ( $.isFunction( postboxes.pbshow ) ) {
						postboxes.pbshow( boxId );
					}
				} else {
					$postbox.hide();

					if ( $.isFunction( postboxes.pbhide ) ) {
						postboxes.pbhide( boxId );
					}
				}

				postboxes.save_state();
				postboxes._mark_area();

				/**
				 * @since 4.0.0
				 * @see postboxes.handle_click
				 */
				$document.trigger( 'postbox-toggled', $postbox );
			});

			/**
			 * Changes the amount of columns based on the layout preferences.
			 *
			 * @since 2.8.0
			 *
			 * @return {void}
			 */
			$( '.columns-prefs input[type="radio"]' ).on( 'click.postboxes', function() {
				var number = parseInt( $( this ).val(), 10 );

				if ( number ) {
					postboxes._pb_edit( number );
					postboxes.save_order();
				}
			});

			// Enable dragging/arranging of postboxes and show drop placeholders when Screen Options tab is open.
			// If there is no Screen Options tab on the screen, dragging/arranging is enabled on page load.
			$document.on( 'screen:options:open', function() {
				$body.addClass( 'screen-options-open' );
				postboxes.initializeSortable();
				postboxes.showArrangeArrows();
			} ).on( 'screen:options:close', function() {
				$body.removeClass( 'screen-options-open' );
				$( '.meta-box-sortables' ).sortable( 'destroy' );
				postboxes.hideArrangeArrows();
			} );
		},

		initializeSortable: function() {
			var hasScreenOptions = $document.find( '#screen-options-wrap' ).length > 0;

			$( '.meta-box-sortables' ).sortable( {
				placeholder: 'sortable-placeholder',
				connectWith: '.meta-box-sortables',
				items: '.postbox',
				handle: '.hndle',
				cursor: 'move',
				delay: ( $body.hasClass( 'mobile' ) ? 200 : 0 ),
				distance: 2,
				tolerance: 'pointer',
				opacity: 0.65,
				forcePlaceholderSize: true,
				containment: '#wpwrap',

				helper: function( event, element ) {
					/* `helper: 'clone'` is equivalent to `return element.clone();`
					 * Cloning a checked radio and then inserting that clone next to the original
					 * radio unchecks the original radio (since only one of the two can be checked).
					 * We get around this by renaming the helper's inputs' name attributes so that,
					 * when the helper is inserted into the DOM for the sortable, no radios are
					 * duplicated, and no original radio gets unchecked.
					 */
					return element.clone()
						.find( ':input' )
						.attr( 'name', function( i, currentName ) {
							return 'sort_' + parseInt( Math.random() * 100000, 10 ).toString() + '_' + currentName;
						} )
						.end();
				},
				start: function() {
					// Pretend the Screen Options tab exists.
					if ( ! hasScreenOptions ) {
						$body.addClass( 'screen-options-open' );
					}

					// Refresh the cached positions of all the sortable items so that the min-height set while dragging works.
					$( '.meta-box-sortables' ).sortable( 'refreshPositions' );
				},
				stop: function() {
					var $el = $( this );

					if ( ! hasScreenOptions ) {
						$body.removeClass( 'screen-options-open' );
					}

					if ( $el.find( '#dashboard_browser_nag' ).is( ':visible' ) && 'dashboard_browser_nag' != this.firstChild.id ) {
						$el.sortable( 'cancel' );
						return;
					}

					postboxes._mark_area();
					postboxes.save_order();
				},
				receive: function( event, ui ) {
					if ( 'dashboard_browser_nag' == ui.item[0].id ) {
						$( ui.sender ).sortable( 'cancel' );
					}

					$document.trigger( 'postbox-moved', ui.item );
				}
			});
		},

		/**
		 * Initializes the postboxes, mainly their sortable behaviour.
		 *
		 * @since 2.7.0
		 *
		 * @memberof postboxes
		 *
		 * @param {string} page The page we are currently on. Not used, here for back-compat.
		 * @param {Object} [args={}] The arguments for the postbox initializer.
		 * @param {Function} args.pbshow A callback that is called when a postbox opens.
		 * @param {Function} args.pbhide A callback that is called when a postbox
		 *                               closes.
		 *
		 * @return {void}
		 */
		init: function( page, args ) {
			$.extend( this, args || {} );

			if ( $body.hasClass( 'mobile' ) ) {
				$body.on( 'orientationchange.postboxes', function() { postboxes._pb_change(); } );
				this._pb_change();
			}

			// Set the "arrange" (up/down) buttons properties on page load...
			this.updateOrderButtonsProperties();

			// ...and keep updating it when postboxes are added or removed by using the checkboxes in Screen Options.
			$document.on( 'postbox-toggled', this._mark_area );

			// Set the handle buttons `aria-expanded` attribute initial value on page load.
			$( '.postbox .handlediv' ).each( function () {
				var $el = $( this );
				$el.attr( 'aria-expanded', ! $el.closest( '.postbox' ).hasClass( 'closed' ) );
			});

			// Init sortables now if there is no Screen Options tab.
			// Otherwise init when Screen Options are open.
			if ( ! $document.find( '#screen-options-wrap' ).length ) {
				this.initializeSortable();
				this.showArrangeArrows();
			}
		},

		/**
		 * Saves the state of the postboxes to the server.
		 *
		 * It sends two lists, one with all the closed postboxes, one with all the
		 * hidden postboxes.
		 *
		 * @since 2.7.0
		 *
		 * @memberof postboxes
		 *
		 * @param {string} page The page we are currently on.
		 * @return {void}
		 */
		save_state : function() {
			var closed, hidden;

			// Return on the nav-menus.php screen, see #35112.
			if ( 'nav-menus' === postboxes.page ) {
				return;
			}

			closed = $( '.postbox' ).filter( '.closed' ).map( function() { return this.id; } ).get().join( ',' );
			hidden = $( '.postbox' ).filter( ':hidden' ).map( function() { return this.id; } ).get().join( ',' );

			$.post( ajaxurl, {
				action: 'closed-postboxes',
				closed: closed,
				hidden: hidden,
				closedpostboxesnonce: $( '#closedpostboxesnonce' ).val(),
				page: postboxes.page
			});
		},

		/**
		 * Saves the order of the postboxes to the server.
		 *
		 * Sends a list of all postboxes inside a sortable area to the server.
		 *
		 * @since 2.8.0
		 *
		 * @memberof postboxes
		 *
		 * @return {void}
		 */
		save_order : function() {
			var postVars = {
				action: 'meta-box-order',
				_ajax_nonce: $( '#meta-box-order-nonce' ).val(),
				page_columns: $( '.columns-prefs input:checked' ).val() || 0,
				page: postboxes.page
			};

			$( '.meta-box-sortables' ).each( function() {
				postVars[ 'order[' + this.id.split( '-' )[0] + ']' ] = $( this ).sortable( 'toArray' ).join( ',' );
			} );

			$.post(
				ajaxurl,
				postVars,
				function( response ) {
					if ( response.success ) {
						wp.a11y.speak( __( 'The boxes order has been saved.' ) );
					}
				}
			);
		},

		/**
		 * Marks empty postbox areas.
		 *
		 * Adds a message to empty sortable areas on the dashboard page. Also adds a
		 * border around the side area on the post edit screen if there are no postboxes
		 * present.
		 *
		 * @since 3.3.0
		 * @access private
		 *
		 * @memberof postboxes
		 *
		 * @return {void}
		 */
		_mark_area : function() {
			var elements = $( '.postbox:visible' ),
				containers = $( '.meta-box-sortables:visible' );

			containers.each( function( index, element ) {
				var container = $( element );

				if ( container.children( '.postbox:visible' ).length ) {
					container
						.removeClass( 'empty-container unused-container' )
						.removeAttr( 'data-emptystring' );
				} else {
					container.addClass( 'empty-container' );

					if ( elements.length < 1 ) {
						// Edge case: all postboxes are disabled.
						// Mark the first container as empty, the rest as unused.
						if ( index === 0 ) {
							container.attr( 'data-emptystring', __( 'Enable screen elements from the Screen Options menu' ) );
						} else {
							container.addClass( 'unused-container' );
						}

						// Break the loop.
						return false;
					}

					container.attr( 'data-emptystring', __( 'Drag screen elements here' ) );

					if ( elements.length <= index ) {
						// If there are not enough elements (postboxes) to add to all containers,
						// (and this container is empty, as tested above)
						// mark it as "unused".
						container.addClass( 'unused-container' );
					} else {
						container.removeClass( 'unused-container' );
					}
				}
			});

			// Refresh up/down arrows attributes.
			if ( $body.hasClass( 'screen-options-open' ) ) {
				postboxes.updateOrderButtonsProperties();
			}
		},

		/**
		 * Changes the amount of columns on the post edit page.
		 *
		 * @since 3.3.0
		 * @access private
		 *
		 * @memberof postboxes
		 *
		 * @fires postboxes#postboxes-columnchange
		 *
		 * @param {number} n The amount of columns to divide the post edit page in.
		 * @return {void}
		 */
		_pb_edit : function( n ) {
			var el = $( '.metabox-holder' ).get( 0 );

			if ( el ) {
				el.className = el.className.replace( /columns-\d+/, 'columns-' + n );
			}

			/**
			 * Fires when the amount of columns on the post edit page has been changed.
			 *
			 * @since 4.0.0
			 * @ignore
			 *
			 * @event postboxes#postboxes-columnchange
			 */
			$( document ).trigger( 'postboxes-columnchange' );
		},

		/**
		 * Changes the amount of columns the postboxes are in based on the current
		 * orientation of the browser.
		 *
		 * @since 3.3.0
		 * @access private
		 *
		 * @memberof postboxes
		 *
		 * @return {void}
		 */
		_pb_change : function() {
			var check = $( 'label.columns-prefs-1 input[type="radio"]' );

			switch ( window.orientation ) {
				case 90:
				case -90:
					if ( ! check.length || ! check.is( ':checked' ) ) {
						this._pb_edit( 2 );
					}
					break;
				case 0:
				case 180:
					if ( $( '#poststuff' ).length ) {
						this._pb_edit( 1 );
					} else if ( ! check.length || ! check.is( ':checked' ) ) {
						this._pb_edit( 2 );
					}
					break;
			}
		},

		/* Callbacks */

		/**
		 * @since 2.7.0
		 * @access public
		 *
		 * @property {Function|boolean} pbshow A callback that is called when a postbox
		 *                                     is opened.
		 * @memberof postboxes
		 */
		pbshow : false,

		/**
		 * @since 2.7.0
		 * @access public
		 * @property {Function|boolean} pbhide A callback that is called when a postbox
		 *                                     is closed.
		 * @memberof postboxes
		 */
		pbhide : false
	};

}( jQuery ));

No other release has this exact content. See every version of this file.