WordPress 4.4

[autoinstalls/wordpress.git] / wp-includes / js / customize-loader.js

diff --git a/wp-includes/js/customize-loader.js b/wp-includes/js/customize-loader.js
index ce69a359c6cdb3d56c5333d1f55e6e526685ae1c..f853f37d85f30c1cdff64a9d0949408b36a292f7 100644 (file)
--- a/wp-includes/js/customize-loader.js
+++ b/wp-includes/js/customize-loader.js
@@ -1,4 +1,8 @@
 /* global _wpCustomizeLoaderSettings, confirm */
+/*
+ * Expose a public API that allows the customizer to be
+ * loaded on any page.
+ */
 window.wp = window.wp || {};
 
 (function( exports, $ ){
@@ -111,7 +115,11 @@ window.wp = window.wp || {};
                        this.active = true;
                        this.body.addClass('customize-loading');
 
-                       // Dirty state of Customizer in iframe
+                       /*
+                        * Track the dirtiness state (whether the drafted changes have been published)
+                        * of the Customizer in the iframe. This is used to decide whether to display
+                        * an AYS alert if the user tries to close the window before saving changes.
+                        */
                        this.saved = new api.Value( true );
 
                        this.iframe = $( '<iframe />', { 'src': src, 'title': Loader.settings.l10n.mainIframeTitle } ).appendTo( this.element );