Initial commit. State 04.2021.

wp-includes/js/customize-preview.js

@@ -0,0 +1,171 @@
+(function( exports, $ ){
+	var api = wp.customize,
+		debounce;
+
+	/**
+	 * Returns a debounced version of the function.
+	 *
+	 * @todo Require Underscore.js for this file and retire this.
+	 */
+	debounce = function( fn, delay, context ) {
+		var timeout;
+		return function() {
+			var args = arguments;
+
+			context = context || this;
+
+			clearTimeout( timeout );
+			timeout = setTimeout( function() {
+				timeout = null;
+				fn.apply( context, args );
+			}, delay );
+		};
+	};
+
+	/**
+	 * @constructor
+	 * @augments wp.customize.Messenger
+	 * @augments wp.customize.Class
+	 * @mixes wp.customize.Events
+	 */
+	api.Preview = api.Messenger.extend({
+		/**
+		 * Requires params:
+		 *  - url    - the URL of preview frame
+		 */
+		initialize: function( params, options ) {
+			var self = this;
+
+			api.Messenger.prototype.initialize.call( this, params, options );
+
+			this.body = $( document.body );
+			this.body.on( 'click.preview', 'a', function( event ) {
+				event.preventDefault();
+				self.send( 'scroll', 0 );
+				self.send( 'url', $(this).prop('href') );
+			});
+
+			// You cannot submit forms.
+			// @todo: Allow form submissions by mixing $_POST data with the customize setting $_POST data.
+			this.body.on( 'submit.preview', 'form', function( event ) {
+				event.preventDefault();
+			});
+
+			this.window = $( window );
+			this.window.on( 'scroll.preview', debounce( function() {
+				self.send( 'scroll', self.window.scrollTop() );
+			}, 200 ));
+
+			this.bind( 'scroll', function( distance ) {
+				self.window.scrollTop( distance );
+			});
+		}
+	});
+
+	$( function() {
+		api.settings = window._wpCustomizeSettings;
+		if ( ! api.settings )
+			return;
+
+		var bg;
+
+		api.preview = new api.Preview({
+			url: window.location.href,
+			channel: api.settings.channel
+		});
+
+		api.preview.bind( 'settings', function( values ) {
+			$.each( values, function( id, value ) {
+				if ( api.has( id ) )
+					api( id ).set( value );
+				else
+					api.create( id, value );
+			});
+		});
+
+		api.preview.trigger( 'settings', api.settings.values );
+
+		api.preview.bind( 'setting', function( args ) {
+			var value;
+
+			args = args.slice();
+
+			if ( value = api( args.shift() ) )
+				value.set.apply( value, args );
+		});
+
+		api.preview.bind( 'sync', function( events ) {
+			$.each( events, function( event, args ) {
+				api.preview.trigger( event, args );
+			});
+			api.preview.send( 'synced' );
+		});
+
+		api.preview.bind( 'active', function() {
+			if ( api.settings.nonce ) {
+				api.preview.send( 'nonce', api.settings.nonce );
+			}
+
+			api.preview.send( 'documentTitle', document.title );
+		});
+
+		api.preview.send( 'ready', {
+			activePanels: api.settings.activePanels,
+			activeSections: api.settings.activeSections,
+			activeControls: api.settings.activeControls
+		} );
+
+		// Display a loading indicator when preview is reloading, and remove on failure.
+		api.preview.bind( 'loading-initiated', function () {
+			$( 'body' ).addClass( 'wp-customizer-unloading' );
+			$( 'html' ).prop( 'title', api.settings.l10n.loading );
+		});
+		api.preview.bind( 'loading-failed', function () {
+			$( 'body' ).removeClass( 'wp-customizer-unloading' );
+			$( 'html' ).prop( 'title', '' );
+		});
+
+		/* Custom Backgrounds */
+		bg = $.map(['color', 'image', 'position_x', 'repeat', 'attachment'], function( prop ) {
+			return 'background_' + prop;
+		});
+
+		api.when.apply( api, bg ).done( function( color, image, position_x, repeat, attachment ) {
+			var body = $(document.body),
+				head = $('head'),
+				style = $('#custom-background-css'),
+				update;
+
+			update = function() {
+				var css = '';
+
+				// The body will support custom backgrounds if either
+				// the color or image are set.
+				//
+				// See get_body_class() in /wp-includes/post-template.php
+				body.toggleClass( 'custom-background', !! ( color() || image() ) );
+
+				if ( color() )
+					css += 'background-color: ' + color() + ';';
+
+				if ( image() ) {
+					css += 'background-image: url("' + image() + '");';
+					css += 'background-position: top ' + position_x() + ';';
+					css += 'background-repeat: ' + repeat() + ';';
+					css += 'background-attachment: ' + attachment() + ';';
+				}
+
+				// Refresh the stylesheet by removing and recreating it.
+				style.remove();
+				style = $('<style type="text/css" id="custom-background-css">body.custom-background { ' + css + ' }</style>').appendTo( head );
+			};
+
+			$.each( arguments, function() {
+				this.bind( update );
+			});
+		});
+
+		api.trigger( 'preview-ready' );
+	});
+
+})( wp, jQuery );