2015-07-19 13:09:26 -04:00
|
|
|
/* global _wpCustomizeHeader, _wpCustomizeBackground, _wpMediaViewsL10n, MediaElementPlayer */
|
2012-08-22 20:04:18 -04:00
|
|
|
(function( exports, $ ){
|
2014-12-02 17:56:45 -05:00
|
|
|
var Container, focus, api = wp.customize;
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2013-11-11 08:32:10 -05:00
|
|
|
/**
|
2015-09-05 15:53:24 -04:00
|
|
|
* A Customizer Setting.
|
|
|
|
*
|
|
|
|
* A setting is WordPress data (theme mod, option, menu, etc.) that the user can
|
|
|
|
* draft changes to in the Customizer.
|
|
|
|
*
|
|
|
|
* @see PHP class WP_Customize_Setting.
|
|
|
|
*
|
2014-11-11 18:52:22 -05:00
|
|
|
* @class
|
2014-08-08 19:31:15 -04:00
|
|
|
* @augments wp.customize.Value
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*
|
2015-09-05 15:53:24 -04:00
|
|
|
* @param {object} id The Setting ID.
|
|
|
|
* @param {object} value The initial value of the setting.
|
|
|
|
* @param {object} options.previewer The Previewer instance to sync with.
|
|
|
|
* @param {object} options.transport The transport to use for previewing. Supports 'refresh' and 'postMessage'.
|
|
|
|
* @param {object} options.dirty
|
2012-08-22 20:04:18 -04:00
|
|
|
*/
|
|
|
|
api.Setting = api.Value.extend({
|
|
|
|
initialize: function( id, value, options ) {
|
|
|
|
api.Value.prototype.initialize.call( this, value, options );
|
|
|
|
|
|
|
|
this.id = id;
|
|
|
|
this.transport = this.transport || 'refresh';
|
2015-03-10 18:39:28 -04:00
|
|
|
this._dirty = options.dirty || false;
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
this.notifications = new api.Values({ defaultConstructor: api.Notification });
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
// Whenever the setting's value changes, refresh the preview.
|
2012-08-22 20:04:18 -04:00
|
|
|
this.bind( this.preview );
|
|
|
|
},
|
2015-09-05 15:53:24 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Refresh the preview, respective of the setting's refresh policy.
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
preview: function() {
|
|
|
|
switch ( this.transport ) {
|
|
|
|
case 'refresh':
|
|
|
|
return this.previewer.refresh();
|
|
|
|
case 'postMessage':
|
|
|
|
return this.previewer.send( 'setting', [ this.id, this() ] );
|
|
|
|
}
|
2016-06-14 15:17:28 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Find controls associated with this setting.
|
|
|
|
*
|
|
|
|
* @since 4.6.0
|
|
|
|
* @returns {wp.customize.Control[]} Controls associated with setting.
|
|
|
|
*/
|
|
|
|
findControls: function() {
|
|
|
|
var setting = this, controls = [];
|
|
|
|
api.control.each( function( control ) {
|
|
|
|
_.each( control.settings, function( controlSetting ) {
|
|
|
|
if ( controlSetting.id === setting.id ) {
|
|
|
|
controls.push( control );
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
return controls;
|
2012-08-22 20:04:18 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2014-12-02 17:56:45 -05:00
|
|
|
/**
|
|
|
|
* Utility function namespace
|
|
|
|
*/
|
|
|
|
api.utils = {};
|
|
|
|
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* Watch all changes to Value properties, and bubble changes to parent Values instance
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {wp.customize.Class} instance
|
2014-12-03 21:04:22 -05:00
|
|
|
* @param {Array} properties The names of the Value instances to watch.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
2014-12-02 17:56:45 -05:00
|
|
|
api.utils.bubbleChildValueChanges = function ( instance, properties ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
$.each( properties, function ( i, key ) {
|
|
|
|
instance[ key ].bind( function ( to, from ) {
|
|
|
|
if ( instance.parent && to !== from ) {
|
|
|
|
instance.parent.trigger( 'change', instance );
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Expand a panel, section, or control and focus on the first focusable element.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
|
|
|
* @param {Object} [params]
|
2016-01-22 16:21:26 -05:00
|
|
|
* @param {Function} [params.completeCallback]
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
focus = function ( params ) {
|
2016-03-30 17:41:26 -04:00
|
|
|
var construct, completeCallback, focus, focusElement;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
construct = this;
|
|
|
|
params = params || {};
|
|
|
|
focus = function () {
|
2015-03-29 07:17:28 -04:00
|
|
|
var focusContainer;
|
2015-09-07 01:59:24 -04:00
|
|
|
if ( construct.extended( api.Panel ) && construct.expanded && construct.expanded() ) {
|
|
|
|
focusContainer = construct.container.find( 'ul.control-panel-content' );
|
|
|
|
} else if ( construct.extended( api.Section ) && construct.expanded && construct.expanded() ) {
|
|
|
|
focusContainer = construct.container.find( 'ul.accordion-section-content' );
|
2015-03-29 07:17:28 -04:00
|
|
|
} else {
|
|
|
|
focusContainer = construct.container;
|
|
|
|
}
|
2015-08-08 05:37:26 -04:00
|
|
|
|
2016-03-30 17:41:26 -04:00
|
|
|
focusElement = focusContainer.find( '.control-focus:first' );
|
|
|
|
if ( 0 === focusElement.length ) {
|
|
|
|
// Note that we can't use :focusable due to a jQuery UI issue. See: https://github.com/jquery/jquery-ui/pull/1583
|
|
|
|
focusElement = focusContainer.find( 'input, select, textarea, button, object, a[href], [tabindex]' ).filter( ':visible' ).first();
|
|
|
|
}
|
|
|
|
focusElement.focus();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
};
|
|
|
|
if ( params.completeCallback ) {
|
|
|
|
completeCallback = params.completeCallback;
|
|
|
|
params.completeCallback = function () {
|
|
|
|
focus();
|
|
|
|
completeCallback();
|
|
|
|
};
|
|
|
|
} else {
|
|
|
|
params.completeCallback = focus;
|
|
|
|
}
|
|
|
|
if ( construct.expand ) {
|
|
|
|
construct.expand( params );
|
|
|
|
} else {
|
|
|
|
params.completeCallback();
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2014-11-03 16:35:23 -05:00
|
|
|
/**
|
|
|
|
* Stable sort for Panels, Sections, and Controls.
|
|
|
|
*
|
|
|
|
* If a.priority() === b.priority(), then sort by their respective params.instanceNumber.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
2014-11-03 16:35:23 -05:00
|
|
|
* @param {(wp.customize.Panel|wp.customize.Section|wp.customize.Control)} a
|
|
|
|
* @param {(wp.customize.Panel|wp.customize.Section|wp.customize.Control)} b
|
|
|
|
* @returns {Number}
|
|
|
|
*/
|
2014-12-02 17:56:45 -05:00
|
|
|
api.utils.prioritySort = function ( a, b ) {
|
2014-11-03 16:35:23 -05:00
|
|
|
if ( a.priority() === b.priority() && typeof a.params.instanceNumber === 'number' && typeof b.params.instanceNumber === 'number' ) {
|
|
|
|
return a.params.instanceNumber - b.params.instanceNumber;
|
|
|
|
} else {
|
|
|
|
return a.priority() - b.priority();
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
/**
|
|
|
|
* Return whether the supplied Event object is for a keydown event but not the Enter key.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {jQuery.Event} event
|
|
|
|
* @returns {boolean}
|
|
|
|
*/
|
2014-12-02 17:56:45 -05:00
|
|
|
api.utils.isKeydownButNotEnterEvent = function ( event ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return ( 'keydown' === event.type && 13 !== event.which );
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return whether the two lists of elements are the same and are in the same order.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {Array|jQuery} listA
|
|
|
|
* @param {Array|jQuery} listB
|
|
|
|
* @returns {boolean}
|
|
|
|
*/
|
2014-12-02 17:56:45 -05:00
|
|
|
api.utils.areElementListsEqual = function ( listA, listB ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
var equal = (
|
|
|
|
listA.length === listB.length && // if lists are different lengths, then naturally they are not equal
|
2014-12-23 12:05:26 -05:00
|
|
|
-1 === _.indexOf( _.map( // are there any false values in the list returned by map?
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
_.zip( listA, listB ), // pair up each element between the two lists
|
|
|
|
function ( pair ) {
|
|
|
|
return $( pair[0] ).is( pair[1] ); // compare to see if each pair are equal
|
|
|
|
}
|
2014-12-23 12:05:26 -05:00
|
|
|
), false ) // check for presence of false in map's return value
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
);
|
|
|
|
return equal;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* Base class for Panel and Section.
|
|
|
|
*
|
|
|
|
* @since 4.1.0
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*
|
2014-11-11 18:52:22 -05:00
|
|
|
* @class
|
2014-08-08 19:31:15 -04:00
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
Container = api.Class.extend({
|
2014-11-11 17:37:22 -05:00
|
|
|
defaultActiveArguments: { duration: 'fast', completeCallback: $.noop },
|
|
|
|
defaultExpandedArguments: { duration: 'fast', completeCallback: $.noop },
|
2015-05-29 20:03:30 -04:00
|
|
|
containerType: 'container',
|
2015-06-01 18:47:25 -04:00
|
|
|
defaults: {
|
|
|
|
title: '',
|
|
|
|
description: '',
|
|
|
|
priority: 100,
|
|
|
|
type: 'default',
|
|
|
|
content: null,
|
|
|
|
active: true,
|
|
|
|
instanceNumber: null
|
|
|
|
},
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
2014-12-03 21:04:22 -05:00
|
|
|
/**
|
|
|
|
* @since 4.1.0
|
|
|
|
*
|
2015-06-01 18:47:25 -04:00
|
|
|
* @param {string} id - The ID for the container.
|
|
|
|
* @param {object} options - Object containing one property: params.
|
|
|
|
* @param {object} options.params - Object containing the following properties.
|
|
|
|
* @param {string} options.params.title - Title shown when panel is collapsed and expanded.
|
|
|
|
* @param {string=} [options.params.description] - Description shown at the top of the panel.
|
|
|
|
* @param {number=100} [options.params.priority] - The sort priority for the panel.
|
|
|
|
* @param {string=default} [options.params.type] - The type of the panel. See wp.customize.panelConstructor.
|
|
|
|
* @param {string=} [options.params.content] - The markup to be used for the panel container. If empty, a JS template is used.
|
|
|
|
* @param {boolean=true} [options.params.active] - Whether the panel is active or not.
|
2014-12-03 21:04:22 -05:00
|
|
|
*/
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
initialize: function ( id, options ) {
|
|
|
|
var container = this;
|
|
|
|
container.id = id;
|
2015-06-01 18:47:25 -04:00
|
|
|
options = options || {};
|
|
|
|
|
|
|
|
options.params = _.defaults(
|
|
|
|
options.params || {},
|
|
|
|
container.defaults
|
|
|
|
);
|
|
|
|
|
|
|
|
$.extend( container, options );
|
2015-05-29 20:03:30 -04:00
|
|
|
container.templateSelector = 'customize-' + container.containerType + '-' + container.params.type;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
container.container = $( container.params.content );
|
2015-05-29 20:03:30 -04:00
|
|
|
if ( 0 === container.container.length ) {
|
|
|
|
container.container = $( container.getContainer() );
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
container.deferred = {
|
2014-12-02 17:56:45 -05:00
|
|
|
embedded: new $.Deferred()
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
};
|
|
|
|
container.priority = new api.Value();
|
|
|
|
container.active = new api.Value();
|
|
|
|
container.activeArgumentsQueue = [];
|
|
|
|
container.expanded = new api.Value();
|
|
|
|
container.expandedArgumentsQueue = [];
|
|
|
|
|
|
|
|
container.active.bind( function ( active ) {
|
|
|
|
var args = container.activeArgumentsQueue.shift();
|
|
|
|
args = $.extend( {}, container.defaultActiveArguments, args );
|
|
|
|
active = ( active && container.isContextuallyActive() );
|
|
|
|
container.onChangeActive( active, args );
|
|
|
|
});
|
|
|
|
container.expanded.bind( function ( expanded ) {
|
|
|
|
var args = container.expandedArgumentsQueue.shift();
|
|
|
|
args = $.extend( {}, container.defaultExpandedArguments, args );
|
|
|
|
container.onChangeExpanded( expanded, args );
|
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-05-29 20:03:30 -04:00
|
|
|
container.deferred.embedded.done( function () {
|
|
|
|
container.attachEvents();
|
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-12-02 17:56:45 -05:00
|
|
|
api.utils.bubbleChildValueChanges( container, [ 'priority', 'active' ] );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-06-01 18:47:25 -04:00
|
|
|
container.priority.set( container.params.priority );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
container.active.set( container.params.active );
|
2014-12-02 17:56:45 -05:00
|
|
|
container.expanded.set( false );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @abstract
|
|
|
|
*/
|
|
|
|
ready: function() {},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the child models associated with this parent, sorting them by their priority Value.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {String} parentType
|
|
|
|
* @param {String} childType
|
|
|
|
* @returns {Array}
|
|
|
|
*/
|
|
|
|
_children: function ( parentType, childType ) {
|
|
|
|
var parent = this,
|
|
|
|
children = [];
|
|
|
|
api[ childType ].each( function ( child ) {
|
|
|
|
if ( child[ parentType ].get() === parent.id ) {
|
|
|
|
children.push( child );
|
|
|
|
}
|
|
|
|
} );
|
2014-12-02 17:56:45 -05:00
|
|
|
children.sort( api.utils.prioritySort );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return children;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* To override by subclass, to return whether the container has active children.
|
2014-12-03 21:04:22 -05:00
|
|
|
*
|
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @abstract
|
|
|
|
*/
|
|
|
|
isContextuallyActive: function () {
|
2014-12-02 17:56:45 -05:00
|
|
|
throw new Error( 'Container.isContextuallyActive() must be overridden in a subclass.' );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2015-09-05 15:53:24 -04:00
|
|
|
* Active state change handler.
|
2014-12-03 21:04:22 -05:00
|
|
|
*
|
2015-09-05 15:53:24 -04:00
|
|
|
* Shows the container if it is active, hides it if not.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*
|
|
|
|
* To override by subclass, update the container's UI to reflect the provided active state.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {Boolean} active
|
2014-12-03 21:04:22 -05:00
|
|
|
* @param {Object} args
|
|
|
|
* @param {Object} args.duration
|
|
|
|
* @param {Object} args.completeCallback
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
2015-08-26 03:26:21 -04:00
|
|
|
onChangeActive: function( active, args ) {
|
2015-10-16 19:48:25 -04:00
|
|
|
var duration, construct = this, expandedOtherPanel;
|
2015-08-26 03:26:21 -04:00
|
|
|
if ( args.unchanged ) {
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-06-12 18:28:25 -04:00
|
|
|
duration = ( 'resolved' === api.previewer.deferred.active.state() ? args.duration : 0 );
|
2015-10-16 19:48:25 -04:00
|
|
|
|
|
|
|
if ( construct.extended( api.Panel ) ) {
|
|
|
|
// If this is a panel is not currently expanded but another panel is expanded, do not animate.
|
|
|
|
api.panel.each(function ( panel ) {
|
|
|
|
if ( panel !== construct && panel.expanded() ) {
|
|
|
|
expandedOtherPanel = panel;
|
|
|
|
duration = 0;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
// Collapse any expanded sections inside of this panel first before deactivating.
|
|
|
|
if ( ! active ) {
|
|
|
|
_.each( construct.sections(), function( section ) {
|
|
|
|
section.collapse( { duration: 0 } );
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-06-12 18:28:25 -04:00
|
|
|
if ( ! $.contains( document, construct.container[0] ) ) {
|
2014-11-11 17:37:22 -05:00
|
|
|
// jQuery.fn.slideUp is not hiding an element if it is not in the DOM
|
2015-06-12 18:28:25 -04:00
|
|
|
construct.container.toggle( active );
|
2014-12-15 14:54:21 -05:00
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
2014-11-11 17:37:22 -05:00
|
|
|
} else if ( active ) {
|
2015-06-12 18:28:25 -04:00
|
|
|
construct.container.stop( true, true ).slideDown( duration, args.completeCallback );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
} else {
|
2015-06-12 18:28:25 -04:00
|
|
|
if ( construct.expanded() ) {
|
|
|
|
construct.collapse({
|
|
|
|
duration: duration,
|
|
|
|
completeCallback: function() {
|
|
|
|
construct.container.stop( true, true ).slideUp( duration, args.completeCallback );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
} else {
|
|
|
|
construct.container.stop( true, true ).slideUp( duration, args.completeCallback );
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2015-10-16 19:48:25 -04:00
|
|
|
|
|
|
|
// Recalculate the margin-top immediately, not waiting for debounced reflow, to prevent momentary (100ms) vertical jiggle.
|
|
|
|
if ( expandedOtherPanel ) {
|
|
|
|
expandedOtherPanel._recalculateTopMargin();
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @params {Boolean} active
|
2014-12-03 21:04:22 -05:00
|
|
|
* @param {Object} [params]
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @returns {Boolean} false if state already applied
|
|
|
|
*/
|
|
|
|
_toggleActive: function ( active, params ) {
|
|
|
|
var self = this;
|
|
|
|
params = params || {};
|
|
|
|
if ( ( active && this.active.get() ) || ( ! active && ! this.active.get() ) ) {
|
|
|
|
params.unchanged = true;
|
|
|
|
self.onChangeActive( self.active.get(), params );
|
|
|
|
return false;
|
|
|
|
} else {
|
|
|
|
params.unchanged = false;
|
|
|
|
this.activeArgumentsQueue.push( params );
|
|
|
|
this.active.set( active );
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param {Object} [params]
|
|
|
|
* @returns {Boolean} false if already active
|
|
|
|
*/
|
|
|
|
activate: function ( params ) {
|
|
|
|
return this._toggleActive( true, params );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param {Object} [params]
|
|
|
|
* @returns {Boolean} false if already inactive
|
|
|
|
*/
|
|
|
|
deactivate: function ( params ) {
|
|
|
|
return this._toggleActive( false, params );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* To override by subclass, update the container's UI to reflect the provided active state.
|
|
|
|
* @abstract
|
|
|
|
*/
|
|
|
|
onChangeExpanded: function () {
|
|
|
|
throw new Error( 'Must override with subclass.' );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2015-10-16 19:48:25 -04:00
|
|
|
* Handle the toggle logic for expand/collapse.
|
|
|
|
*
|
|
|
|
* @param {Boolean} expanded - The new state to apply.
|
|
|
|
* @param {Object} [params] - Object containing options for expand/collapse.
|
|
|
|
* @param {Function} [params.completeCallback] - Function to call when expansion/collapse is complete.
|
|
|
|
* @returns {Boolean} false if state already applied or active state is false
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
2015-10-16 19:48:25 -04:00
|
|
|
_toggleExpanded: function( expanded, params ) {
|
|
|
|
var instance = this, previousCompleteCallback;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
params = params || {};
|
2015-10-16 19:48:25 -04:00
|
|
|
previousCompleteCallback = params.completeCallback;
|
|
|
|
|
|
|
|
// Short-circuit expand() if the instance is not active.
|
|
|
|
if ( expanded && ! instance.active() ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
params.completeCallback = function() {
|
2015-03-07 06:06:29 -05:00
|
|
|
if ( previousCompleteCallback ) {
|
2015-10-16 19:48:25 -04:00
|
|
|
previousCompleteCallback.apply( instance, arguments );
|
2015-03-07 06:06:29 -05:00
|
|
|
}
|
|
|
|
if ( expanded ) {
|
2015-10-16 19:48:25 -04:00
|
|
|
instance.container.trigger( 'expanded' );
|
2015-03-07 06:06:29 -05:00
|
|
|
} else {
|
2015-10-16 19:48:25 -04:00
|
|
|
instance.container.trigger( 'collapsed' );
|
2015-03-07 06:06:29 -05:00
|
|
|
}
|
|
|
|
};
|
2015-10-16 19:48:25 -04:00
|
|
|
if ( ( expanded && instance.expanded.get() ) || ( ! expanded && ! instance.expanded.get() ) ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
params.unchanged = true;
|
2015-10-16 19:48:25 -04:00
|
|
|
instance.onChangeExpanded( instance.expanded.get(), params );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return false;
|
|
|
|
} else {
|
|
|
|
params.unchanged = false;
|
2015-10-16 19:48:25 -04:00
|
|
|
instance.expandedArgumentsQueue.push( params );
|
|
|
|
instance.expanded.set( expanded );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return true;
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param {Object} [params]
|
2015-10-16 19:48:25 -04:00
|
|
|
* @returns {Boolean} false if already expanded or if inactive.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
expand: function ( params ) {
|
|
|
|
return this._toggleExpanded( true, params );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param {Object} [params]
|
2015-10-16 19:48:25 -04:00
|
|
|
* @returns {Boolean} false if already collapsed.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
collapse: function ( params ) {
|
|
|
|
return this._toggleExpanded( false, params );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Bring the container into view and then expand this and bring it into view
|
|
|
|
* @param {Object} [params]
|
|
|
|
*/
|
2015-05-29 20:03:30 -04:00
|
|
|
focus: focus,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the container html, generated from its JS template, if it exists.
|
|
|
|
*
|
|
|
|
* @since 4.3.0
|
|
|
|
*/
|
|
|
|
getContainer: function () {
|
|
|
|
var template,
|
|
|
|
container = this;
|
|
|
|
|
|
|
|
if ( 0 !== $( '#tmpl-' + container.templateSelector ).length ) {
|
|
|
|
template = wp.template( container.templateSelector );
|
2015-06-01 18:47:25 -04:00
|
|
|
} else {
|
|
|
|
template = wp.template( 'customize-' + container.containerType + '-default' );
|
|
|
|
}
|
|
|
|
if ( template && container.container ) {
|
|
|
|
return $.trim( template( container.params ) );
|
2015-05-29 20:03:30 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
return '<li></li>';
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
2014-11-11 18:52:22 -05:00
|
|
|
* @class
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.Section = Container.extend({
|
2015-05-29 20:03:30 -04:00
|
|
|
containerType: 'section',
|
2015-06-01 18:47:25 -04:00
|
|
|
defaults: {
|
|
|
|
title: '',
|
|
|
|
description: '',
|
|
|
|
priority: 100,
|
|
|
|
type: 'default',
|
|
|
|
content: null,
|
|
|
|
active: true,
|
|
|
|
instanceNumber: null,
|
|
|
|
panel: null,
|
|
|
|
customizeAction: ''
|
|
|
|
},
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
2015-06-01 18:47:25 -04:00
|
|
|
* @param {string} id - The ID for the section.
|
|
|
|
* @param {object} options - Object containing one property: params.
|
|
|
|
* @param {object} options.params - Object containing the following properties.
|
|
|
|
* @param {string} options.params.title - Title shown when section is collapsed and expanded.
|
|
|
|
* @param {string=} [options.params.description] - Description shown at the top of the section.
|
|
|
|
* @param {number=100} [options.params.priority] - The sort priority for the section.
|
|
|
|
* @param {string=default} [options.params.type] - The type of the section. See wp.customize.sectionConstructor.
|
|
|
|
* @param {string=} [options.params.content] - The markup to be used for the section container. If empty, a JS template is used.
|
|
|
|
* @param {boolean=true} [options.params.active] - Whether the section is active or not.
|
|
|
|
* @param {string} options.params.panel - The ID for the panel this section is associated with.
|
|
|
|
* @param {string=} [options.params.customizeAction] - Additional context information shown before the section title when expanded.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
initialize: function ( id, options ) {
|
|
|
|
var section = this;
|
|
|
|
Container.prototype.initialize.call( section, id, options );
|
|
|
|
|
|
|
|
section.id = id;
|
|
|
|
section.panel = new api.Value();
|
|
|
|
section.panel.bind( function ( id ) {
|
|
|
|
$( section.container ).toggleClass( 'control-subsection', !! id );
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
section.panel.set( section.params.panel || '' );
|
2014-12-02 17:56:45 -05:00
|
|
|
api.utils.bubbleChildValueChanges( section, [ 'panel' ] );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
section.embed();
|
2014-12-02 17:56:45 -05:00
|
|
|
section.deferred.embedded.done( function () {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
section.ready();
|
|
|
|
});
|
|
|
|
},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
/**
|
|
|
|
* Embed the container in the DOM when any parent panel is ready.
|
2014-12-03 21:04:22 -05:00
|
|
|
*
|
|
|
|
* @since 4.1.0
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
embed: function () {
|
|
|
|
var section = this, inject;
|
|
|
|
|
|
|
|
// Watch for changes to the panel state
|
|
|
|
inject = function ( panelId ) {
|
|
|
|
var parentContainer;
|
|
|
|
if ( panelId ) {
|
|
|
|
// The panel has been supplied, so wait until the panel object is registered
|
|
|
|
api.panel( panelId, function ( panel ) {
|
|
|
|
// The panel has been registered, wait for it to become ready/initialized
|
2014-12-02 17:56:45 -05:00
|
|
|
panel.deferred.embedded.done( function () {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
parentContainer = panel.container.find( 'ul:first' );
|
|
|
|
if ( ! section.container.parent().is( parentContainer ) ) {
|
|
|
|
parentContainer.append( section.container );
|
|
|
|
}
|
2014-12-02 17:56:45 -05:00
|
|
|
section.deferred.embedded.resolve();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
});
|
|
|
|
} );
|
|
|
|
} else {
|
|
|
|
// There is no panel, so embed the section in the root of the customizer
|
|
|
|
parentContainer = $( '#customize-theme-controls' ).children( 'ul' ); // @todo This should be defined elsewhere, and to be configurable
|
|
|
|
if ( ! section.container.parent().is( parentContainer ) ) {
|
|
|
|
parentContainer.append( section.container );
|
|
|
|
}
|
2014-12-02 17:56:45 -05:00
|
|
|
section.deferred.embedded.resolve();
|
2012-08-22 20:04:18 -04:00
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
};
|
|
|
|
section.panel.bind( inject );
|
|
|
|
inject( section.panel.get() ); // Since a section may never get a panel, assume that it won't ever get one
|
2015-10-16 19:48:25 -04:00
|
|
|
|
|
|
|
section.deferred.embedded.done(function() {
|
|
|
|
// Fix the top margin after reflow.
|
|
|
|
api.bind( 'pane-contents-reflowed', _.debounce( function() {
|
|
|
|
section._recalculateTopMargin();
|
|
|
|
}, 100 ) );
|
|
|
|
});
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* Add behaviors for the accordion section.
|
|
|
|
*
|
|
|
|
* @since 4.1.0
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
attachEvents: function () {
|
2015-07-03 16:19:25 -04:00
|
|
|
var section = this;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
// Expand/Collapse accordion sections on click.
|
2015-05-29 09:57:26 -04:00
|
|
|
section.container.find( '.accordion-section-title, .customize-section-back' ).on( 'click keydown', function( event ) {
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
if ( section.expanded() ) {
|
|
|
|
section.collapse();
|
|
|
|
} else {
|
|
|
|
section.expand();
|
|
|
|
}
|
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return whether this section has any active controls.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
|
|
|
* @returns {Boolean}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
isContextuallyActive: function () {
|
|
|
|
var section = this,
|
|
|
|
controls = section.controls(),
|
|
|
|
activeCount = 0;
|
|
|
|
_( controls ).each( function ( control ) {
|
|
|
|
if ( control.active() ) {
|
|
|
|
activeCount += 1;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
return ( activeCount !== 0 );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the controls that are associated with this section, sorted by their priority Value.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @returns {Array}
|
|
|
|
*/
|
|
|
|
controls: function () {
|
|
|
|
return this._children( 'section', 'control' );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* Update UI to reflect expanded state.
|
|
|
|
*
|
|
|
|
* @since 4.1.0
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*
|
|
|
|
* @param {Boolean} expanded
|
2014-12-03 21:04:22 -05:00
|
|
|
* @param {Object} args
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
onChangeExpanded: function ( expanded, args ) {
|
2015-08-11 19:56:25 -04:00
|
|
|
var section = this,
|
2015-05-29 09:57:26 -04:00
|
|
|
container = section.container.closest( '.wp-full-overlay-sidebar-content' ),
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
content = section.container.find( '.accordion-section-content' ),
|
2015-05-29 09:57:26 -04:00
|
|
|
overlay = section.container.closest( '.wp-full-overlay' ),
|
2015-07-03 16:19:25 -04:00
|
|
|
backBtn = section.container.find( '.customize-section-back' ),
|
|
|
|
sectionTitle = section.container.find( '.accordion-section-title' ).first(),
|
2015-08-11 19:56:25 -04:00
|
|
|
headerActionsHeight = $( '#customize-header-actions' ).height(),
|
|
|
|
resizeContentHeight, expand, position, scroll;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
2015-05-29 09:57:26 -04:00
|
|
|
if ( expanded && ! section.container.hasClass( 'open' ) ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
if ( args.unchanged ) {
|
|
|
|
expand = args.completeCallback;
|
|
|
|
} else {
|
2015-05-29 09:57:26 -04:00
|
|
|
container.scrollTop( 0 );
|
2015-08-11 19:56:25 -04:00
|
|
|
resizeContentHeight = function() {
|
2015-07-27 23:43:24 -04:00
|
|
|
var matchMedia, offset;
|
|
|
|
matchMedia = window.matchMedia || window.msMatchMedia;
|
|
|
|
offset = 90; // 45px for customize header actions + 45px for footer actions.
|
|
|
|
|
|
|
|
// No footer on small screens.
|
|
|
|
if ( matchMedia && matchMedia( '(max-width: 640px)' ).matches ) {
|
|
|
|
offset = 45;
|
|
|
|
}
|
2015-08-11 19:56:25 -04:00
|
|
|
content.css( 'height', ( window.innerHeight - offset ) );
|
|
|
|
};
|
|
|
|
expand = function() {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
section.container.addClass( 'open' );
|
2015-05-29 09:57:26 -04:00
|
|
|
overlay.addClass( 'section-open' );
|
|
|
|
position = content.offset().top;
|
|
|
|
scroll = container.scrollTop();
|
2015-08-11 19:56:25 -04:00
|
|
|
content.css( 'margin-top', ( headerActionsHeight - position - scroll ) );
|
|
|
|
resizeContentHeight();
|
2015-07-03 16:19:25 -04:00
|
|
|
sectionTitle.attr( 'tabindex', '-1' );
|
|
|
|
backBtn.attr( 'tabindex', '0' );
|
|
|
|
backBtn.focus();
|
2015-06-12 18:28:25 -04:00
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
2015-08-11 19:56:25 -04:00
|
|
|
|
|
|
|
// Fix the height after browser resize.
|
|
|
|
$( window ).on( 'resize.customizer-section', _.debounce( resizeContentHeight, 100 ) );
|
|
|
|
|
2016-03-02 13:37:26 -05:00
|
|
|
setTimeout( _.bind( section._recalculateTopMargin, section ), 0 );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
};
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( ! args.allowMultiple ) {
|
|
|
|
api.section.each( function ( otherSection ) {
|
|
|
|
if ( otherSection !== section ) {
|
|
|
|
otherSection.collapse( { duration: args.duration } );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( section.panel() ) {
|
|
|
|
api.panel( section.panel() ).expand({
|
|
|
|
duration: args.duration,
|
|
|
|
completeCallback: expand
|
|
|
|
});
|
|
|
|
} else {
|
2015-08-31 19:08:42 -04:00
|
|
|
api.panel.each( function( panel ) {
|
|
|
|
panel.collapse();
|
|
|
|
});
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
expand();
|
|
|
|
}
|
|
|
|
|
2015-06-12 18:28:25 -04:00
|
|
|
} else if ( ! expanded && section.container.hasClass( 'open' ) ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
section.container.removeClass( 'open' );
|
2015-05-29 09:57:26 -04:00
|
|
|
overlay.removeClass( 'section-open' );
|
2015-08-11 19:56:25 -04:00
|
|
|
content.css( 'margin-top', '' );
|
2015-05-29 09:57:26 -04:00
|
|
|
container.scrollTop( 0 );
|
2015-07-03 16:19:25 -04:00
|
|
|
backBtn.attr( 'tabindex', '-1' );
|
|
|
|
sectionTitle.attr( 'tabindex', '0' );
|
|
|
|
sectionTitle.focus();
|
2015-06-12 18:28:25 -04:00
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
2015-08-11 19:56:25 -04:00
|
|
|
$( window ).off( 'resize.customizer-section' );
|
2015-06-12 18:28:25 -04:00
|
|
|
} else {
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2015-10-16 19:48:25 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Recalculate the top margin.
|
|
|
|
*
|
|
|
|
* @since 4.4.0
|
|
|
|
* @private
|
|
|
|
*/
|
|
|
|
_recalculateTopMargin: function() {
|
|
|
|
var section = this, content, offset, headerActionsHeight;
|
|
|
|
content = section.container.find( '.accordion-section-content' );
|
|
|
|
if ( 0 === content.length ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
headerActionsHeight = $( '#customize-header-actions' ).height();
|
|
|
|
offset = ( content.offset().top - headerActionsHeight );
|
|
|
|
if ( 0 < offset ) {
|
|
|
|
content.css( 'margin-top', ( parseInt( content.css( 'margin-top' ), 10 ) - offset ) );
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2015-02-24 15:31:24 -05:00
|
|
|
/**
|
|
|
|
* wp.customize.ThemesSection
|
|
|
|
*
|
|
|
|
* Custom section for themes that functions similarly to a backwards panel,
|
|
|
|
* and also handles the theme-details view rendering and navigation.
|
|
|
|
*
|
|
|
|
* @constructor
|
|
|
|
* @augments wp.customize.Section
|
|
|
|
* @augments wp.customize.Container
|
|
|
|
*/
|
|
|
|
api.ThemesSection = api.Section.extend({
|
|
|
|
currentTheme: '',
|
|
|
|
overlay: '',
|
|
|
|
template: '',
|
2015-04-08 16:52:29 -04:00
|
|
|
screenshotQueue: null,
|
|
|
|
$window: $( window ),
|
2015-04-13 18:10:29 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
initialize: function () {
|
|
|
|
this.$customizeSidebar = $( '.wp-full-overlay-sidebar-content:first' );
|
|
|
|
return api.Section.prototype.initialize.apply( this, arguments );
|
|
|
|
},
|
2015-02-24 15:31:24 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
ready: function () {
|
|
|
|
var section = this;
|
|
|
|
section.overlay = section.container.find( '.theme-overlay' );
|
|
|
|
section.template = wp.template( 'customize-themes-details-view' );
|
|
|
|
|
|
|
|
// Bind global keyboard events.
|
|
|
|
$( 'body' ).on( 'keyup', function( event ) {
|
|
|
|
if ( ! section.overlay.find( '.theme-wrap' ).is( ':visible' ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Pressing the right arrow key fires a theme:next event
|
|
|
|
if ( 39 === event.keyCode ) {
|
|
|
|
section.nextTheme();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Pressing the left arrow key fires a theme:previous event
|
|
|
|
if ( 37 === event.keyCode ) {
|
|
|
|
section.previousTheme();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Pressing the escape key fires a theme:collapse event
|
|
|
|
if ( 27 === event.keyCode ) {
|
|
|
|
section.closeDetails();
|
|
|
|
}
|
|
|
|
});
|
2015-04-08 16:52:29 -04:00
|
|
|
|
|
|
|
_.bindAll( this, 'renderScreenshots' );
|
2015-02-24 15:31:24 -05:00
|
|
|
},
|
|
|
|
|
2015-04-08 13:53:28 -04:00
|
|
|
/**
|
|
|
|
* Override Section.isContextuallyActive method.
|
|
|
|
*
|
|
|
|
* Ignore the active states' of the contained theme controls, and just
|
|
|
|
* use the section's own active state instead. This ensures empty search
|
|
|
|
* results for themes to cause the section to become inactive.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*
|
|
|
|
* @returns {Boolean}
|
|
|
|
*/
|
|
|
|
isContextuallyActive: function () {
|
|
|
|
return this.active();
|
|
|
|
},
|
|
|
|
|
2015-02-24 15:31:24 -05:00
|
|
|
/**
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
attachEvents: function () {
|
2015-02-24 23:17:27 -05:00
|
|
|
var section = this;
|
2015-02-24 15:31:24 -05:00
|
|
|
|
|
|
|
// Expand/Collapse section/panel.
|
2015-04-01 18:51:27 -04:00
|
|
|
section.container.find( '.change-theme, .customize-theme' ).on( 'click keydown', function( event ) {
|
2015-02-24 15:31:24 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
if ( section.expanded() ) {
|
|
|
|
section.collapse();
|
|
|
|
} else {
|
|
|
|
section.expand();
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
// Theme navigation in details view.
|
|
|
|
section.container.on( 'click keydown', '.left', function( event ) {
|
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
section.previousTheme();
|
|
|
|
});
|
|
|
|
|
|
|
|
section.container.on( 'click keydown', '.right', function( event ) {
|
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
section.nextTheme();
|
|
|
|
});
|
|
|
|
|
|
|
|
section.container.on( 'click keydown', '.theme-backdrop, .close', function( event ) {
|
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
section.closeDetails();
|
|
|
|
});
|
|
|
|
|
2015-04-08 16:52:29 -04:00
|
|
|
var renderScreenshots = _.throttle( _.bind( section.renderScreenshots, this ), 100 );
|
2015-02-24 15:31:24 -05:00
|
|
|
section.container.on( 'input', '#themes-filter', function( event ) {
|
2015-02-24 23:17:27 -05:00
|
|
|
var count,
|
|
|
|
term = event.currentTarget.value.toLowerCase().trim().replace( '-', ' ' ),
|
2015-02-24 15:31:24 -05:00
|
|
|
controls = section.controls();
|
2015-02-24 23:17:27 -05:00
|
|
|
|
2015-02-24 15:31:24 -05:00
|
|
|
_.each( controls, function( control ) {
|
|
|
|
control.filter( term );
|
|
|
|
});
|
2015-04-04 10:14:26 -04:00
|
|
|
|
2015-04-08 16:52:29 -04:00
|
|
|
renderScreenshots();
|
|
|
|
|
2015-04-04 10:14:26 -04:00
|
|
|
// Update theme count.
|
2015-02-24 15:31:24 -05:00
|
|
|
count = section.container.find( 'li.customize-control:visible' ).length;
|
|
|
|
section.container.find( '.theme-count' ).text( count );
|
|
|
|
});
|
2015-04-08 16:52:29 -04:00
|
|
|
|
|
|
|
// Pre-load the first 3 theme screenshots.
|
|
|
|
api.bind( 'ready', function () {
|
|
|
|
_.each( section.controls().slice( 0, 3 ), function ( control ) {
|
|
|
|
var img, src = control.params.theme.screenshot[0];
|
|
|
|
if ( src ) {
|
|
|
|
img = new Image();
|
|
|
|
img.src = src;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
});
|
2015-02-24 15:31:24 -05:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update UI to reflect expanded state
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*
|
|
|
|
* @param {Boolean} expanded
|
|
|
|
* @param {Object} args
|
|
|
|
* @param {Boolean} args.unchanged
|
|
|
|
* @param {Callback} args.completeCallback
|
|
|
|
*/
|
|
|
|
onChangeExpanded: function ( expanded, args ) {
|
|
|
|
|
|
|
|
// Immediately call the complete callback if there were no changes
|
|
|
|
if ( args.unchanged ) {
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Note: there is a second argument 'args' passed
|
|
|
|
var position, scroll,
|
|
|
|
panel = this,
|
|
|
|
section = panel.container.closest( '.accordion-section' ),
|
|
|
|
overlay = section.closest( '.wp-full-overlay' ),
|
2015-03-28 16:47:30 -04:00
|
|
|
container = section.closest( '.wp-full-overlay-sidebar-content' ),
|
2015-02-24 15:31:24 -05:00
|
|
|
siblings = container.find( '.open' ),
|
2015-04-01 18:51:27 -04:00
|
|
|
customizeBtn = section.find( '.customize-theme' ),
|
|
|
|
changeBtn = section.find( '.change-theme' ),
|
2015-02-24 15:31:24 -05:00
|
|
|
content = section.find( '.control-panel-content' );
|
|
|
|
|
|
|
|
if ( expanded ) {
|
|
|
|
|
|
|
|
// Collapse any sibling sections/panels
|
|
|
|
api.section.each( function ( otherSection ) {
|
|
|
|
if ( otherSection !== panel ) {
|
|
|
|
otherSection.collapse( { duration: args.duration } );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
api.panel.each( function ( otherPanel ) {
|
2015-04-08 16:52:29 -04:00
|
|
|
otherPanel.collapse( { duration: 0 } );
|
2015-02-24 15:31:24 -05:00
|
|
|
});
|
|
|
|
|
|
|
|
content.show( 0, function() {
|
|
|
|
position = content.offset().top;
|
|
|
|
scroll = container.scrollTop();
|
2015-03-29 07:17:28 -04:00
|
|
|
content.css( 'margin-top', ( $( '#customize-header-actions' ).height() - position - scroll ) );
|
2015-02-24 15:31:24 -05:00
|
|
|
section.addClass( 'current-panel' );
|
|
|
|
overlay.addClass( 'in-themes-panel' );
|
|
|
|
container.scrollTop( 0 );
|
2015-04-08 16:52:29 -04:00
|
|
|
_.delay( panel.renderScreenshots, 10 ); // Wait for the controls
|
|
|
|
panel.$customizeSidebar.on( 'scroll.customize-themes-section', _.throttle( panel.renderScreenshots, 300 ) );
|
2015-02-24 15:31:24 -05:00
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
|
|
|
} );
|
2015-04-01 18:51:27 -04:00
|
|
|
customizeBtn.focus();
|
2015-02-24 15:31:24 -05:00
|
|
|
} else {
|
|
|
|
siblings.removeClass( 'open' );
|
|
|
|
section.removeClass( 'current-panel' );
|
|
|
|
overlay.removeClass( 'in-themes-panel' );
|
2015-04-08 16:52:29 -04:00
|
|
|
panel.$customizeSidebar.off( 'scroll.customize-themes-section' );
|
2015-02-24 15:31:24 -05:00
|
|
|
content.delay( 180 ).hide( 0, function() {
|
|
|
|
content.css( 'margin-top', 'inherit' ); // Reset
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
|
|
|
} );
|
2015-04-08 15:03:25 -04:00
|
|
|
customizeBtn.attr( 'tabindex', '0' );
|
2015-04-01 18:51:27 -04:00
|
|
|
changeBtn.focus();
|
2015-02-24 15:31:24 -05:00
|
|
|
container.scrollTop( 0 );
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2015-10-17 18:41:25 -04:00
|
|
|
/**
|
|
|
|
* Recalculate the top margin.
|
|
|
|
*
|
|
|
|
* @since 4.4.0
|
|
|
|
* @private
|
|
|
|
*/
|
|
|
|
_recalculateTopMargin: function() {
|
|
|
|
api.Panel.prototype._recalculateTopMargin.call( this );
|
|
|
|
},
|
|
|
|
|
2015-04-08 16:52:29 -04:00
|
|
|
/**
|
|
|
|
* Render control's screenshot if the control comes into view.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
renderScreenshots: function( ) {
|
|
|
|
var section = this;
|
|
|
|
|
|
|
|
// Fill queue initially.
|
|
|
|
if ( section.screenshotQueue === null ) {
|
|
|
|
section.screenshotQueue = section.controls();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Are all screenshots rendered?
|
|
|
|
if ( ! section.screenshotQueue.length ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
section.screenshotQueue = _.filter( section.screenshotQueue, function( control ) {
|
|
|
|
var $imageWrapper = control.container.find( '.theme-screenshot' ),
|
|
|
|
$image = $imageWrapper.find( 'img' );
|
|
|
|
|
|
|
|
if ( ! $image.length ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( $image.is( ':hidden' ) ) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Based on unveil.js.
|
|
|
|
var wt = section.$window.scrollTop(),
|
|
|
|
wb = wt + section.$window.height(),
|
|
|
|
et = $image.offset().top,
|
|
|
|
ih = $imageWrapper.height(),
|
|
|
|
eb = et + ih,
|
|
|
|
threshold = ih * 3,
|
|
|
|
inView = eb >= wt - threshold && et <= wb + threshold;
|
|
|
|
|
|
|
|
if ( inView ) {
|
|
|
|
control.container.trigger( 'render-screenshot' );
|
|
|
|
}
|
|
|
|
|
|
|
|
// If the image is in view return false so it's cleared from the queue.
|
|
|
|
return ! inView;
|
|
|
|
} );
|
|
|
|
},
|
|
|
|
|
2015-02-24 15:31:24 -05:00
|
|
|
/**
|
|
|
|
* Advance the modal to the next theme.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
nextTheme: function () {
|
|
|
|
var section = this;
|
|
|
|
if ( section.getNextTheme() ) {
|
|
|
|
section.showDetails( section.getNextTheme(), function() {
|
|
|
|
section.overlay.find( '.right' ).focus();
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the next theme model.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
getNextTheme: function () {
|
|
|
|
var control, next;
|
|
|
|
control = api.control( 'theme_' + this.currentTheme );
|
|
|
|
next = control.container.next( 'li.customize-control-theme' );
|
|
|
|
if ( ! next.length ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
next = next[0].id.replace( 'customize-control-', '' );
|
|
|
|
control = api.control( next );
|
|
|
|
|
|
|
|
return control.params.theme;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Advance the modal to the previous theme.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
previousTheme: function () {
|
|
|
|
var section = this;
|
|
|
|
if ( section.getPreviousTheme() ) {
|
|
|
|
section.showDetails( section.getPreviousTheme(), function() {
|
|
|
|
section.overlay.find( '.left' ).focus();
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the previous theme model.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
getPreviousTheme: function () {
|
|
|
|
var control, previous;
|
|
|
|
control = api.control( 'theme_' + this.currentTheme );
|
|
|
|
previous = control.container.prev( 'li.customize-control-theme' );
|
|
|
|
if ( ! previous.length ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
previous = previous[0].id.replace( 'customize-control-', '' );
|
|
|
|
control = api.control( previous );
|
|
|
|
|
|
|
|
return control.params.theme;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Disable buttons when we're viewing the first or last theme.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
updateLimits: function () {
|
|
|
|
if ( ! this.getNextTheme() ) {
|
|
|
|
this.overlay.find( '.right' ).addClass( 'disabled' );
|
|
|
|
}
|
|
|
|
if ( ! this.getPreviousTheme() ) {
|
|
|
|
this.overlay.find( '.left' ).addClass( 'disabled' );
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Render & show the theme details for a given theme model.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*
|
|
|
|
* @param {Object} theme
|
|
|
|
*/
|
|
|
|
showDetails: function ( theme, callback ) {
|
|
|
|
var section = this;
|
|
|
|
callback = callback || function(){};
|
|
|
|
section.currentTheme = theme.id;
|
|
|
|
section.overlay.html( section.template( theme ) )
|
2015-04-08 16:52:29 -04:00
|
|
|
.fadeIn( 'fast' )
|
|
|
|
.focus();
|
2015-02-24 15:31:24 -05:00
|
|
|
$( 'body' ).addClass( 'modal-open' );
|
|
|
|
section.containFocus( section.overlay );
|
|
|
|
section.updateLimits();
|
|
|
|
callback();
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Close the theme details modal.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
2015-02-24 23:17:27 -05:00
|
|
|
closeDetails: function () {
|
2015-02-24 15:31:24 -05:00
|
|
|
$( 'body' ).removeClass( 'modal-open' );
|
|
|
|
this.overlay.fadeOut( 'fast' );
|
|
|
|
api.control( 'theme_' + this.currentTheme ).focus();
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Keep tab focus within the theme details modal.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
containFocus: function( el ) {
|
|
|
|
var tabbables;
|
|
|
|
|
|
|
|
el.on( 'keydown', function( event ) {
|
|
|
|
|
|
|
|
// Return if it's not the tab key
|
|
|
|
// When navigating with prev/next focus is already handled
|
|
|
|
if ( 9 !== event.keyCode ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// uses jQuery UI to get the tabbable elements
|
|
|
|
tabbables = $( ':tabbable', el );
|
|
|
|
|
|
|
|
// Keep focus within the overlay
|
|
|
|
if ( tabbables.last()[0] === event.target && ! event.shiftKey ) {
|
|
|
|
tabbables.first().focus();
|
|
|
|
return false;
|
|
|
|
} else if ( tabbables.first()[0] === event.target && event.shiftKey ) {
|
|
|
|
tabbables.last().focus();
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
2014-11-11 18:52:22 -05:00
|
|
|
* @class
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.Panel = Container.extend({
|
2015-05-29 20:03:30 -04:00
|
|
|
containerType: 'panel',
|
|
|
|
|
2014-12-03 21:04:22 -05:00
|
|
|
/**
|
|
|
|
* @since 4.1.0
|
|
|
|
*
|
2015-06-01 18:47:25 -04:00
|
|
|
* @param {string} id - The ID for the panel.
|
|
|
|
* @param {object} options - Object containing one property: params.
|
|
|
|
* @param {object} options.params - Object containing the following properties.
|
|
|
|
* @param {string} options.params.title - Title shown when panel is collapsed and expanded.
|
|
|
|
* @param {string=} [options.params.description] - Description shown at the top of the panel.
|
|
|
|
* @param {number=100} [options.params.priority] - The sort priority for the panel.
|
|
|
|
* @param {string=default} [options.params.type] - The type of the panel. See wp.customize.panelConstructor.
|
|
|
|
* @param {string=} [options.params.content] - The markup to be used for the panel container. If empty, a JS template is used.
|
|
|
|
* @param {boolean=true} [options.params.active] - Whether the panel is active or not.
|
2014-12-03 21:04:22 -05:00
|
|
|
*/
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
initialize: function ( id, options ) {
|
|
|
|
var panel = this;
|
|
|
|
Container.prototype.initialize.call( panel, id, options );
|
|
|
|
panel.embed();
|
2014-12-02 17:56:45 -05:00
|
|
|
panel.deferred.embedded.done( function () {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
panel.ready();
|
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Embed the container in the DOM when any parent panel is ready.
|
2014-12-03 21:04:22 -05:00
|
|
|
*
|
|
|
|
* @since 4.1.0
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
embed: function () {
|
|
|
|
var panel = this,
|
|
|
|
parentContainer = $( '#customize-theme-controls > ul' ); // @todo This should be defined elsewhere, and to be configurable
|
|
|
|
|
|
|
|
if ( ! panel.container.parent().is( parentContainer ) ) {
|
|
|
|
parentContainer.append( panel.container );
|
2015-05-29 20:03:30 -04:00
|
|
|
panel.renderContent();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2015-10-16 19:48:25 -04:00
|
|
|
|
|
|
|
api.bind( 'pane-contents-reflowed', _.debounce( function() {
|
|
|
|
panel._recalculateTopMargin();
|
|
|
|
}, 100 ) );
|
|
|
|
|
2014-12-02 17:56:45 -05:00
|
|
|
panel.deferred.embedded.resolve();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
attachEvents: function () {
|
|
|
|
var meta, panel = this;
|
|
|
|
|
|
|
|
// Expand/Collapse accordion sections on click.
|
|
|
|
panel.container.find( '.accordion-section-title' ).on( 'click keydown', function( event ) {
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
if ( ! panel.expanded() ) {
|
|
|
|
panel.expand();
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2015-05-29 09:57:26 -04:00
|
|
|
// Close panel.
|
|
|
|
panel.container.find( '.customize-panel-back' ).on( 'click keydown', function( event ) {
|
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
if ( panel.expanded() ) {
|
|
|
|
panel.collapse();
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
meta = panel.container.find( '.panel-meta:first' );
|
|
|
|
|
2015-05-29 09:57:26 -04:00
|
|
|
meta.find( '> .accordion-section-title .customize-help-toggle' ).on( 'click keydown', function( event ) {
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
2015-05-29 20:03:30 -04:00
|
|
|
meta = panel.container.find( '.panel-meta' );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( meta.hasClass( 'cannot-expand' ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-05-29 09:57:26 -04:00
|
|
|
var content = meta.find( '.customize-panel-description:first' );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( meta.hasClass( 'open' ) ) {
|
|
|
|
meta.toggleClass( 'open' );
|
|
|
|
content.slideUp( panel.defaultExpandedArguments.duration );
|
2015-05-29 09:57:26 -04:00
|
|
|
$( this ).attr( 'aria-expanded', false );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
} else {
|
|
|
|
content.slideDown( panel.defaultExpandedArguments.duration );
|
|
|
|
meta.toggleClass( 'open' );
|
2015-05-29 09:57:26 -04:00
|
|
|
$( this ).attr( 'aria-expanded', true );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the sections that are associated with this panel, sorted by their priority Value.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @returns {Array}
|
|
|
|
*/
|
|
|
|
sections: function () {
|
|
|
|
return this._children( 'panel', 'section' );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return whether this panel has any active sections.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @returns {boolean}
|
|
|
|
*/
|
|
|
|
isContextuallyActive: function () {
|
|
|
|
var panel = this,
|
|
|
|
sections = panel.sections(),
|
|
|
|
activeCount = 0;
|
|
|
|
_( sections ).each( function ( section ) {
|
|
|
|
if ( section.active() && section.isContextuallyActive() ) {
|
|
|
|
activeCount += 1;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
return ( activeCount !== 0 );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update UI to reflect expanded state
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
|
|
|
* @param {Boolean} expanded
|
|
|
|
* @param {Object} args
|
|
|
|
* @param {Boolean} args.unchanged
|
2015-10-16 19:48:25 -04:00
|
|
|
* @param {Function} args.completeCallback
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
onChangeExpanded: function ( expanded, args ) {
|
|
|
|
|
|
|
|
// Immediately call the complete callback if there were no changes
|
|
|
|
if ( args.unchanged ) {
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Note: there is a second argument 'args' passed
|
|
|
|
var position, scroll,
|
|
|
|
panel = this,
|
2015-10-16 19:48:25 -04:00
|
|
|
accordionSection = panel.container.closest( '.accordion-section' ),
|
|
|
|
overlay = accordionSection.closest( '.wp-full-overlay' ),
|
|
|
|
container = accordionSection.closest( '.wp-full-overlay-sidebar-content' ),
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
siblings = container.find( '.open' ),
|
2015-05-29 09:57:26 -04:00
|
|
|
topPanel = overlay.find( '#customize-theme-controls > ul > .accordion-section > .accordion-section-title' ),
|
2015-10-16 19:48:25 -04:00
|
|
|
backBtn = accordionSection.find( '.customize-panel-back' ),
|
|
|
|
panelTitle = accordionSection.find( '.accordion-section-title' ).first(),
|
|
|
|
content = accordionSection.find( '.control-panel-content' ),
|
2015-08-11 19:56:25 -04:00
|
|
|
headerActionsHeight = $( '#customize-header-actions' ).height();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
if ( expanded ) {
|
|
|
|
|
|
|
|
// Collapse any sibling sections/panels
|
|
|
|
api.section.each( function ( section ) {
|
2015-08-31 19:08:42 -04:00
|
|
|
if ( panel.id !== section.panel() ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
section.collapse( { duration: 0 } );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
api.panel.each( function ( otherPanel ) {
|
|
|
|
if ( panel !== otherPanel ) {
|
|
|
|
otherPanel.collapse( { duration: 0 } );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
content.show( 0, function() {
|
2015-03-29 07:17:28 -04:00
|
|
|
content.parent().show();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
position = content.offset().top;
|
|
|
|
scroll = container.scrollTop();
|
2015-08-11 19:56:25 -04:00
|
|
|
content.css( 'margin-top', ( headerActionsHeight - position - scroll ) );
|
2015-10-16 19:48:25 -04:00
|
|
|
accordionSection.addClass( 'current-panel' );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
overlay.addClass( 'in-sub-panel' );
|
|
|
|
container.scrollTop( 0 );
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
2014-10-24 12:32:18 -04:00
|
|
|
} );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
topPanel.attr( 'tabindex', '-1' );
|
|
|
|
backBtn.attr( 'tabindex', '0' );
|
|
|
|
backBtn.focus();
|
2015-10-16 19:48:25 -04:00
|
|
|
panel._recalculateTopMargin();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
} else {
|
|
|
|
siblings.removeClass( 'open' );
|
2015-10-16 19:48:25 -04:00
|
|
|
accordionSection.removeClass( 'current-panel' );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
overlay.removeClass( 'in-sub-panel' );
|
|
|
|
content.delay( 180 ).hide( 0, function() {
|
|
|
|
content.css( 'margin-top', 'inherit' ); // Reset
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
topPanel.attr( 'tabindex', '0' );
|
|
|
|
backBtn.attr( 'tabindex', '-1' );
|
|
|
|
panelTitle.focus();
|
|
|
|
container.scrollTop( 0 );
|
|
|
|
}
|
2015-05-29 20:03:30 -04:00
|
|
|
},
|
|
|
|
|
2015-10-16 19:48:25 -04:00
|
|
|
/**
|
|
|
|
* Recalculate the top margin.
|
|
|
|
*
|
|
|
|
* @since 4.4.0
|
|
|
|
* @private
|
|
|
|
*/
|
|
|
|
_recalculateTopMargin: function() {
|
|
|
|
var panel = this, headerActionsHeight, content, accordionSection;
|
|
|
|
headerActionsHeight = $( '#customize-header-actions' ).height();
|
|
|
|
accordionSection = panel.container.closest( '.accordion-section' );
|
|
|
|
content = accordionSection.find( '.control-panel-content' );
|
|
|
|
content.css( 'margin-top', ( parseInt( content.css( 'margin-top' ), 10 ) - ( content.offset().top - headerActionsHeight ) ) );
|
|
|
|
},
|
|
|
|
|
2015-05-29 20:03:30 -04:00
|
|
|
/**
|
|
|
|
* Render the panel from its JS template, if it exists.
|
|
|
|
*
|
|
|
|
* The panel's container must already exist in the DOM.
|
|
|
|
*
|
|
|
|
* @since 4.3.0
|
|
|
|
*/
|
|
|
|
renderContent: function () {
|
|
|
|
var template,
|
|
|
|
panel = this;
|
|
|
|
|
|
|
|
// Add the content to the container.
|
|
|
|
if ( 0 !== $( '#tmpl-' + panel.templateSelector + '-content' ).length ) {
|
|
|
|
template = wp.template( panel.templateSelector + '-content' );
|
2015-06-01 18:47:25 -04:00
|
|
|
} else {
|
|
|
|
template = wp.template( 'customize-panel-default-content' );
|
|
|
|
}
|
|
|
|
if ( template && panel.container ) {
|
|
|
|
panel.container.find( '.accordion-sub-container' ).html( template( panel.params ) );
|
2015-05-29 20:03:30 -04:00
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
/**
|
2014-11-11 18:52:22 -05:00
|
|
|
* A Customizer Control.
|
|
|
|
*
|
|
|
|
* A control provides a UI element that allows a user to modify a Customizer Setting.
|
|
|
|
*
|
|
|
|
* @see PHP class WP_Customize_Control.
|
|
|
|
*
|
|
|
|
* @class
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @augments wp.customize.Class
|
2014-11-11 18:52:22 -05:00
|
|
|
*
|
2015-09-05 15:53:24 -04:00
|
|
|
* @param {string} id Unique identifier for the control instance.
|
|
|
|
* @param {object} options Options hash for the control instance.
|
2014-11-11 18:52:22 -05:00
|
|
|
* @param {object} options.params
|
2015-09-05 15:53:24 -04:00
|
|
|
* @param {object} options.params.type Type of control (e.g. text, radio, dropdown-pages, etc.)
|
|
|
|
* @param {string} options.params.content The HTML content for the control.
|
|
|
|
* @param {string} options.params.priority Order of priority to show the control within the section.
|
2014-11-11 18:52:22 -05:00
|
|
|
* @param {string} options.params.active
|
2015-09-05 15:53:24 -04:00
|
|
|
* @param {string} options.params.section The ID of the section the control belongs to.
|
|
|
|
* @param {string} options.params.settings.default The ID of the setting the control relates to.
|
|
|
|
* @param {string} options.params.settings.data
|
2014-11-11 18:52:22 -05:00
|
|
|
* @param {string} options.params.label
|
|
|
|
* @param {string} options.params.description
|
|
|
|
* @param {string} options.params.instanceNumber Order in which this instance was created in relation to other instances.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
api.Control = api.Class.extend({
|
2014-11-11 17:37:22 -05:00
|
|
|
defaultActiveArguments: { duration: 'fast', completeCallback: $.noop },
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
initialize: function( id, options ) {
|
|
|
|
var control = this,
|
|
|
|
nodes, radios, settings;
|
|
|
|
|
|
|
|
control.params = {};
|
|
|
|
$.extend( control, options || {} );
|
|
|
|
control.id = id;
|
|
|
|
control.selector = '#customize-control-' + id.replace( /\]/g, '' ).replace( /\[/g, '-' );
|
|
|
|
control.templateSelector = 'customize-control-' + control.params.type + '-content';
|
|
|
|
control.container = control.params.content ? $( control.params.content ) : $( control.selector );
|
|
|
|
|
|
|
|
control.deferred = {
|
2014-12-02 17:56:45 -05:00
|
|
|
embedded: new $.Deferred()
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
};
|
|
|
|
control.section = new api.Value();
|
|
|
|
control.priority = new api.Value();
|
|
|
|
control.active = new api.Value();
|
|
|
|
control.activeArgumentsQueue = [];
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
control.notifications = new api.Values({ defaultConstructor: api.Notification });
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
control.elements = [];
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
nodes = control.container.find('[data-customize-setting-link]');
|
2012-08-22 20:04:18 -04:00
|
|
|
radios = {};
|
|
|
|
|
|
|
|
nodes.each( function() {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
var node = $( this ),
|
2012-08-22 20:04:18 -04:00
|
|
|
name;
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( node.is( ':radio' ) ) {
|
|
|
|
name = node.prop( 'name' );
|
|
|
|
if ( radios[ name ] ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
return;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
radios[ name ] = true;
|
|
|
|
node = nodes.filter( '[name="' + name + '"]' );
|
|
|
|
}
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
api( node.data( 'customizeSettingLink' ), function( setting ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
var element = new api.Element( node );
|
|
|
|
control.elements.push( element );
|
|
|
|
element.sync( setting );
|
|
|
|
element.set( setting() );
|
|
|
|
});
|
|
|
|
});
|
2014-07-09 19:58:16 -04:00
|
|
|
|
|
|
|
control.active.bind( function ( active ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
var args = control.activeArgumentsQueue.shift();
|
|
|
|
args = $.extend( {}, control.defaultActiveArguments, args );
|
|
|
|
control.onChangeActive( active, args );
|
2014-07-09 19:58:16 -04:00
|
|
|
} );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
control.section.set( control.params.section );
|
|
|
|
control.priority.set( isNaN( control.params.priority ) ? 10 : control.params.priority );
|
|
|
|
control.active.set( control.params.active );
|
|
|
|
|
2014-12-02 17:56:45 -05:00
|
|
|
api.utils.bubbleChildValueChanges( control, [ 'section', 'priority', 'active' ] );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/*
|
|
|
|
* After all settings related to the control are available,
|
|
|
|
* make them available on the control and embed the control into the page.
|
|
|
|
*/
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
settings = $.map( control.params.settings, function( value ) {
|
|
|
|
return value;
|
|
|
|
});
|
|
|
|
|
2016-02-24 13:28:28 -05:00
|
|
|
if ( 0 === settings.length ) {
|
|
|
|
control.setting = null;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
control.settings = {};
|
2016-02-24 13:28:28 -05:00
|
|
|
control.embed();
|
|
|
|
} else {
|
|
|
|
api.apply( api, settings.concat( function() {
|
|
|
|
var key;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
2016-02-24 13:28:28 -05:00
|
|
|
control.settings = {};
|
|
|
|
for ( key in control.params.settings ) {
|
|
|
|
control.settings[ key ] = api( control.params.settings[ key ] );
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
2016-02-24 13:28:28 -05:00
|
|
|
control.setting = control.settings['default'] || null;
|
|
|
|
|
2016-06-14 15:17:28 -04:00
|
|
|
// Add setting notifications to the control notification.
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
_.each( control.settings, function( setting ) {
|
|
|
|
setting.notifications.bind( 'add', function( settingNotification ) {
|
2016-06-14 15:17:28 -04:00
|
|
|
var controlNotification, code, params;
|
|
|
|
code = setting.id + ':' + settingNotification.code;
|
|
|
|
params = _.extend(
|
|
|
|
{},
|
|
|
|
settingNotification,
|
|
|
|
{
|
|
|
|
setting: setting.id
|
|
|
|
}
|
|
|
|
);
|
|
|
|
controlNotification = new api.Notification( code, params );
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
control.notifications.add( controlNotification.code, controlNotification );
|
|
|
|
} );
|
|
|
|
setting.notifications.bind( 'remove', function( settingNotification ) {
|
|
|
|
control.notifications.remove( setting.id + ':' + settingNotification.code );
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
|
2016-02-24 13:28:28 -05:00
|
|
|
control.embed();
|
|
|
|
}) );
|
|
|
|
}
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
// After the control is embedded on the page, invoke the "ready" method.
|
2014-12-02 17:56:45 -05:00
|
|
|
control.deferred.embedded.done( function () {
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
/*
|
|
|
|
* Note that this debounced/deferred rendering is needed for two reasons:
|
|
|
|
* 1) The 'remove' event is triggered just _before_ the notification is actually removed.
|
|
|
|
* 2) Improve performance when adding/removing multiple notifications at a time.
|
|
|
|
*/
|
|
|
|
var debouncedRenderNotifications = _.debounce( function renderNotifications() {
|
|
|
|
control.renderNotifications();
|
|
|
|
} );
|
|
|
|
control.notifications.bind( 'add', function( notification ) {
|
|
|
|
wp.a11y.speak( notification.message, 'assertive' );
|
|
|
|
debouncedRenderNotifications();
|
|
|
|
} );
|
|
|
|
control.notifications.bind( 'remove', debouncedRenderNotifications );
|
|
|
|
control.renderNotifications();
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
control.ready();
|
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2014-11-11 18:52:22 -05:00
|
|
|
* Embed the control into the page.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
embed: function () {
|
|
|
|
var control = this,
|
|
|
|
inject;
|
|
|
|
|
|
|
|
// Watch for changes to the section state
|
|
|
|
inject = function ( sectionId ) {
|
|
|
|
var parentContainer;
|
2016-02-25 07:53:27 -05:00
|
|
|
if ( ! sectionId ) { // @todo allow a control to be embedded without a section, for instance a control embedded in the front end.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
// Wait for the section to be registered
|
|
|
|
api.section( sectionId, function ( section ) {
|
|
|
|
// Wait for the section to be ready/initialized
|
2014-12-02 17:56:45 -05:00
|
|
|
section.deferred.embedded.done( function () {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
parentContainer = section.container.find( 'ul:first' );
|
|
|
|
if ( ! control.container.parent().is( parentContainer ) ) {
|
|
|
|
parentContainer.append( control.container );
|
|
|
|
control.renderContent();
|
|
|
|
}
|
2014-12-02 17:56:45 -05:00
|
|
|
control.deferred.embedded.resolve();
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
});
|
|
|
|
});
|
|
|
|
};
|
|
|
|
control.section.bind( inject );
|
|
|
|
inject( control.section.get() );
|
2012-08-22 20:04:18 -04:00
|
|
|
},
|
|
|
|
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
2014-11-11 18:52:22 -05:00
|
|
|
* Triggered when the control's markup has been injected into the DOM.
|
|
|
|
*
|
2014-08-08 19:31:15 -04:00
|
|
|
* @abstract
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
ready: function() {},
|
|
|
|
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
/**
|
|
|
|
* Get the element inside of a control's container that contains the validation error message.
|
|
|
|
*
|
|
|
|
* Control subclasses may override this to return the proper container to render notifications into.
|
|
|
|
* Injects the notification container for existing controls that lack the necessary container,
|
|
|
|
* including special handling for nav menu items and widgets.
|
|
|
|
*
|
|
|
|
* @since 4.6.0
|
|
|
|
* @returns {jQuery} Setting validation message element.
|
|
|
|
* @this {wp.customize.Control}
|
|
|
|
*/
|
|
|
|
getNotificationsContainerElement: function() {
|
|
|
|
var control = this, controlTitle, notificationsContainer;
|
|
|
|
|
|
|
|
notificationsContainer = control.container.find( '.customize-control-notifications-container:first' );
|
|
|
|
if ( notificationsContainer.length ) {
|
|
|
|
return notificationsContainer;
|
|
|
|
}
|
|
|
|
|
|
|
|
notificationsContainer = $( '<div class="customize-control-notifications-container"></div>' );
|
|
|
|
|
|
|
|
if ( control.container.hasClass( 'customize-control-nav_menu_item' ) ) {
|
|
|
|
control.container.find( '.menu-item-settings:first' ).prepend( notificationsContainer );
|
|
|
|
} else if ( control.container.hasClass( 'customize-control-widget_form' ) ) {
|
|
|
|
control.container.find( '.widget-inside:first' ).prepend( notificationsContainer );
|
|
|
|
} else {
|
|
|
|
controlTitle = control.container.find( '.customize-control-title' );
|
|
|
|
if ( controlTitle.length ) {
|
|
|
|
controlTitle.after( notificationsContainer );
|
|
|
|
} else {
|
|
|
|
control.container.prepend( notificationsContainer );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return notificationsContainer;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Render notifications.
|
|
|
|
*
|
|
|
|
* Renders the `control.notifications` into the control's container.
|
|
|
|
* Control subclasses may override this method to do their own handling
|
|
|
|
* of rendering notifications.
|
|
|
|
*
|
|
|
|
* @since 4.6.0
|
|
|
|
* @this {wp.customize.Control}
|
|
|
|
*/
|
|
|
|
renderNotifications: function() {
|
|
|
|
var control = this, container, notifications, hasError = false;
|
|
|
|
container = control.getNotificationsContainerElement();
|
|
|
|
if ( ! container || ! container.length ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
notifications = [];
|
|
|
|
control.notifications.each( function( notification ) {
|
|
|
|
notifications.push( notification );
|
|
|
|
if ( 'error' === notification.type ) {
|
|
|
|
hasError = true;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
if ( 0 === notifications.length ) {
|
|
|
|
container.stop().slideUp( 'fast' );
|
|
|
|
} else {
|
|
|
|
container.stop().slideDown( 'fast', null, function() {
|
|
|
|
$( this ).css( 'height', 'auto' );
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( ! control.notificationsTemplate ) {
|
|
|
|
control.notificationsTemplate = wp.template( 'customize-control-notifications' );
|
|
|
|
}
|
|
|
|
|
|
|
|
control.container.toggleClass( 'has-notifications', 0 !== notifications.length );
|
|
|
|
control.container.toggleClass( 'has-error', hasError );
|
|
|
|
container.empty().append( $.trim(
|
|
|
|
control.notificationsTemplate( { notifications: notifications, altNotice: Boolean( control.altNotice ) } )
|
|
|
|
) );
|
|
|
|
},
|
|
|
|
|
2014-07-09 19:58:16 -04:00
|
|
|
/**
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* Normal controls do not expand, so just expand its parent
|
2014-07-09 19:58:16 -04:00
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {Object} [params]
|
|
|
|
*/
|
|
|
|
expand: function ( params ) {
|
|
|
|
api.section( this.section() ).expand( params );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* Bring the containing section and panel into view and then
|
|
|
|
* this control into view, focusing on the first input.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
focus: focus,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Update UI in response to a change in the control's active state.
|
|
|
|
* This does not change the active state, it merely handles the behavior
|
|
|
|
* for when it does change.
|
2014-07-09 19:58:16 -04:00
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
|
|
|
* @param {Boolean} active
|
|
|
|
* @param {Object} args
|
|
|
|
* @param {Number} args.duration
|
|
|
|
* @param {Callback} args.completeCallback
|
2014-07-09 19:58:16 -04:00
|
|
|
*/
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
onChangeActive: function ( active, args ) {
|
2015-08-26 03:26:21 -04:00
|
|
|
if ( args.unchanged ) {
|
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-09-25 15:54:50 -04:00
|
|
|
if ( ! $.contains( document, this.container[0] ) ) {
|
2014-11-11 17:37:22 -05:00
|
|
|
// jQuery.fn.slideUp is not hiding an element if it is not in the DOM
|
|
|
|
this.container.toggle( active );
|
2014-12-15 14:54:21 -05:00
|
|
|
if ( args.completeCallback ) {
|
|
|
|
args.completeCallback();
|
|
|
|
}
|
2014-11-11 17:37:22 -05:00
|
|
|
} else if ( active ) {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
this.container.slideDown( args.duration, args.completeCallback );
|
2014-07-09 19:58:16 -04:00
|
|
|
} else {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
this.container.slideUp( args.duration, args.completeCallback );
|
2014-07-09 19:58:16 -04:00
|
|
|
}
|
|
|
|
},
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* @deprecated 4.1.0 Use this.onChangeActive() instead.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
*/
|
|
|
|
toggle: function ( active ) {
|
|
|
|
return this.onChangeActive( active, this.defaultActiveArguments );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Shorthand way to enable the active state.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {Object} [params]
|
|
|
|
* @returns {Boolean} false if already active
|
|
|
|
*/
|
|
|
|
activate: Container.prototype.activate,
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Shorthand way to disable the active state.
|
|
|
|
*
|
2014-12-03 21:04:22 -05:00
|
|
|
* @since 4.1.0
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* @param {Object} [params]
|
|
|
|
* @returns {Boolean} false if already inactive
|
|
|
|
*/
|
|
|
|
deactivate: Container.prototype.deactivate,
|
|
|
|
|
2014-12-15 14:54:21 -05:00
|
|
|
/**
|
|
|
|
* Re-use _toggleActive from Container class.
|
|
|
|
*
|
|
|
|
* @access private
|
|
|
|
*/
|
|
|
|
_toggleActive: Container.prototype._toggleActive,
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
dropdownInit: function() {
|
2013-11-15 01:08:10 -05:00
|
|
|
var control = this,
|
|
|
|
statuses = this.container.find('.dropdown-status'),
|
|
|
|
params = this.params,
|
|
|
|
toggleFreeze = false,
|
|
|
|
update = function( to ) {
|
|
|
|
if ( typeof to === 'string' && params.statuses && params.statuses[ to ] )
|
2012-08-22 20:04:18 -04:00
|
|
|
statuses.html( params.statuses[ to ] ).show();
|
|
|
|
else
|
|
|
|
statuses.hide();
|
|
|
|
};
|
2012-11-09 00:44:00 -05:00
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
// Support the .dropdown class to open/close complex elements
|
2012-11-20 16:25:54 -05:00
|
|
|
this.container.on( 'click keydown', '.dropdown', function( event ) {
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
2012-11-20 16:25:54 -05:00
|
|
|
return;
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2012-11-20 16:25:54 -05:00
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
event.preventDefault();
|
2012-11-09 00:44:00 -05:00
|
|
|
|
2012-11-06 09:47:25 -05:00
|
|
|
if (!toggleFreeze)
|
|
|
|
control.container.toggleClass('open');
|
2012-11-09 00:44:00 -05:00
|
|
|
|
2012-11-09 15:57:09 -05:00
|
|
|
if ( control.container.hasClass('open') )
|
|
|
|
control.container.parent().parent().find('li.library-selected').focus();
|
|
|
|
|
2012-11-06 09:47:25 -05:00
|
|
|
// Don't want to fire focus and click at same time
|
|
|
|
toggleFreeze = true;
|
|
|
|
setTimeout(function () {
|
|
|
|
toggleFreeze = false;
|
|
|
|
}, 400);
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
this.setting.bind( update );
|
|
|
|
update( this.setting() );
|
2014-10-24 12:32:18 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Render the control from its JS template, if it exists.
|
|
|
|
*
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
* The control's container must already exist in the DOM.
|
2014-12-03 21:04:22 -05:00
|
|
|
*
|
|
|
|
* @since 4.1.0
|
2014-10-24 12:32:18 -04:00
|
|
|
*/
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
renderContent: function () {
|
2014-10-24 12:32:18 -04:00
|
|
|
var template,
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
control = this;
|
2014-10-26 08:06:19 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
// Replace the container element's content with the control.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( 0 !== $( '#tmpl-' + control.templateSelector ).length ) {
|
|
|
|
template = wp.template( control.templateSelector );
|
|
|
|
if ( template && control.container ) {
|
2014-11-11 18:52:22 -05:00
|
|
|
control.container.html( template( control.params ) );
|
2014-10-24 12:32:18 -04:00
|
|
|
}
|
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
2014-11-11 18:52:22 -05:00
|
|
|
* A colorpicker control.
|
|
|
|
*
|
|
|
|
* @class
|
2014-08-08 19:31:15 -04:00
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
api.ColorControl = api.Control.extend({
|
|
|
|
ready: function() {
|
|
|
|
var control = this,
|
2012-09-26 21:57:38 -04:00
|
|
|
picker = this.container.find('.color-picker-hex');
|
|
|
|
|
|
|
|
picker.val( control.setting() ).wpColorPicker({
|
2013-11-15 01:08:10 -05:00
|
|
|
change: function() {
|
2012-09-26 21:57:38 -04:00
|
|
|
control.setting.set( picker.wpColorPicker('color') );
|
2013-11-15 01:08:10 -05:00
|
|
|
},
|
|
|
|
clear: function() {
|
2015-09-07 01:48:23 -04:00
|
|
|
control.setting.set( '' );
|
2013-11-15 01:08:10 -05:00
|
|
|
}
|
2012-09-26 21:57:38 -04:00
|
|
|
});
|
2014-10-31 16:45:22 -04:00
|
|
|
|
|
|
|
this.setting.bind( function ( value ) {
|
|
|
|
picker.val( value );
|
|
|
|
picker.wpColorPicker( 'color', value );
|
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
2015-03-10 14:02:28 -04:00
|
|
|
* A control that implements the media modal.
|
2014-11-11 18:52:22 -05:00
|
|
|
*
|
|
|
|
* @class
|
2014-08-08 19:31:15 -04:00
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
2015-03-10 14:02:28 -04:00
|
|
|
api.MediaControl = api.Control.extend({
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* When the control's DOM structure is ready,
|
|
|
|
* set up internal event bindings.
|
|
|
|
*/
|
2014-12-02 17:56:45 -05:00
|
|
|
ready: function() {
|
2014-11-11 18:52:22 -05:00
|
|
|
var control = this;
|
|
|
|
// Shortcut so that we don't have to use _.bind every time we add a callback.
|
2015-03-07 06:06:29 -05:00
|
|
|
_.bindAll( control, 'restoreDefault', 'removeFile', 'openFrame', 'select', 'pausePlayer' );
|
2012-11-20 16:25:54 -05:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
// Bind events, with delegation to facilitate re-rendering.
|
|
|
|
control.container.on( 'click keydown', '.upload-button', control.openFrame );
|
2015-03-07 06:06:29 -05:00
|
|
|
control.container.on( 'click keydown', '.upload-button', control.pausePlayer );
|
2014-11-11 18:52:22 -05:00
|
|
|
control.container.on( 'click keydown', '.thumbnail-image img', control.openFrame );
|
|
|
|
control.container.on( 'click keydown', '.default-button', control.restoreDefault );
|
2015-03-07 06:06:29 -05:00
|
|
|
control.container.on( 'click keydown', '.remove-button', control.pausePlayer );
|
2014-11-11 18:52:22 -05:00
|
|
|
control.container.on( 'click keydown', '.remove-button', control.removeFile );
|
2015-03-07 06:06:29 -05:00
|
|
|
control.container.on( 'click keydown', '.remove-button', control.cleanupPlayer );
|
|
|
|
|
|
|
|
// Resize the player controls when it becomes visible (ie when section is expanded)
|
|
|
|
api.section( control.section() ).container
|
|
|
|
.on( 'expanded', function() {
|
|
|
|
if ( control.player ) {
|
|
|
|
control.player.setControlsSize();
|
|
|
|
}
|
|
|
|
})
|
|
|
|
.on( 'collapsed', function() {
|
|
|
|
control.pausePlayer();
|
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2016-06-14 15:28:27 -04:00
|
|
|
/**
|
|
|
|
* Set attachment data and render content.
|
|
|
|
*
|
|
|
|
* Note that BackgroundImage.prototype.ready applies this ready method
|
|
|
|
* to itself. Since BackgroundImage is an UploadControl, the value
|
|
|
|
* is the attachment URL instead of the attachment ID. In this case
|
|
|
|
* we skip fetching the attachment data because we have no ID available,
|
|
|
|
* and it is the responsibility of the UploadControl to set the control's
|
|
|
|
* attachmentData before calling the renderContent method.
|
|
|
|
*
|
|
|
|
* @param {number|string} value Attachment
|
|
|
|
*/
|
|
|
|
function setAttachmentDataAndRenderContent( value ) {
|
|
|
|
var hasAttachmentData = $.Deferred();
|
|
|
|
|
|
|
|
if ( control.extended( api.UploadControl ) ) {
|
|
|
|
hasAttachmentData.resolve();
|
|
|
|
} else {
|
|
|
|
value = parseInt( value, 10 );
|
|
|
|
if ( _.isNaN( value ) || value <= 0 ) {
|
|
|
|
delete control.params.attachment;
|
|
|
|
hasAttachmentData.resolve();
|
|
|
|
} else if ( control.params.attachment && control.params.attachment.id === value ) {
|
|
|
|
hasAttachmentData.resolve();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Fetch the attachment data.
|
|
|
|
if ( 'pending' === hasAttachmentData.state() ) {
|
|
|
|
wp.media.attachment( value ).fetch().done( function() {
|
|
|
|
control.params.attachment = this.attributes;
|
|
|
|
hasAttachmentData.resolve();
|
2016-03-04 18:47:26 -05:00
|
|
|
|
2016-06-14 15:28:27 -04:00
|
|
|
// Send attachment information to the preview for possible use in `postMessage` transport.
|
|
|
|
wp.customize.previewer.send( control.setting.id + '-attachment-data', this.attributes );
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
|
|
|
|
hasAttachmentData.done( function() {
|
|
|
|
control.renderContent();
|
2016-03-04 18:47:26 -05:00
|
|
|
} );
|
2016-06-14 15:28:27 -04:00
|
|
|
}
|
2016-03-04 18:47:26 -05:00
|
|
|
|
2016-06-14 15:28:27 -04:00
|
|
|
// Ensure attachment data is initially set (for dynamically-instantiated controls).
|
|
|
|
setAttachmentDataAndRenderContent( control.setting() );
|
|
|
|
|
|
|
|
// Update the attachment data and re-render the control when the setting changes.
|
|
|
|
control.setting.bind( setAttachmentDataAndRenderContent );
|
2012-08-22 20:04:18 -04:00
|
|
|
},
|
|
|
|
|
2015-03-07 06:06:29 -05:00
|
|
|
pausePlayer: function () {
|
|
|
|
this.player && this.player.pause();
|
|
|
|
},
|
|
|
|
|
|
|
|
cleanupPlayer: function () {
|
|
|
|
this.player && wp.media.mixin.removePlayer( this.player );
|
|
|
|
},
|
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* Open the media modal.
|
|
|
|
*/
|
|
|
|
openFrame: function( event ) {
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
2014-11-11 18:52:22 -05:00
|
|
|
return;
|
2014-12-02 17:56:45 -05:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
event.preventDefault();
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
if ( ! this.frame ) {
|
|
|
|
this.initFrame();
|
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
this.frame.open();
|
|
|
|
},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* Create a media modal select frame, and store it so the instance can be reused when needed.
|
|
|
|
*/
|
|
|
|
initFrame: function() {
|
|
|
|
this.frame = wp.media({
|
|
|
|
button: {
|
|
|
|
text: this.params.button_labels.frame_button
|
|
|
|
},
|
2014-12-15 15:27:22 -05:00
|
|
|
states: [
|
|
|
|
new wp.media.controller.Library({
|
|
|
|
title: this.params.button_labels.frame_title,
|
|
|
|
library: wp.media.query({ type: this.params.mime_type }),
|
|
|
|
multiple: false,
|
|
|
|
date: false
|
|
|
|
})
|
|
|
|
]
|
2014-12-02 17:56:45 -05:00
|
|
|
});
|
2012-11-09 00:44:00 -05:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
// When a file is selected, run a callback.
|
|
|
|
this.frame.on( 'select', this.select );
|
2014-12-02 17:56:45 -05:00
|
|
|
},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* Callback handler for when an attachment is selected in the media modal.
|
|
|
|
* Gets the selected image information, and sets it within the control.
|
|
|
|
*/
|
|
|
|
select: function() {
|
|
|
|
// Get the attachment from the modal frame.
|
2015-03-07 06:06:29 -05:00
|
|
|
var node,
|
|
|
|
attachment = this.frame.state().get( 'selection' ).first().toJSON(),
|
|
|
|
mejsSettings = window._wpmejsSettings || {};
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
this.params.attachment = attachment;
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
// Set the Customizer setting; the callback takes care of rendering.
|
2015-03-10 14:02:28 -04:00
|
|
|
this.setting( attachment.id );
|
2015-03-07 06:06:29 -05:00
|
|
|
node = this.container.find( 'audio, video' ).get(0);
|
|
|
|
|
|
|
|
// Initialize audio/video previews.
|
|
|
|
if ( node ) {
|
|
|
|
this.player = new MediaElementPlayer( node, mejsSettings );
|
|
|
|
} else {
|
|
|
|
this.cleanupPlayer();
|
|
|
|
}
|
2014-11-11 18:52:22 -05:00
|
|
|
},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* Reset the setting to the default value.
|
|
|
|
*/
|
|
|
|
restoreDefault: function( event ) {
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
2014-11-11 18:52:22 -05:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
event.preventDefault();
|
2012-11-06 09:47:25 -05:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
this.params.attachment = this.params.defaultAttachment;
|
|
|
|
this.setting( this.params.defaultAttachment.url );
|
2015-04-08 16:52:29 -04:00
|
|
|
},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* Called when the "Remove" link is clicked. Empties the setting.
|
|
|
|
*
|
|
|
|
* @param {object} event jQuery Event object
|
|
|
|
*/
|
|
|
|
removeFile: function( event ) {
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
2014-11-11 18:52:22 -05:00
|
|
|
return;
|
2014-12-02 17:56:45 -05:00
|
|
|
}
|
2014-11-11 18:52:22 -05:00
|
|
|
event.preventDefault();
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
this.params.attachment = {};
|
|
|
|
this.setting( '' );
|
|
|
|
this.renderContent(); // Not bound to setting change when emptying.
|
2015-03-10 14:02:28 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
/**
|
|
|
|
* An upload control, which utilizes the media modal.
|
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @augments wp.customize.MediaControl
|
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.UploadControl = api.MediaControl.extend({
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Callback handler for when an attachment is selected in the media modal.
|
|
|
|
* Gets the selected image information, and sets it within the control.
|
|
|
|
*/
|
|
|
|
select: function() {
|
|
|
|
// Get the attachment from the modal frame.
|
|
|
|
var node,
|
|
|
|
attachment = this.frame.state().get( 'selection' ).first().toJSON(),
|
|
|
|
mejsSettings = window._wpmejsSettings || {};
|
|
|
|
|
|
|
|
this.params.attachment = attachment;
|
|
|
|
|
|
|
|
// Set the Customizer setting; the callback takes care of rendering.
|
|
|
|
this.setting( attachment.url );
|
|
|
|
node = this.container.find( 'audio, video' ).get(0);
|
|
|
|
|
|
|
|
// Initialize audio/video previews.
|
|
|
|
if ( node ) {
|
|
|
|
this.player = new MediaElementPlayer( node, mejsSettings );
|
|
|
|
} else {
|
|
|
|
this.cleanupPlayer();
|
|
|
|
}
|
2014-12-02 17:56:45 -05:00
|
|
|
},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
// @deprecated
|
|
|
|
success: function() {},
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
// @deprecated
|
|
|
|
removerVisibility: function() {}
|
2014-12-02 17:56:45 -05:00
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* A control for uploading images.
|
|
|
|
*
|
|
|
|
* This control no longer needs to do anything more
|
|
|
|
* than what the upload control does in JS.
|
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @augments wp.customize.UploadControl
|
2015-03-10 14:02:28 -04:00
|
|
|
* @augments wp.customize.MediaControl
|
2014-11-11 18:52:22 -05:00
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.ImageControl = api.UploadControl.extend({
|
|
|
|
// @deprecated
|
|
|
|
thumbnailSrc: function() {}
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
2014-12-15 18:28:23 -05:00
|
|
|
/**
|
|
|
|
* A control for uploading background images.
|
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @augments wp.customize.UploadControl
|
2015-03-10 14:02:28 -04:00
|
|
|
* @augments wp.customize.MediaControl
|
2014-12-15 18:28:23 -05:00
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.BackgroundControl = api.UploadControl.extend({
|
|
|
|
|
|
|
|
/**
|
|
|
|
* When the control's DOM structure is ready,
|
|
|
|
* set up internal event bindings.
|
|
|
|
*/
|
|
|
|
ready: function() {
|
|
|
|
api.UploadControl.prototype.ready.apply( this, arguments );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Callback handler for when an attachment is selected in the media modal.
|
|
|
|
* Does an additional AJAX request for setting the background context.
|
|
|
|
*/
|
|
|
|
select: function() {
|
|
|
|
api.UploadControl.prototype.select.apply( this, arguments );
|
|
|
|
|
|
|
|
wp.ajax.post( 'custom-background-add', {
|
|
|
|
nonce: _wpCustomizeBackground.nonces.add,
|
|
|
|
wp_customize: 'on',
|
|
|
|
theme: api.settings.theme.stylesheet,
|
|
|
|
attachment_id: this.params.attachment.id
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2015-07-10 17:33:24 -04:00
|
|
|
/**
|
|
|
|
* A control for selecting and cropping an image.
|
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @augments wp.customize.MediaControl
|
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.CroppedImageControl = api.MediaControl.extend({
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Open the media modal to the library state.
|
|
|
|
*/
|
|
|
|
openFrame: function( event ) {
|
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
this.initFrame();
|
|
|
|
this.frame.setState( 'library' ).open();
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a media modal select frame, and store it so the instance can be reused when needed.
|
|
|
|
*/
|
|
|
|
initFrame: function() {
|
|
|
|
var l10n = _wpMediaViewsL10n;
|
|
|
|
|
|
|
|
this.frame = wp.media({
|
|
|
|
button: {
|
|
|
|
text: l10n.select,
|
|
|
|
close: false
|
|
|
|
},
|
|
|
|
states: [
|
|
|
|
new wp.media.controller.Library({
|
|
|
|
title: this.params.button_labels.frame_title,
|
|
|
|
library: wp.media.query({ type: 'image' }),
|
|
|
|
multiple: false,
|
|
|
|
date: false,
|
|
|
|
priority: 20,
|
|
|
|
suggestedWidth: this.params.width,
|
|
|
|
suggestedHeight: this.params.height
|
|
|
|
}),
|
2015-07-27 11:55:24 -04:00
|
|
|
new wp.media.controller.CustomizeImageCropper({
|
2015-07-10 17:33:24 -04:00
|
|
|
imgSelectOptions: this.calculateImageSelectOptions,
|
|
|
|
control: this
|
|
|
|
})
|
|
|
|
]
|
|
|
|
});
|
|
|
|
|
|
|
|
this.frame.on( 'select', this.onSelect, this );
|
|
|
|
this.frame.on( 'cropped', this.onCropped, this );
|
|
|
|
this.frame.on( 'skippedcrop', this.onSkippedCrop, this );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* After an image is selected in the media modal, switch to the cropper
|
|
|
|
* state if the image isn't the right size.
|
|
|
|
*/
|
|
|
|
onSelect: function() {
|
|
|
|
var attachment = this.frame.state().get( 'selection' ).first().toJSON();
|
|
|
|
|
|
|
|
if ( this.params.width === attachment.width && this.params.height === attachment.height && ! this.params.flex_width && ! this.params.flex_height ) {
|
|
|
|
this.setImageFromAttachment( attachment );
|
|
|
|
this.frame.close();
|
|
|
|
} else {
|
|
|
|
this.frame.setState( 'cropper' );
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* After the image has been cropped, apply the cropped image data to the setting.
|
|
|
|
*
|
|
|
|
* @param {object} croppedImage Cropped attachment data.
|
|
|
|
*/
|
|
|
|
onCropped: function( croppedImage ) {
|
|
|
|
this.setImageFromAttachment( croppedImage );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns a set of options, computed from the attached image data and
|
|
|
|
* control-specific data, to be fed to the imgAreaSelect plugin in
|
|
|
|
* wp.media.view.Cropper.
|
|
|
|
*
|
|
|
|
* @param {wp.media.model.Attachment} attachment
|
|
|
|
* @param {wp.media.controller.Cropper} controller
|
|
|
|
* @returns {Object} Options
|
|
|
|
*/
|
|
|
|
calculateImageSelectOptions: function( attachment, controller ) {
|
|
|
|
var control = controller.get( 'control' ),
|
|
|
|
flexWidth = !! parseInt( control.params.flex_width, 10 ),
|
|
|
|
flexHeight = !! parseInt( control.params.flex_height, 10 ),
|
|
|
|
realWidth = attachment.get( 'width' ),
|
|
|
|
realHeight = attachment.get( 'height' ),
|
|
|
|
xInit = parseInt( control.params.width, 10 ),
|
|
|
|
yInit = parseInt( control.params.height, 10 ),
|
|
|
|
ratio = xInit / yInit,
|
2016-04-07 21:23:29 -04:00
|
|
|
xImg = xInit,
|
|
|
|
yImg = yInit,
|
2015-07-20 15:02:24 -04:00
|
|
|
x1, y1, imgSelectOptions;
|
2015-07-10 17:33:24 -04:00
|
|
|
|
|
|
|
controller.set( 'canSkipCrop', ! control.mustBeCropped( flexWidth, flexHeight, xInit, yInit, realWidth, realHeight ) );
|
|
|
|
|
2016-04-07 21:23:29 -04:00
|
|
|
if ( realWidth / realHeight > ratio ) {
|
|
|
|
yInit = realHeight;
|
2015-07-10 17:33:24 -04:00
|
|
|
xInit = yInit * ratio;
|
|
|
|
} else {
|
2016-04-07 21:23:29 -04:00
|
|
|
xInit = realWidth;
|
2015-07-10 17:33:24 -04:00
|
|
|
yInit = xInit / ratio;
|
|
|
|
}
|
|
|
|
|
2016-04-07 21:23:29 -04:00
|
|
|
x1 = ( realWidth - xInit ) / 2;
|
|
|
|
y1 = ( realHeight - yInit ) / 2;
|
2015-07-20 15:02:24 -04:00
|
|
|
|
2015-07-10 17:33:24 -04:00
|
|
|
imgSelectOptions = {
|
|
|
|
handles: true,
|
|
|
|
keys: true,
|
|
|
|
instance: true,
|
|
|
|
persistent: true,
|
|
|
|
imageWidth: realWidth,
|
|
|
|
imageHeight: realHeight,
|
2016-04-07 21:23:29 -04:00
|
|
|
minWidth: xImg > xInit ? xInit : xImg,
|
|
|
|
minHeight: yImg > yInit ? yInit : yImg,
|
2015-07-20 15:02:24 -04:00
|
|
|
x1: x1,
|
|
|
|
y1: y1,
|
|
|
|
x2: xInit + x1,
|
|
|
|
y2: yInit + y1
|
2015-07-10 17:33:24 -04:00
|
|
|
};
|
|
|
|
|
|
|
|
if ( flexHeight === false && flexWidth === false ) {
|
|
|
|
imgSelectOptions.aspectRatio = xInit + ':' + yInit;
|
|
|
|
}
|
2016-04-07 21:23:29 -04:00
|
|
|
|
|
|
|
if ( true === flexHeight ) {
|
|
|
|
delete imgSelectOptions.minHeight;
|
|
|
|
imgSelectOptions.maxWidth = realWidth;
|
2015-07-10 17:33:24 -04:00
|
|
|
}
|
2016-04-07 21:23:29 -04:00
|
|
|
|
|
|
|
if ( true === flexWidth ) {
|
|
|
|
delete imgSelectOptions.minWidth;
|
|
|
|
imgSelectOptions.maxHeight = realHeight;
|
2015-07-10 17:33:24 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
return imgSelectOptions;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return whether the image must be cropped, based on required dimensions.
|
|
|
|
*
|
|
|
|
* @param {bool} flexW
|
|
|
|
* @param {bool} flexH
|
|
|
|
* @param {int} dstW
|
|
|
|
* @param {int} dstH
|
|
|
|
* @param {int} imgW
|
|
|
|
* @param {int} imgH
|
|
|
|
* @return {bool}
|
|
|
|
*/
|
|
|
|
mustBeCropped: function( flexW, flexH, dstW, dstH, imgW, imgH ) {
|
|
|
|
if ( true === flexW && true === flexH ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( true === flexW && dstH === imgH ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( true === flexH && dstW === imgW ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( dstW === imgW && dstH === imgH ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( imgW <= dstW ) {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* If cropping was skipped, apply the image data directly to the setting.
|
|
|
|
*/
|
|
|
|
onSkippedCrop: function() {
|
|
|
|
var attachment = this.frame.state().get( 'selection' ).first().toJSON();
|
|
|
|
this.setImageFromAttachment( attachment );
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Updates the setting and re-renders the control UI.
|
|
|
|
*
|
|
|
|
* @param {object} attachment
|
|
|
|
*/
|
|
|
|
setImageFromAttachment: function( attachment ) {
|
|
|
|
this.params.attachment = attachment;
|
|
|
|
|
|
|
|
// Set the Customizer setting; the callback takes care of rendering.
|
|
|
|
this.setting( attachment.id );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A control for selecting and cropping Site Icons.
|
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @augments wp.customize.CroppedImageControl
|
|
|
|
* @augments wp.customize.MediaControl
|
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.SiteIconControl = api.CroppedImageControl.extend({
|
2015-07-20 11:57:25 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a media modal select frame, and store it so the instance can be reused when needed.
|
|
|
|
*/
|
|
|
|
initFrame: function() {
|
|
|
|
var l10n = _wpMediaViewsL10n;
|
|
|
|
|
|
|
|
this.frame = wp.media({
|
|
|
|
button: {
|
|
|
|
text: l10n.select,
|
|
|
|
close: false
|
|
|
|
},
|
|
|
|
states: [
|
|
|
|
new wp.media.controller.Library({
|
|
|
|
title: this.params.button_labels.frame_title,
|
|
|
|
library: wp.media.query({ type: 'image' }),
|
|
|
|
multiple: false,
|
|
|
|
date: false,
|
|
|
|
priority: 20,
|
|
|
|
suggestedWidth: this.params.width,
|
|
|
|
suggestedHeight: this.params.height
|
|
|
|
}),
|
|
|
|
new wp.media.controller.SiteIconCropper({
|
|
|
|
imgSelectOptions: this.calculateImageSelectOptions,
|
|
|
|
control: this
|
|
|
|
})
|
|
|
|
]
|
|
|
|
});
|
|
|
|
|
|
|
|
this.frame.on( 'select', this.onSelect, this );
|
|
|
|
this.frame.on( 'cropped', this.onCropped, this );
|
|
|
|
this.frame.on( 'skippedcrop', this.onSkippedCrop, this );
|
|
|
|
},
|
|
|
|
|
2015-07-21 22:30:25 -04:00
|
|
|
/**
|
|
|
|
* After an image is selected in the media modal, switch to the cropper
|
|
|
|
* state if the image isn't the right size.
|
|
|
|
*/
|
|
|
|
onSelect: function() {
|
|
|
|
var attachment = this.frame.state().get( 'selection' ).first().toJSON(),
|
|
|
|
controller = this;
|
|
|
|
|
|
|
|
if ( this.params.width === attachment.width && this.params.height === attachment.height && ! this.params.flex_width && ! this.params.flex_height ) {
|
|
|
|
wp.ajax.post( 'crop-image', {
|
|
|
|
nonce: attachment.nonces.edit,
|
|
|
|
id: attachment.id,
|
|
|
|
context: 'site-icon',
|
|
|
|
cropDetails: {
|
|
|
|
x1: 0,
|
|
|
|
y1: 0,
|
|
|
|
width: this.params.width,
|
|
|
|
height: this.params.height,
|
|
|
|
dst_width: this.params.width,
|
|
|
|
dst_height: this.params.height
|
|
|
|
}
|
|
|
|
} ).done( function( croppedImage ) {
|
|
|
|
controller.setImageFromAttachment( croppedImage );
|
|
|
|
controller.frame.close();
|
|
|
|
} ).fail( function() {
|
2016-07-04 16:45:28 -04:00
|
|
|
controller.frame.trigger('content:error:crop');
|
2015-07-21 22:30:25 -04:00
|
|
|
} );
|
|
|
|
} else {
|
|
|
|
this.frame.setState( 'cropper' );
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2015-07-10 17:33:24 -04:00
|
|
|
/**
|
|
|
|
* Updates the setting and re-renders the control UI.
|
|
|
|
*
|
|
|
|
* @param {object} attachment
|
|
|
|
*/
|
|
|
|
setImageFromAttachment: function( attachment ) {
|
2015-09-11 16:13:25 -04:00
|
|
|
var sizes = [ 'site_icon-32', 'thumbnail', 'full' ],
|
|
|
|
icon;
|
|
|
|
|
|
|
|
_.each( sizes, function( size ) {
|
|
|
|
if ( ! icon && ! _.isUndefined ( attachment.sizes[ size ] ) ) {
|
|
|
|
icon = attachment.sizes[ size ];
|
|
|
|
}
|
|
|
|
} );
|
2015-07-10 17:33:24 -04:00
|
|
|
|
|
|
|
this.params.attachment = attachment;
|
|
|
|
|
|
|
|
// Set the Customizer setting; the callback takes care of rendering.
|
|
|
|
this.setting( attachment.id );
|
|
|
|
|
|
|
|
// Update the icon in-browser.
|
2015-07-21 22:30:25 -04:00
|
|
|
$( 'link[sizes="32x32"]' ).attr( 'href', icon.url );
|
2015-07-10 17:33:24 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Called when the "Remove" link is clicked. Empties the setting.
|
|
|
|
*
|
|
|
|
* @param {object} event jQuery Event object
|
|
|
|
*/
|
|
|
|
removeFile: function( event ) {
|
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
event.preventDefault();
|
|
|
|
|
|
|
|
this.params.attachment = {};
|
|
|
|
this.setting( '' );
|
|
|
|
this.renderContent(); // Not bound to setting change when emptying.
|
|
|
|
$( 'link[rel="icon"]' ).attr( 'href', '' );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
2014-11-11 18:52:22 -05:00
|
|
|
* @class
|
2014-08-08 19:31:15 -04:00
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
2014-03-11 00:13:16 -04:00
|
|
|
api.HeaderControl = api.Control.extend({
|
|
|
|
ready: function() {
|
2015-03-10 14:02:28 -04:00
|
|
|
this.btnRemove = $('#customize-control-header_image .actions .remove');
|
|
|
|
this.btnNew = $('#customize-control-header_image .actions .new');
|
2014-03-11 00:13:16 -04:00
|
|
|
|
|
|
|
_.bindAll(this, 'openMedia', 'removeImage');
|
|
|
|
|
|
|
|
this.btnNew.on( 'click', this.openMedia );
|
|
|
|
this.btnRemove.on( 'click', this.removeImage );
|
|
|
|
|
2015-04-08 18:28:27 -04:00
|
|
|
api.HeaderTool.currentHeader = this.getInitialHeaderImage();
|
2014-03-11 00:13:16 -04:00
|
|
|
|
|
|
|
new api.HeaderTool.CurrentView({
|
|
|
|
model: api.HeaderTool.currentHeader,
|
2014-12-02 16:55:23 -05:00
|
|
|
el: '#customize-control-header_image .current .container'
|
2014-03-11 00:13:16 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
new api.HeaderTool.ChoiceListView({
|
|
|
|
collection: api.HeaderTool.UploadsList = new api.HeaderTool.ChoiceList(),
|
2014-12-02 16:55:23 -05:00
|
|
|
el: '#customize-control-header_image .choices .uploaded .list'
|
2014-03-11 00:13:16 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
new api.HeaderTool.ChoiceListView({
|
|
|
|
collection: api.HeaderTool.DefaultsList = new api.HeaderTool.DefaultsList(),
|
2014-12-02 16:55:23 -05:00
|
|
|
el: '#customize-control-header_image .choices .default .list'
|
2014-03-11 00:13:16 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
api.HeaderTool.combinedList = api.HeaderTool.CombinedList = new api.HeaderTool.CombinedList([
|
|
|
|
api.HeaderTool.UploadsList,
|
|
|
|
api.HeaderTool.DefaultsList
|
|
|
|
]);
|
2016-03-05 20:45:27 -05:00
|
|
|
|
|
|
|
// Ensure custom-header-crop Ajax requests bootstrap the Customizer to activate the previewed theme.
|
|
|
|
wp.media.controller.Cropper.prototype.defaults.doCropArgs.wp_customize = 'on';
|
|
|
|
wp.media.controller.Cropper.prototype.defaults.doCropArgs.theme = api.settings.theme.stylesheet;
|
2014-03-11 00:13:16 -04:00
|
|
|
},
|
|
|
|
|
2015-04-08 18:28:27 -04:00
|
|
|
/**
|
|
|
|
* Returns a new instance of api.HeaderTool.ImageModel based on the currently
|
|
|
|
* saved header image (if any).
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*
|
|
|
|
* @returns {Object} Options
|
|
|
|
*/
|
|
|
|
getInitialHeaderImage: function() {
|
|
|
|
if ( ! api.get().header_image || ! api.get().header_image_data || _.contains( [ 'remove-header', 'random-default-image', 'random-uploaded-image' ], api.get().header_image ) ) {
|
|
|
|
return new api.HeaderTool.ImageModel();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Get the matching uploaded image object.
|
|
|
|
var currentHeaderObject = _.find( _wpCustomizeHeader.uploads, function( imageObj ) {
|
|
|
|
return ( imageObj.attachment_id === api.get().header_image_data.attachment_id );
|
|
|
|
} );
|
|
|
|
// Fall back to raw current header image.
|
|
|
|
if ( ! currentHeaderObject ) {
|
|
|
|
currentHeaderObject = {
|
|
|
|
url: api.get().header_image,
|
|
|
|
thumbnail_url: api.get().header_image,
|
|
|
|
attachment_id: api.get().header_image_data.attachment_id
|
|
|
|
};
|
|
|
|
}
|
|
|
|
|
|
|
|
return new api.HeaderTool.ImageModel({
|
|
|
|
header: currentHeaderObject,
|
|
|
|
choice: currentHeaderObject.url.split( '/' ).pop()
|
|
|
|
});
|
|
|
|
},
|
|
|
|
|
2014-03-11 00:13:16 -04:00
|
|
|
/**
|
|
|
|
* Returns a set of options, computed from the attached image data and
|
|
|
|
* theme-specific data, to be fed to the imgAreaSelect plugin in
|
|
|
|
* wp.media.view.Cropper.
|
|
|
|
*
|
|
|
|
* @param {wp.media.model.Attachment} attachment
|
|
|
|
* @param {wp.media.controller.Cropper} controller
|
|
|
|
* @returns {Object} Options
|
|
|
|
*/
|
|
|
|
calculateImageSelectOptions: function(attachment, controller) {
|
|
|
|
var xInit = parseInt(_wpCustomizeHeader.data.width, 10),
|
|
|
|
yInit = parseInt(_wpCustomizeHeader.data.height, 10),
|
|
|
|
flexWidth = !! parseInt(_wpCustomizeHeader.data['flex-width'], 10),
|
|
|
|
flexHeight = !! parseInt(_wpCustomizeHeader.data['flex-height'], 10),
|
|
|
|
ratio, xImg, yImg, realHeight, realWidth,
|
|
|
|
imgSelectOptions;
|
|
|
|
|
|
|
|
realWidth = attachment.get('width');
|
|
|
|
realHeight = attachment.get('height');
|
|
|
|
|
|
|
|
this.headerImage = new api.HeaderTool.ImageModel();
|
|
|
|
this.headerImage.set({
|
|
|
|
themeWidth: xInit,
|
|
|
|
themeHeight: yInit,
|
|
|
|
themeFlexWidth: flexWidth,
|
|
|
|
themeFlexHeight: flexHeight,
|
|
|
|
imageWidth: realWidth,
|
|
|
|
imageHeight: realHeight
|
|
|
|
});
|
|
|
|
|
|
|
|
controller.set( 'canSkipCrop', ! this.headerImage.shouldBeCropped() );
|
|
|
|
|
|
|
|
ratio = xInit / yInit;
|
|
|
|
xImg = realWidth;
|
|
|
|
yImg = realHeight;
|
|
|
|
|
|
|
|
if ( xImg / yImg > ratio ) {
|
|
|
|
yInit = yImg;
|
|
|
|
xInit = yInit * ratio;
|
|
|
|
} else {
|
|
|
|
xInit = xImg;
|
|
|
|
yInit = xInit / ratio;
|
|
|
|
}
|
|
|
|
|
|
|
|
imgSelectOptions = {
|
|
|
|
handles: true,
|
|
|
|
keys: true,
|
|
|
|
instance: true,
|
|
|
|
persistent: true,
|
|
|
|
imageWidth: realWidth,
|
|
|
|
imageHeight: realHeight,
|
|
|
|
x1: 0,
|
|
|
|
y1: 0,
|
|
|
|
x2: xInit,
|
|
|
|
y2: yInit
|
|
|
|
};
|
|
|
|
|
|
|
|
if (flexHeight === false && flexWidth === false) {
|
|
|
|
imgSelectOptions.aspectRatio = xInit + ':' + yInit;
|
|
|
|
}
|
|
|
|
if (flexHeight === false ) {
|
|
|
|
imgSelectOptions.maxHeight = yInit;
|
|
|
|
}
|
|
|
|
if (flexWidth === false ) {
|
|
|
|
imgSelectOptions.maxWidth = xInit;
|
|
|
|
}
|
|
|
|
|
|
|
|
return imgSelectOptions;
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets up and opens the Media Manager in order to select an image.
|
|
|
|
* Depending on both the size of the image and the properties of the
|
|
|
|
* current theme, a cropping step after selection may be required or
|
|
|
|
* skippable.
|
|
|
|
*
|
|
|
|
* @param {event} event
|
|
|
|
*/
|
|
|
|
openMedia: function(event) {
|
2014-04-07 21:55:15 -04:00
|
|
|
var l10n = _wpMediaViewsL10n;
|
2014-03-11 00:13:16 -04:00
|
|
|
|
|
|
|
event.preventDefault();
|
|
|
|
|
|
|
|
this.frame = wp.media({
|
|
|
|
button: {
|
|
|
|
text: l10n.selectAndCrop,
|
|
|
|
close: false
|
|
|
|
},
|
2014-04-07 21:57:16 -04:00
|
|
|
states: [
|
|
|
|
new wp.media.controller.Library({
|
|
|
|
title: l10n.chooseImage,
|
|
|
|
library: wp.media.query({ type: 'image' }),
|
|
|
|
multiple: false,
|
2014-12-15 15:27:22 -05:00
|
|
|
date: false,
|
2014-04-07 21:57:16 -04:00
|
|
|
priority: 20,
|
|
|
|
suggestedWidth: _wpCustomizeHeader.data.width,
|
|
|
|
suggestedHeight: _wpCustomizeHeader.data.height
|
|
|
|
}),
|
|
|
|
new wp.media.controller.Cropper({
|
|
|
|
imgSelectOptions: this.calculateImageSelectOptions
|
|
|
|
})
|
|
|
|
]
|
2014-03-11 00:13:16 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
this.frame.on('select', this.onSelect, this);
|
|
|
|
this.frame.on('cropped', this.onCropped, this);
|
|
|
|
this.frame.on('skippedcrop', this.onSkippedCrop, this);
|
|
|
|
|
|
|
|
this.frame.open();
|
|
|
|
},
|
|
|
|
|
2014-11-11 18:52:22 -05:00
|
|
|
/**
|
|
|
|
* After an image is selected in the media modal,
|
|
|
|
* switch to the cropper state.
|
|
|
|
*/
|
2014-03-11 00:13:16 -04:00
|
|
|
onSelect: function() {
|
|
|
|
this.frame.setState('cropper');
|
|
|
|
},
|
2014-11-11 18:52:22 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* After the image has been cropped, apply the cropped image data to the setting.
|
|
|
|
*
|
|
|
|
* @param {object} croppedImage Cropped attachment data.
|
|
|
|
*/
|
2014-03-11 00:13:16 -04:00
|
|
|
onCropped: function(croppedImage) {
|
2015-09-15 10:46:32 -04:00
|
|
|
var url = croppedImage.url,
|
2014-03-11 00:13:16 -04:00
|
|
|
attachmentId = croppedImage.attachment_id,
|
|
|
|
w = croppedImage.width,
|
|
|
|
h = croppedImage.height;
|
|
|
|
this.setImageFromURL(url, attachmentId, w, h);
|
|
|
|
},
|
2014-11-11 18:52:22 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* If cropping was skipped, apply the image data directly to the setting.
|
|
|
|
*
|
|
|
|
* @param {object} selection
|
|
|
|
*/
|
2014-03-11 00:13:16 -04:00
|
|
|
onSkippedCrop: function(selection) {
|
|
|
|
var url = selection.get('url'),
|
|
|
|
w = selection.get('width'),
|
|
|
|
h = selection.get('height');
|
|
|
|
this.setImageFromURL(url, selection.id, w, h);
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates a new wp.customize.HeaderTool.ImageModel from provided
|
|
|
|
* header image data and inserts it into the user-uploaded headers
|
|
|
|
* collection.
|
|
|
|
*
|
|
|
|
* @param {String} url
|
|
|
|
* @param {Number} attachmentId
|
|
|
|
* @param {Number} width
|
|
|
|
* @param {Number} height
|
|
|
|
*/
|
|
|
|
setImageFromURL: function(url, attachmentId, width, height) {
|
|
|
|
var choice, data = {};
|
|
|
|
|
|
|
|
data.url = url;
|
|
|
|
data.thumbnail_url = url;
|
2014-04-13 14:22:14 -04:00
|
|
|
data.timestamp = _.now();
|
2014-03-11 00:13:16 -04:00
|
|
|
|
|
|
|
if (attachmentId) {
|
|
|
|
data.attachment_id = attachmentId;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (width) {
|
|
|
|
data.width = width;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (height) {
|
|
|
|
data.height = height;
|
|
|
|
}
|
|
|
|
|
|
|
|
choice = new api.HeaderTool.ImageModel({
|
|
|
|
header: data,
|
|
|
|
choice: url.split('/').pop()
|
|
|
|
});
|
|
|
|
api.HeaderTool.UploadsList.add(choice);
|
|
|
|
api.HeaderTool.currentHeader.set(choice.toJSON());
|
|
|
|
choice.save();
|
|
|
|
choice.importImage();
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Triggers the necessary events to deselect an image which was set as
|
|
|
|
* the currently selected one.
|
|
|
|
*/
|
|
|
|
removeImage: function() {
|
|
|
|
api.HeaderTool.currentHeader.trigger('hide');
|
|
|
|
api.HeaderTool.CombinedList.trigger('control:removeImage');
|
|
|
|
}
|
|
|
|
|
|
|
|
});
|
|
|
|
|
2015-02-24 15:31:24 -05:00
|
|
|
/**
|
|
|
|
* wp.customize.ThemeControl
|
|
|
|
*
|
|
|
|
* @constructor
|
|
|
|
* @augments wp.customize.Control
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
*/
|
|
|
|
api.ThemeControl = api.Control.extend({
|
|
|
|
|
2015-03-27 18:54:29 -04:00
|
|
|
touchDrag: false,
|
2015-04-13 18:10:29 -04:00
|
|
|
isRendered: false,
|
2015-03-27 18:54:29 -04:00
|
|
|
|
2015-03-31 18:21:25 -04:00
|
|
|
/**
|
|
|
|
* Defer rendering the theme control until the section is displayed.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
renderContent: function () {
|
|
|
|
var control = this,
|
|
|
|
renderContentArgs = arguments;
|
|
|
|
|
2015-04-13 18:10:29 -04:00
|
|
|
api.section( control.section(), function( section ) {
|
2015-03-31 18:21:25 -04:00
|
|
|
if ( section.expanded() ) {
|
|
|
|
api.Control.prototype.renderContent.apply( control, renderContentArgs );
|
2015-04-13 18:10:29 -04:00
|
|
|
control.isRendered = true;
|
2015-03-31 18:21:25 -04:00
|
|
|
} else {
|
2015-04-13 18:10:29 -04:00
|
|
|
section.expanded.bind( function( expanded ) {
|
|
|
|
if ( expanded && ! control.isRendered ) {
|
2015-03-31 18:21:25 -04:00
|
|
|
api.Control.prototype.renderContent.apply( control, renderContentArgs );
|
2015-04-13 18:10:29 -04:00
|
|
|
control.isRendered = true;
|
2015-03-31 18:21:25 -04:00
|
|
|
}
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
},
|
|
|
|
|
2015-02-24 15:31:24 -05:00
|
|
|
/**
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
ready: function() {
|
|
|
|
var control = this;
|
|
|
|
|
2015-03-27 18:54:29 -04:00
|
|
|
control.container.on( 'touchmove', '.theme', function() {
|
|
|
|
control.touchDrag = true;
|
|
|
|
});
|
|
|
|
|
2015-02-24 15:31:24 -05:00
|
|
|
// Bind details view trigger.
|
2015-03-27 18:54:29 -04:00
|
|
|
control.container.on( 'click keydown touchend', '.theme', function( event ) {
|
2015-02-24 15:31:24 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-03-27 18:54:29 -04:00
|
|
|
// Bail if the user scrolled on a touch device.
|
|
|
|
if ( control.touchDrag === true ) {
|
|
|
|
return control.touchDrag = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Prevent the modal from showing when the user clicks the action button.
|
|
|
|
if ( $( event.target ).is( '.theme-actions .button' ) ) {
|
2015-02-24 15:31:24 -05:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-04-01 08:36:26 -04:00
|
|
|
var previewUrl = $( this ).data( 'previewUrl' );
|
|
|
|
|
|
|
|
$( '.wp-full-overlay' ).addClass( 'customize-loading' );
|
|
|
|
|
|
|
|
window.parent.location = previewUrl;
|
2015-02-24 15:31:24 -05:00
|
|
|
});
|
|
|
|
|
2015-04-01 08:36:26 -04:00
|
|
|
control.container.on( 'click keydown', '.theme-actions .theme-details', function( event ) {
|
2015-02-24 15:31:24 -05:00
|
|
|
if ( api.utils.isKeydownButNotEnterEvent( event ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-04-01 08:36:26 -04:00
|
|
|
event.preventDefault(); // Keep this AFTER the key filter above
|
|
|
|
|
|
|
|
api.section( control.section() ).showDetails( control.params.theme );
|
2015-02-24 15:31:24 -05:00
|
|
|
});
|
2015-04-08 16:52:29 -04:00
|
|
|
|
|
|
|
control.container.on( 'render-screenshot', function() {
|
|
|
|
var $screenshot = $( this ).find( 'img' ),
|
|
|
|
source = $screenshot.data( 'src' );
|
|
|
|
|
|
|
|
if ( source ) {
|
|
|
|
$screenshot.attr( 'src', source );
|
|
|
|
}
|
|
|
|
});
|
2015-02-24 15:31:24 -05:00
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Show or hide the theme based on the presence of the term in the title, description, and author.
|
|
|
|
*
|
|
|
|
* @since 4.2.0
|
|
|
|
*/
|
|
|
|
filter: function( term ) {
|
|
|
|
var control = this,
|
2015-04-08 16:52:29 -04:00
|
|
|
haystack = control.params.theme.name + ' ' +
|
|
|
|
control.params.theme.description + ' ' +
|
|
|
|
control.params.theme.tags + ' ' +
|
|
|
|
control.params.theme.author;
|
2015-02-24 15:31:24 -05:00
|
|
|
haystack = haystack.toLowerCase().replace( '-', ' ' );
|
|
|
|
if ( -1 !== haystack.search( term ) ) {
|
|
|
|
control.activate();
|
|
|
|
} else {
|
|
|
|
control.deactivate();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
// Change objects contained within the main customize object to Settings.
|
|
|
|
api.defaultConstructor = api.Setting;
|
|
|
|
|
2014-12-03 21:04:22 -05:00
|
|
|
// Create the collections for Controls, Sections and Panels.
|
2012-08-22 20:04:18 -04:00
|
|
|
api.control = new api.Values({ defaultConstructor: api.Control });
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
api.section = new api.Values({ defaultConstructor: api.Section });
|
|
|
|
api.panel = new api.Values({ defaultConstructor: api.Panel });
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
2015-09-05 15:53:24 -04:00
|
|
|
* An object that fetches a preview in the background of the document, which
|
|
|
|
* allows for seamless replacement of an existing preview.
|
|
|
|
*
|
2014-11-11 18:52:22 -05:00
|
|
|
* @class
|
2014-08-08 19:31:15 -04:00
|
|
|
* @augments wp.customize.Messenger
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
* @mixes wp.customize.Events
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
api.PreviewFrame = api.Messenger.extend({
|
|
|
|
sensitivity: 2000,
|
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/**
|
|
|
|
* Initialize the PreviewFrame.
|
|
|
|
*
|
|
|
|
* @param {object} params.container
|
|
|
|
* @param {object} params.signature
|
|
|
|
* @param {object} params.previewUrl
|
|
|
|
* @param {object} params.query
|
|
|
|
* @param {object} options
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
initialize: function( params, options ) {
|
2013-11-15 01:08:10 -05:00
|
|
|
var deferred = $.Deferred();
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/*
|
|
|
|
* Make the instance of the PreviewFrame the promise object
|
|
|
|
* so other objects can easily interact with it.
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
deferred.promise( this );
|
|
|
|
|
|
|
|
this.container = params.container;
|
|
|
|
this.signature = params.signature;
|
|
|
|
|
|
|
|
$.extend( params, { channel: api.PreviewFrame.uuid() });
|
|
|
|
|
|
|
|
api.Messenger.prototype.initialize.call( this, params, options );
|
|
|
|
|
|
|
|
this.add( 'previewUrl', params.previewUrl );
|
|
|
|
|
|
|
|
this.query = $.extend( params.query || {}, { customize_messenger_channel: this.channel() });
|
|
|
|
|
|
|
|
this.run( deferred );
|
|
|
|
},
|
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/**
|
|
|
|
* Run the preview request.
|
|
|
|
*
|
|
|
|
* @param {object} deferred jQuery Deferred object to be resolved with
|
|
|
|
* the request.
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
run: function( deferred ) {
|
|
|
|
var self = this,
|
|
|
|
loaded = false,
|
|
|
|
ready = false;
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( this._ready ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
this.unbind( 'ready', this._ready );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
this._ready = function() {
|
|
|
|
ready = true;
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( loaded ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
deferred.resolveWith( self );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
};
|
|
|
|
|
|
|
|
this.bind( 'ready', this._ready );
|
|
|
|
|
2014-07-09 19:58:16 -04:00
|
|
|
this.bind( 'ready', function ( data ) {
|
2015-03-10 11:56:26 -04:00
|
|
|
|
|
|
|
this.container.addClass( 'iframe-ready' );
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( ! data ) {
|
2014-07-09 19:58:16 -04:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2014-11-13 07:19:23 -05:00
|
|
|
/*
|
|
|
|
* Walk over all panels, sections, and controls and set their
|
|
|
|
* respective active states to true if the preview explicitly
|
|
|
|
* indicates as such.
|
|
|
|
*/
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
var constructs = {
|
|
|
|
panel: data.activePanels,
|
|
|
|
section: data.activeSections,
|
|
|
|
control: data.activeControls
|
|
|
|
};
|
2014-11-13 07:19:23 -05:00
|
|
|
_( constructs ).each( function ( activeConstructs, type ) {
|
|
|
|
api[ type ].each( function ( construct, id ) {
|
|
|
|
var active = !! ( activeConstructs && activeConstructs[ id ] );
|
2015-08-11 19:56:25 -04:00
|
|
|
if ( active ) {
|
|
|
|
construct.activate();
|
|
|
|
} else {
|
|
|
|
construct.deactivate();
|
|
|
|
}
|
2014-11-13 07:19:23 -05:00
|
|
|
} );
|
2014-07-09 19:58:16 -04:00
|
|
|
} );
|
2016-06-14 15:17:28 -04:00
|
|
|
|
|
|
|
if ( data.settingValidities ) {
|
|
|
|
api._handleSettingValidities( {
|
|
|
|
settingValidities: data.settingValidities,
|
|
|
|
focusInvalidControl: false
|
|
|
|
} );
|
|
|
|
}
|
2014-07-09 19:58:16 -04:00
|
|
|
} );
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
this.request = $.ajax( this.previewUrl(), {
|
|
|
|
type: 'POST',
|
|
|
|
data: this.query,
|
|
|
|
xhrFields: {
|
|
|
|
withCredentials: true
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
this.request.fail( function() {
|
|
|
|
deferred.rejectWith( self, [ 'request failure' ] );
|
|
|
|
});
|
|
|
|
|
|
|
|
this.request.done( function( response ) {
|
|
|
|
var location = self.request.getResponseHeader('Location'),
|
|
|
|
signature = self.signature,
|
|
|
|
index;
|
|
|
|
|
|
|
|
// Check if the location response header differs from the current URL.
|
|
|
|
// If so, the request was redirected; try loading the requested page.
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
if ( location && location !== self.previewUrl() ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
deferred.rejectWith( self, [ 'redirect', location ] );
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check if the user is not logged in.
|
|
|
|
if ( '0' === response ) {
|
|
|
|
self.login( deferred );
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check for cheaters.
|
|
|
|
if ( '-1' === response ) {
|
|
|
|
deferred.rejectWith( self, [ 'cheatin' ] );
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check for a signature in the request.
|
|
|
|
index = response.lastIndexOf( signature );
|
|
|
|
if ( -1 === index || index < response.lastIndexOf('</html>') ) {
|
|
|
|
deferred.rejectWith( self, [ 'unsigned' ] );
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Strip the signature from the request.
|
|
|
|
response = response.slice( 0, index ) + response.slice( index + signature.length );
|
|
|
|
|
|
|
|
// Create the iframe and inject the html content.
|
2015-03-10 17:20:26 -04:00
|
|
|
self.iframe = $( '<iframe />', { 'title': api.l10n.previewIframeTitle } ).appendTo( self.container );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
// Bind load event after the iframe has been added to the page;
|
|
|
|
// otherwise it will fire when injected into the DOM.
|
|
|
|
self.iframe.one( 'load', function() {
|
|
|
|
loaded = true;
|
|
|
|
|
|
|
|
if ( ready ) {
|
|
|
|
deferred.resolveWith( self );
|
|
|
|
} else {
|
|
|
|
setTimeout( function() {
|
|
|
|
deferred.rejectWith( self, [ 'ready timeout' ] );
|
|
|
|
}, self.sensitivity );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
self.targetWindow( self.iframe[0].contentWindow );
|
|
|
|
|
|
|
|
self.targetWindow().document.open();
|
|
|
|
self.targetWindow().document.write( response );
|
|
|
|
self.targetWindow().document.close();
|
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
login: function( deferred ) {
|
|
|
|
var self = this,
|
|
|
|
reject;
|
|
|
|
|
|
|
|
reject = function() {
|
|
|
|
deferred.rejectWith( self, [ 'logged out' ] );
|
|
|
|
};
|
|
|
|
|
2015-03-10 17:20:26 -04:00
|
|
|
if ( this.triedLogin ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
return reject();
|
2015-03-10 17:20:26 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
// Check if we have an admin cookie.
|
|
|
|
$.get( api.settings.url.ajax, {
|
|
|
|
action: 'logged-in'
|
|
|
|
}).fail( reject ).done( function( response ) {
|
|
|
|
var iframe;
|
|
|
|
|
2015-03-10 17:20:26 -04:00
|
|
|
if ( '1' !== response ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
reject();
|
2015-03-10 17:20:26 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-03-10 17:20:26 -04:00
|
|
|
iframe = $( '<iframe />', { 'src': self.previewUrl(), 'title': api.l10n.previewIframeTitle } ).hide();
|
2012-08-22 20:04:18 -04:00
|
|
|
iframe.appendTo( self.container );
|
2016-01-13 12:22:27 -05:00
|
|
|
iframe.on( 'load', function() {
|
2012-08-22 20:04:18 -04:00
|
|
|
self.triedLogin = true;
|
|
|
|
|
|
|
|
iframe.remove();
|
|
|
|
self.run( deferred );
|
|
|
|
});
|
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
destroy: function() {
|
|
|
|
api.Messenger.prototype.destroy.call( this );
|
|
|
|
this.request.abort();
|
|
|
|
|
|
|
|
if ( this.iframe )
|
|
|
|
this.iframe.remove();
|
|
|
|
|
|
|
|
delete this.request;
|
|
|
|
delete this.iframe;
|
|
|
|
delete this.targetWindow;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
(function(){
|
|
|
|
var uuid = 0;
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
|
|
|
* Create a universally unique identifier.
|
|
|
|
*
|
|
|
|
* @return {int}
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
api.PreviewFrame.uuid = function() {
|
|
|
|
return 'preview-' + uuid++;
|
|
|
|
};
|
|
|
|
}());
|
|
|
|
|
2014-11-11 17:29:23 -05:00
|
|
|
/**
|
2014-12-03 21:04:22 -05:00
|
|
|
* Set the document title of the customizer.
|
|
|
|
*
|
|
|
|
* @since 4.1.0
|
2014-11-11 17:29:23 -05:00
|
|
|
*
|
|
|
|
* @param {string} documentTitle
|
|
|
|
*/
|
|
|
|
api.setDocumentTitle = function ( documentTitle ) {
|
|
|
|
var tmpl, title;
|
|
|
|
tmpl = api.settings.documentTitleTmpl;
|
|
|
|
title = tmpl.replace( '%s', documentTitle );
|
|
|
|
document.title = title;
|
2015-03-25 13:26:26 -04:00
|
|
|
api.trigger( 'title', title );
|
2014-11-11 17:29:23 -05:00
|
|
|
};
|
|
|
|
|
2014-08-08 19:31:15 -04:00
|
|
|
/**
|
2014-11-11 18:52:22 -05:00
|
|
|
* @class
|
2014-08-08 19:31:15 -04:00
|
|
|
* @augments wp.customize.Messenger
|
|
|
|
* @augments wp.customize.Class
|
|
|
|
* @mixes wp.customize.Events
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
api.Previewer = api.Messenger.extend({
|
|
|
|
refreshBuffer: 250,
|
|
|
|
|
|
|
|
/**
|
2015-09-05 15:53:24 -04:00
|
|
|
* @param {array} params.allowedUrls
|
|
|
|
* @param {string} params.container A selector or jQuery element for the preview
|
|
|
|
* frame to be placed.
|
|
|
|
* @param {string} params.form
|
|
|
|
* @param {string} params.previewUrl The URL to preview.
|
|
|
|
* @param {string} params.signature
|
|
|
|
* @param {object} options
|
2012-08-22 20:04:18 -04:00
|
|
|
*/
|
|
|
|
initialize: function( params, options ) {
|
|
|
|
var self = this,
|
2013-11-15 01:08:10 -05:00
|
|
|
rscheme = /^https?/;
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
$.extend( this, options || {} );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
this.deferred = {
|
|
|
|
active: $.Deferred()
|
|
|
|
};
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Wrap this.refresh to prevent it from hammering the servers:
|
|
|
|
*
|
|
|
|
* If refresh is called once and no other refresh requests are
|
|
|
|
* loading, trigger the request immediately.
|
|
|
|
*
|
|
|
|
* If refresh is called while another refresh request is loading,
|
|
|
|
* debounce the refresh requests:
|
|
|
|
* 1. Stop the loading request (as it is instantly outdated).
|
|
|
|
* 2. Trigger the new request once refresh hasn't been called for
|
|
|
|
* self.refreshBuffer milliseconds.
|
|
|
|
*/
|
|
|
|
this.refresh = (function( self ) {
|
|
|
|
var refresh = self.refresh,
|
|
|
|
callback = function() {
|
|
|
|
timeout = null;
|
|
|
|
refresh.call( self );
|
|
|
|
},
|
|
|
|
timeout;
|
|
|
|
|
|
|
|
return function() {
|
|
|
|
if ( typeof timeout !== 'number' ) {
|
|
|
|
if ( self.loading ) {
|
|
|
|
self.abort();
|
|
|
|
} else {
|
|
|
|
return callback();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
clearTimeout( timeout );
|
|
|
|
timeout = setTimeout( callback, self.refreshBuffer );
|
|
|
|
};
|
|
|
|
})( this );
|
|
|
|
|
|
|
|
this.container = api.ensure( params.container );
|
|
|
|
this.allowedUrls = params.allowedUrls;
|
|
|
|
this.signature = params.signature;
|
|
|
|
|
|
|
|
params.url = window.location.href;
|
|
|
|
|
|
|
|
api.Messenger.prototype.initialize.call( this, params );
|
|
|
|
|
|
|
|
this.add( 'scheme', this.origin() ).link( this.origin ).setter( function( to ) {
|
|
|
|
var match = to.match( rscheme );
|
|
|
|
return match ? match[0] : '';
|
|
|
|
});
|
|
|
|
|
|
|
|
// Limit the URL to internal, front-end links.
|
|
|
|
//
|
2016-02-25 07:53:27 -05:00
|
|
|
// If the front end and the admin are served from the same domain, load the
|
2014-10-15 13:21:19 -04:00
|
|
|
// preview over ssl if the Customizer is being loaded over ssl. This avoids
|
2016-02-25 07:53:27 -05:00
|
|
|
// insecure content warnings. This is not attempted if the admin and front end
|
|
|
|
// are on different domains to avoid the case where the front end doesn't have
|
2012-08-22 20:04:18 -04:00
|
|
|
// ssl certs.
|
|
|
|
|
|
|
|
this.add( 'previewUrl', params.previewUrl ).setter( function( to ) {
|
|
|
|
var result;
|
|
|
|
|
|
|
|
// Check for URLs that include "/wp-admin/" or end in "/wp-admin".
|
|
|
|
// Strip hashes and query strings before testing.
|
2013-10-02 21:50:09 -04:00
|
|
|
if ( /\/wp-admin(\/|$)/.test( to.replace( /[#?].*$/, '' ) ) )
|
2012-08-22 20:04:18 -04:00
|
|
|
return null;
|
|
|
|
|
|
|
|
// Attempt to match the URL to the control frame's scheme
|
|
|
|
// and check if it's allowed. If not, try the original URL.
|
|
|
|
$.each([ to.replace( rscheme, self.scheme() ), to ], function( i, url ) {
|
|
|
|
$.each( self.allowedUrls, function( i, allowed ) {
|
2013-10-02 21:50:09 -04:00
|
|
|
var path;
|
|
|
|
|
|
|
|
allowed = allowed.replace( /\/+$/, '' );
|
|
|
|
path = url.replace( allowed, '' );
|
|
|
|
|
|
|
|
if ( 0 === url.indexOf( allowed ) && /^([/#?]|$)/.test( path ) ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
result = url;
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
});
|
|
|
|
if ( result )
|
|
|
|
return false;
|
|
|
|
});
|
|
|
|
|
|
|
|
// If we found a matching result, return it. If not, bail.
|
|
|
|
return result ? result : null;
|
|
|
|
});
|
|
|
|
|
|
|
|
// Refresh the preview when the URL is changed (but not yet).
|
|
|
|
this.previewUrl.bind( this.refresh );
|
|
|
|
|
|
|
|
this.scroll = 0;
|
|
|
|
this.bind( 'scroll', function( distance ) {
|
|
|
|
this.scroll = distance;
|
|
|
|
});
|
|
|
|
|
|
|
|
// Update the URL when the iframe sends a URL message.
|
|
|
|
this.bind( 'url', this.previewUrl );
|
2014-11-11 17:29:23 -05:00
|
|
|
|
2014-12-03 21:04:22 -05:00
|
|
|
// Update the document title when the preview changes.
|
2014-11-11 17:29:23 -05:00
|
|
|
this.bind( 'documentTitle', function ( title ) {
|
|
|
|
api.setDocumentTitle( title );
|
|
|
|
} );
|
2012-08-22 20:04:18 -04:00
|
|
|
},
|
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/**
|
|
|
|
* Query string data sent with each preview request.
|
|
|
|
*
|
|
|
|
* @abstract
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
query: function() {},
|
|
|
|
|
|
|
|
abort: function() {
|
|
|
|
if ( this.loading ) {
|
|
|
|
this.loading.destroy();
|
|
|
|
delete this.loading;
|
|
|
|
}
|
|
|
|
},
|
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/**
|
|
|
|
* Refresh the preview.
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
refresh: function() {
|
|
|
|
var self = this;
|
|
|
|
|
2015-03-10 11:56:26 -04:00
|
|
|
// Display loading indicator
|
|
|
|
this.send( 'loading-initiated' );
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
this.abort();
|
|
|
|
|
|
|
|
this.loading = new api.PreviewFrame({
|
|
|
|
url: this.url(),
|
|
|
|
previewUrl: this.previewUrl(),
|
|
|
|
query: this.query() || {},
|
|
|
|
container: this.container,
|
|
|
|
signature: this.signature
|
|
|
|
});
|
|
|
|
|
|
|
|
this.loading.done( function() {
|
|
|
|
// 'this' is the loading frame
|
|
|
|
this.bind( 'synced', function() {
|
|
|
|
if ( self.preview )
|
|
|
|
self.preview.destroy();
|
|
|
|
self.preview = this;
|
|
|
|
delete self.loading;
|
|
|
|
|
|
|
|
self.targetWindow( this.targetWindow() );
|
|
|
|
self.channel( this.channel() );
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
self.deferred.active.resolve();
|
2012-08-22 20:04:18 -04:00
|
|
|
self.send( 'active' );
|
|
|
|
});
|
|
|
|
|
|
|
|
this.send( 'sync', {
|
|
|
|
scroll: self.scroll,
|
|
|
|
settings: api.get()
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
|
|
|
this.loading.fail( function( reason, location ) {
|
2015-03-10 11:56:26 -04:00
|
|
|
self.send( 'loading-failed' );
|
|
|
|
if ( 'redirect' === reason && location ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
self.previewUrl( location );
|
2015-03-10 11:56:26 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
if ( 'logged out' === reason ) {
|
|
|
|
if ( self.preview ) {
|
|
|
|
self.preview.destroy();
|
|
|
|
delete self.preview;
|
|
|
|
}
|
|
|
|
|
|
|
|
self.login().done( self.refresh );
|
|
|
|
}
|
|
|
|
|
2015-03-10 11:56:26 -04:00
|
|
|
if ( 'cheatin' === reason ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
self.cheatin();
|
2015-03-10 11:56:26 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
login: function() {
|
|
|
|
var previewer = this,
|
|
|
|
deferred, messenger, iframe;
|
|
|
|
|
|
|
|
if ( this._login )
|
|
|
|
return this._login;
|
|
|
|
|
|
|
|
deferred = $.Deferred();
|
|
|
|
this._login = deferred.promise();
|
|
|
|
|
|
|
|
messenger = new api.Messenger({
|
|
|
|
channel: 'login',
|
|
|
|
url: api.settings.url.login
|
|
|
|
});
|
|
|
|
|
2015-03-10 17:20:26 -04:00
|
|
|
iframe = $( '<iframe />', { 'src': api.settings.url.login, 'title': api.l10n.loginIframeTitle } ).appendTo( this.container );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
messenger.targetWindow( iframe[0].contentWindow );
|
|
|
|
|
2015-04-06 11:10:27 -04:00
|
|
|
messenger.bind( 'login', function () {
|
|
|
|
var refreshNonces = previewer.refreshNonces();
|
|
|
|
|
|
|
|
refreshNonces.always( function() {
|
|
|
|
iframe.remove();
|
|
|
|
messenger.destroy();
|
|
|
|
delete previewer._login;
|
|
|
|
});
|
|
|
|
|
|
|
|
refreshNonces.done( function() {
|
|
|
|
deferred.resolve();
|
|
|
|
});
|
|
|
|
|
|
|
|
refreshNonces.fail( function() {
|
|
|
|
previewer.cheatin();
|
|
|
|
deferred.reject();
|
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
return this._login;
|
|
|
|
},
|
|
|
|
|
|
|
|
cheatin: function() {
|
2015-09-03 23:40:25 -04:00
|
|
|
$( document.body ).empty().addClass( 'cheatin' ).append(
|
|
|
|
'<h1>' + api.l10n.cheatin + '</h1>' +
|
|
|
|
'<p>' + api.l10n.notAllowed + '</p>'
|
|
|
|
);
|
2015-04-06 11:10:27 -04:00
|
|
|
},
|
|
|
|
|
|
|
|
refreshNonces: function() {
|
|
|
|
var request, deferred = $.Deferred();
|
|
|
|
|
|
|
|
deferred.promise();
|
|
|
|
|
|
|
|
request = wp.ajax.post( 'customize_refresh_nonces', {
|
|
|
|
wp_customize: 'on',
|
|
|
|
theme: api.settings.theme.stylesheet
|
|
|
|
});
|
|
|
|
|
|
|
|
request.done( function( response ) {
|
|
|
|
api.trigger( 'nonce-refresh', response );
|
|
|
|
deferred.resolve();
|
|
|
|
});
|
|
|
|
|
|
|
|
request.fail( function() {
|
|
|
|
deferred.reject();
|
|
|
|
});
|
|
|
|
|
|
|
|
return deferred;
|
2012-08-22 20:04:18 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
api.settingConstructor = {};
|
2012-08-22 20:04:18 -04:00
|
|
|
api.controlConstructor = {
|
2015-07-10 17:33:24 -04:00
|
|
|
color: api.ColorControl,
|
|
|
|
media: api.MediaControl,
|
|
|
|
upload: api.UploadControl,
|
|
|
|
image: api.ImageControl,
|
|
|
|
cropped_image: api.CroppedImageControl,
|
|
|
|
site_icon: api.SiteIconControl,
|
|
|
|
header: api.HeaderControl,
|
|
|
|
background: api.BackgroundControl,
|
|
|
|
theme: api.ThemeControl
|
2012-08-22 20:04:18 -04:00
|
|
|
};
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
api.panelConstructor = {};
|
2015-02-24 15:31:24 -05:00
|
|
|
api.sectionConstructor = {
|
|
|
|
themes: api.ThemesSection
|
|
|
|
};
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2016-06-26 10:26:29 -04:00
|
|
|
/**
|
|
|
|
* Handle setting_validities in an error response for the customize-save request.
|
|
|
|
*
|
|
|
|
* Add notifications to the settings and focus on the first control that has an invalid setting.
|
|
|
|
*
|
|
|
|
* @since 4.6.0
|
|
|
|
* @private
|
|
|
|
*
|
|
|
|
* @param {object} args
|
|
|
|
* @param {object} args.settingValidities
|
|
|
|
* @param {boolean} [args.focusInvalidControl=false]
|
|
|
|
* @returns {void}
|
|
|
|
*/
|
|
|
|
api._handleSettingValidities = function handleSettingValidities( args ) {
|
|
|
|
var invalidSettingControls, invalidSettings = [], wasFocused = false;
|
|
|
|
|
|
|
|
// Find the controls that correspond to each invalid setting.
|
|
|
|
_.each( args.settingValidities, function( validity, settingId ) {
|
|
|
|
var setting = api( settingId );
|
|
|
|
if ( setting ) {
|
|
|
|
|
|
|
|
// Add notifications for invalidities.
|
|
|
|
if ( _.isObject( validity ) ) {
|
|
|
|
_.each( validity, function( params, code ) {
|
|
|
|
var notification = new api.Notification( code, params ), existingNotification, needsReplacement = false;
|
|
|
|
|
|
|
|
// Remove existing notification if already exists for code but differs in parameters.
|
|
|
|
existingNotification = setting.notifications( notification.code );
|
|
|
|
if ( existingNotification ) {
|
|
|
|
needsReplacement = ( notification.type !== existingNotification.type ) || ! _.isEqual( notification.data, existingNotification.data );
|
|
|
|
}
|
|
|
|
if ( needsReplacement ) {
|
|
|
|
setting.notifications.remove( code );
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( ! setting.notifications.has( notification.code ) ) {
|
|
|
|
setting.notifications.add( code, notification );
|
|
|
|
}
|
|
|
|
invalidSettings.push( setting.id );
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
|
|
|
|
// Remove notification errors that are no longer valid.
|
|
|
|
setting.notifications.each( function( notification ) {
|
|
|
|
if ( 'error' === notification.type && ( true === validity || ! validity[ notification.code ] ) ) {
|
|
|
|
setting.notifications.remove( notification.code );
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
if ( args.focusInvalidControl ) {
|
|
|
|
invalidSettingControls = api.findControlsForSettings( invalidSettings );
|
|
|
|
|
|
|
|
// Focus on the first control that is inside of an expanded section (one that is visible).
|
|
|
|
_( _.values( invalidSettingControls ) ).find( function( controls ) {
|
|
|
|
return _( controls ).find( function( control ) {
|
|
|
|
var isExpanded = control.section() && api.section.has( control.section() ) && api.section( control.section() ).expanded();
|
|
|
|
if ( isExpanded && control.expanded ) {
|
|
|
|
isExpanded = control.expanded();
|
|
|
|
}
|
|
|
|
if ( isExpanded ) {
|
|
|
|
control.focus();
|
|
|
|
wasFocused = true;
|
|
|
|
}
|
|
|
|
return wasFocused;
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
|
|
|
|
// Focus on the first invalid control.
|
|
|
|
if ( ! wasFocused && ! _.isEmpty( invalidSettingControls ) ) {
|
|
|
|
_.values( invalidSettingControls )[0][0].focus();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Find all controls associated with the given settings.
|
|
|
|
*
|
|
|
|
* @since 4.6.0
|
|
|
|
* @param {string[]} settingIds Setting IDs.
|
|
|
|
* @returns {object<string, wp.customize.Control>} Mapping setting ids to arrays of controls.
|
|
|
|
*/
|
|
|
|
api.findControlsForSettings = function findControlsForSettings( settingIds ) {
|
|
|
|
var controls = {}, settingControls;
|
|
|
|
_.each( _.unique( settingIds ), function( settingId ) {
|
|
|
|
var setting = api( settingId );
|
|
|
|
if ( setting ) {
|
|
|
|
settingControls = setting.findControls();
|
|
|
|
if ( settingControls && settingControls.length > 0 ) {
|
|
|
|
controls[ settingId ] = settingControls;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
return controls;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sort panels, sections, controls by priorities. Hide empty sections and panels.
|
|
|
|
*
|
|
|
|
* @since 4.1.0
|
|
|
|
*/
|
|
|
|
api.reflowPaneContents = _.bind( function () {
|
|
|
|
|
|
|
|
var appendContainer, activeElement, rootContainers, rootNodes = [], wasReflowed = false;
|
|
|
|
|
|
|
|
if ( document.activeElement ) {
|
|
|
|
activeElement = $( document.activeElement );
|
|
|
|
}
|
|
|
|
|
|
|
|
// Sort the sections within each panel
|
|
|
|
api.panel.each( function ( panel ) {
|
|
|
|
var sections = panel.sections(),
|
|
|
|
sectionContainers = _.pluck( sections, 'container' );
|
|
|
|
rootNodes.push( panel );
|
|
|
|
appendContainer = panel.container.find( 'ul:first' );
|
|
|
|
if ( ! api.utils.areElementListsEqual( sectionContainers, appendContainer.children( '[id]' ) ) ) {
|
|
|
|
_( sections ).each( function ( section ) {
|
|
|
|
appendContainer.append( section.container );
|
|
|
|
} );
|
|
|
|
wasReflowed = true;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
// Sort the controls within each section
|
|
|
|
api.section.each( function ( section ) {
|
|
|
|
var controls = section.controls(),
|
|
|
|
controlContainers = _.pluck( controls, 'container' );
|
|
|
|
if ( ! section.panel() ) {
|
|
|
|
rootNodes.push( section );
|
|
|
|
}
|
|
|
|
appendContainer = section.container.find( 'ul:first' );
|
|
|
|
if ( ! api.utils.areElementListsEqual( controlContainers, appendContainer.children( '[id]' ) ) ) {
|
|
|
|
_( controls ).each( function ( control ) {
|
|
|
|
appendContainer.append( control.container );
|
|
|
|
} );
|
|
|
|
wasReflowed = true;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
// Sort the root panels and sections
|
|
|
|
rootNodes.sort( api.utils.prioritySort );
|
|
|
|
rootContainers = _.pluck( rootNodes, 'container' );
|
|
|
|
appendContainer = $( '#customize-theme-controls' ).children( 'ul' ); // @todo This should be defined elsewhere, and to be configurable
|
|
|
|
if ( ! api.utils.areElementListsEqual( rootContainers, appendContainer.children() ) ) {
|
|
|
|
_( rootNodes ).each( function ( rootNode ) {
|
|
|
|
appendContainer.append( rootNode.container );
|
|
|
|
} );
|
|
|
|
wasReflowed = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Now re-trigger the active Value callbacks to that the panels and sections can decide whether they can be rendered
|
|
|
|
api.panel.each( function ( panel ) {
|
|
|
|
var value = panel.active();
|
|
|
|
panel.active.callbacks.fireWith( panel.active, [ value, value ] );
|
|
|
|
} );
|
|
|
|
api.section.each( function ( section ) {
|
|
|
|
var value = section.active();
|
|
|
|
section.active.callbacks.fireWith( section.active, [ value, value ] );
|
|
|
|
} );
|
|
|
|
|
|
|
|
// Restore focus if there was a reflow and there was an active (focused) element
|
|
|
|
if ( wasReflowed && activeElement ) {
|
|
|
|
activeElement.focus();
|
|
|
|
}
|
|
|
|
api.trigger( 'pane-contents-reflowed' );
|
|
|
|
}, api );
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
$( function() {
|
|
|
|
api.settings = window._wpCustomizeSettings;
|
|
|
|
api.l10n = window._wpCustomizeControlsL10n;
|
|
|
|
|
2014-10-15 13:21:19 -04:00
|
|
|
// Check if we can run the Customizer.
|
2014-12-02 17:56:45 -05:00
|
|
|
if ( ! api.settings ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
return;
|
2014-12-02 17:56:45 -05:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-07-29 14:36:26 -04:00
|
|
|
// Bail if any incompatibilities are found.
|
|
|
|
if ( ! $.support.postMessage || ( ! $.support.cors && api.settings.isCrossDomain ) ) {
|
|
|
|
return;
|
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-07-09 16:58:15 -04:00
|
|
|
var parent, topFocus,
|
2013-11-15 01:08:10 -05:00
|
|
|
body = $( document.body ),
|
2014-07-08 13:04:15 -04:00
|
|
|
overlay = body.children( '.wp-full-overlay' ),
|
2015-05-29 09:57:26 -04:00
|
|
|
title = $( '#customize-info .panel-title.site-title' ),
|
2014-07-08 14:19:14 -04:00
|
|
|
closeBtn = $( '.customize-controls-close' ),
|
2016-02-15 20:57:26 -05:00
|
|
|
saveBtn = $( '#save' ),
|
|
|
|
footerActions = $( '#customize-footer-actions' );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-03-26 18:56:29 -04:00
|
|
|
// Prevent the form from saving when enter is pressed on an input or select element.
|
2012-08-22 20:04:18 -04:00
|
|
|
$('#customize-controls').on( 'keydown', function( e ) {
|
2014-03-26 18:56:29 -04:00
|
|
|
var isEnter = ( 13 === e.which ),
|
|
|
|
$el = $( e.target );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-03-26 18:56:29 -04:00
|
|
|
if ( isEnter && ( $el.is( 'input:not([type=button])' ) || $el.is( 'select' ) ) ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
e.preventDefault();
|
2014-03-26 18:56:29 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
2014-12-03 21:04:22 -05:00
|
|
|
// Expand/Collapse the main customizer customize info.
|
2016-04-17 11:41:27 -04:00
|
|
|
$( '.customize-info' ).find( '> .accordion-section-title .customize-help-toggle' ).on( 'click', function() {
|
2015-05-29 09:57:26 -04:00
|
|
|
var section = $( this ).closest( '.accordion-section' ),
|
|
|
|
content = section.find( '.customize-panel-description:first' );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
|
|
|
|
if ( section.hasClass( 'cannot-expand' ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( section.hasClass( 'open' ) ) {
|
|
|
|
section.toggleClass( 'open' );
|
|
|
|
content.slideUp( api.Panel.prototype.defaultExpandedArguments.duration );
|
2015-05-29 09:57:26 -04:00
|
|
|
$( this ).attr( 'aria-expanded', false );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
} else {
|
|
|
|
content.slideDown( api.Panel.prototype.defaultExpandedArguments.duration );
|
|
|
|
section.toggleClass( 'open' );
|
2015-05-29 09:57:26 -04:00
|
|
|
$( this ).attr( 'aria-expanded', true );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
// Initialize Previewer
|
2014-07-09 16:58:15 -04:00
|
|
|
api.previewer = new api.Previewer({
|
2012-08-22 20:04:18 -04:00
|
|
|
container: '#customize-preview',
|
|
|
|
form: '#customize-controls',
|
|
|
|
previewUrl: api.settings.url.preview,
|
|
|
|
allowedUrls: api.settings.url.allowed,
|
|
|
|
signature: 'WP_CUSTOMIZER_SIGNATURE'
|
|
|
|
}, {
|
|
|
|
|
|
|
|
nonce: api.settings.nonce,
|
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/**
|
|
|
|
* Build the query to send along with the Preview request.
|
|
|
|
*
|
|
|
|
* @return {object}
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
query: function() {
|
2014-10-15 13:50:18 -04:00
|
|
|
var dirtyCustomized = {};
|
|
|
|
api.each( function ( value, key ) {
|
|
|
|
if ( value._dirty ) {
|
|
|
|
dirtyCustomized[ key ] = value();
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
return {
|
|
|
|
wp_customize: 'on',
|
2013-11-15 01:08:10 -05:00
|
|
|
theme: api.settings.theme.stylesheet,
|
2014-10-15 13:50:18 -04:00
|
|
|
customized: JSON.stringify( dirtyCustomized ),
|
2013-11-15 01:08:10 -05:00
|
|
|
nonce: this.nonce.preview
|
2012-08-22 20:04:18 -04:00
|
|
|
};
|
|
|
|
},
|
|
|
|
|
|
|
|
save: function() {
|
2015-03-10 18:45:27 -04:00
|
|
|
var self = this,
|
2014-03-14 15:16:14 -04:00
|
|
|
processing = api.state( 'processing' ),
|
|
|
|
submitWhenDoneProcessing,
|
2016-05-02 15:13:26 -04:00
|
|
|
submit,
|
2016-06-14 15:17:28 -04:00
|
|
|
modifiedWhileSaving = {},
|
|
|
|
invalidSettings = [],
|
|
|
|
invalidControls;
|
2014-03-14 15:16:14 -04:00
|
|
|
|
|
|
|
body.addClass( 'saving' );
|
|
|
|
|
2016-05-02 15:13:26 -04:00
|
|
|
function captureSettingModifiedDuringSave( setting ) {
|
|
|
|
modifiedWhileSaving[ setting.id ] = true;
|
|
|
|
}
|
|
|
|
api.bind( 'change', captureSettingModifiedDuringSave );
|
|
|
|
|
2014-03-14 15:16:14 -04:00
|
|
|
submit = function () {
|
2015-03-10 18:45:27 -04:00
|
|
|
var request, query;
|
2016-06-14 15:17:28 -04:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Block saving if there are any settings that are marked as
|
|
|
|
* invalid from the client (not from the server). Focus on
|
|
|
|
* the control.
|
|
|
|
*/
|
|
|
|
api.each( function( setting ) {
|
|
|
|
setting.notifications.each( function( notification ) {
|
|
|
|
if ( 'error' === notification.type && ( ! notification.data || ! notification.data.from_server ) ) {
|
|
|
|
invalidSettings.push( setting.id );
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
invalidControls = api.findControlsForSettings( invalidSettings );
|
|
|
|
if ( ! _.isEmpty( invalidControls ) ) {
|
|
|
|
_.values( invalidControls )[0][0].focus();
|
|
|
|
body.removeClass( 'saving' );
|
|
|
|
api.unbind( 'change', captureSettingModifiedDuringSave );
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-03-10 18:45:27 -04:00
|
|
|
query = $.extend( self.query(), {
|
|
|
|
nonce: self.nonce.save
|
|
|
|
} );
|
|
|
|
request = wp.ajax.post( 'customize_save', query );
|
2014-03-14 15:16:14 -04:00
|
|
|
|
2016-05-02 15:13:26 -04:00
|
|
|
// Disable save button during the save request.
|
|
|
|
saveBtn.prop( 'disabled', true );
|
|
|
|
|
2014-03-14 15:16:14 -04:00
|
|
|
api.trigger( 'save', request );
|
|
|
|
|
|
|
|
request.always( function () {
|
|
|
|
body.removeClass( 'saving' );
|
2016-05-02 15:13:26 -04:00
|
|
|
saveBtn.prop( 'disabled', false );
|
|
|
|
api.unbind( 'change', captureSettingModifiedDuringSave );
|
2014-03-14 15:16:14 -04:00
|
|
|
} );
|
|
|
|
|
2015-01-06 16:47:23 -05:00
|
|
|
request.fail( function ( response ) {
|
2014-03-14 15:16:14 -04:00
|
|
|
if ( '0' === response ) {
|
2015-01-06 16:47:23 -05:00
|
|
|
response = 'not_logged_in';
|
|
|
|
} else if ( '-1' === response ) {
|
|
|
|
// Back-compat in case any other check_ajax_referer() call is dying
|
|
|
|
response = 'invalid_nonce';
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( 'invalid_nonce' === response ) {
|
|
|
|
self.cheatin();
|
|
|
|
} else if ( 'not_logged_in' === response ) {
|
2014-03-14 15:16:14 -04:00
|
|
|
self.preview.iframe.hide();
|
|
|
|
self.login().done( function() {
|
|
|
|
self.save();
|
|
|
|
self.preview.iframe.show();
|
|
|
|
} );
|
|
|
|
}
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
|
2016-06-14 15:17:28 -04:00
|
|
|
if ( response.setting_validities ) {
|
|
|
|
api._handleSettingValidities( {
|
|
|
|
settingValidities: response.setting_validities,
|
|
|
|
focusInvalidControl: true
|
|
|
|
} );
|
|
|
|
}
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
|
2015-01-06 16:47:23 -05:00
|
|
|
api.trigger( 'error', response );
|
|
|
|
} );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-01-06 16:47:23 -05:00
|
|
|
request.done( function( response ) {
|
2016-05-02 15:13:26 -04:00
|
|
|
|
|
|
|
// Clear setting dirty states, if setting wasn't modified while saving.
|
|
|
|
api.each( function( setting ) {
|
|
|
|
if ( ! modifiedWhileSaving[ setting.id ] ) {
|
|
|
|
setting._dirty = false;
|
|
|
|
}
|
2014-10-15 13:50:18 -04:00
|
|
|
} );
|
2015-01-06 16:47:23 -05:00
|
|
|
|
2016-01-26 18:52:25 -05:00
|
|
|
api.previewer.send( 'saved', response );
|
|
|
|
|
2016-06-14 15:17:28 -04:00
|
|
|
if ( response.setting_validities ) {
|
|
|
|
api._handleSettingValidities( {
|
|
|
|
settingValidities: response.setting_validities,
|
|
|
|
focusInvalidControl: true
|
|
|
|
} );
|
|
|
|
}
|
|
|
|
|
2015-01-06 16:47:23 -05:00
|
|
|
api.trigger( 'saved', response );
|
2016-05-02 15:13:26 -04:00
|
|
|
|
|
|
|
// Restore the global dirty state if any settings were modified during save.
|
|
|
|
if ( ! _.isEmpty( modifiedWhileSaving ) ) {
|
|
|
|
api.state( 'saved' ).set( false );
|
|
|
|
}
|
2014-03-14 15:16:14 -04:00
|
|
|
} );
|
|
|
|
};
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2014-03-14 15:16:14 -04:00
|
|
|
if ( 0 === processing() ) {
|
|
|
|
submit();
|
|
|
|
} else {
|
|
|
|
submitWhenDoneProcessing = function () {
|
|
|
|
if ( 0 === processing() ) {
|
|
|
|
api.state.unbind( 'change', submitWhenDoneProcessing );
|
|
|
|
submit();
|
|
|
|
}
|
|
|
|
};
|
|
|
|
api.state.bind( 'change', submitWhenDoneProcessing );
|
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2017-05-16 08:15:34 -04:00
|
|
|
// Ensure preview nonce is included with every customized request, to allow post data to be read.
|
|
|
|
$.ajaxPrefilter( function injectPreviewNonce( options ) {
|
|
|
|
if ( ! /wp_customize=on/.test( options.data ) ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
options.data += '&' + $.param({
|
|
|
|
customize_preview_nonce: api.settings.nonce.preview
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
// Refresh the nonces if the preview sends updated nonces over.
|
2014-07-09 16:58:15 -04:00
|
|
|
api.previewer.bind( 'nonce', function( nonce ) {
|
2013-11-15 01:08:10 -05:00
|
|
|
$.extend( this.nonce, nonce );
|
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-04-06 11:10:27 -04:00
|
|
|
// Refresh the nonces if login sends updated nonces over.
|
|
|
|
api.bind( 'nonce-refresh', function( nonce ) {
|
|
|
|
$.extend( api.settings.nonce, nonce );
|
|
|
|
$.extend( api.previewer.nonce, nonce );
|
2016-01-27 12:55:26 -05:00
|
|
|
api.previewer.send( 'nonce-refresh', nonce );
|
2015-04-06 11:10:27 -04:00
|
|
|
});
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
// Create Settings
|
2012-08-22 20:04:18 -04:00
|
|
|
$.each( api.settings.settings, function( id, data ) {
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
var constructor = api.settingConstructor[ data.type ] || api.Setting,
|
|
|
|
setting;
|
|
|
|
|
|
|
|
setting = new constructor( id, data.value, {
|
2012-08-22 20:04:18 -04:00
|
|
|
transport: data.transport,
|
2015-03-10 18:39:28 -04:00
|
|
|
previewer: api.previewer,
|
|
|
|
dirty: !! data.dirty
|
2012-08-22 20:04:18 -04:00
|
|
|
} );
|
Customize: Add setting validation model and control notifications to augment setting sanitization.
When a setting is invalid, not only will it be blocked from being saved but all other settings will be blocked as well. This ensures that Customizer saves aren't partial but are more transactional. User will be displayed the error in a notification so that they can fix and re-attempt saving.
PHP changes:
* Introduces `WP_Customize_Setting::validate()`, `WP_Customize_Setting::$validate_callback`, and the `customize_validate_{$setting_id}` filter.
* Introduces `WP_Customize_Manager::validate_setting_values()` to do validation (and sanitization) for the setting values supplied, returning a list of `WP_Error` instances for invalid settings.
* Attempting to save settings that are invalid will result in the save being blocked entirely, with the errors being sent in the `customize_save_response`. Modifies `WP_Customize_Manager::save()` to check all settings for validity issues prior to calling their `save` methods.
* Introduces `WP_Customize_Setting::json()` for parity with the other Customizer classes. This includes exporting of the `type`.
* Modifies `WP_Customize_Manager::post_value()` to apply `validate` after `sanitize`, and if validation fails, to return the `$default`.
* Introduces `customize_save_validation_before` action which fires right before the validation checks are made prior to saving.
JS changes:
* Introduces `wp.customize.Notification` in JS which to represent `WP_Error` instances returned from the server when setting validation fails.
* Introduces `wp.customize.Setting.prototype.notifications`.
* Introduces `wp.customize.Control.prototype.notifications`, which are synced with a control's settings' notifications.
* Introduces `wp.customize.Control.prototype.renderNotifications()` to re-render a control's notifications in its notification area. This is called automatically when the notifications collection changes.
* Introduces `wp.customize.settingConstructor`, allowing custom setting types to be used in the same way that custom controls, panels, and sections can be made.
* Injects a notification area into existing controls which is populated in response to the control's `notifications` collection changing. A custom control can customize the placement of the notification area by overriding the new `getNotificationsContainerElement` method.
* When a save fails due to setting invalidity, the invalidity errors will be added to the settings to then populate in the controls' notification areas, and the first such invalid control will be focused.
Props westonruter, celloexpressions, mrahmadawais.
See #35210.
See #30937.
Fixes #34893.
Built from https://develop.svn.wordpress.org/trunk@37476
git-svn-id: http://core.svn.wordpress.org/trunk@37444 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2016-05-20 17:10:27 -04:00
|
|
|
api.add( id, setting );
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
// Create Panels
|
|
|
|
$.each( api.settings.panels, function ( id, data ) {
|
|
|
|
var constructor = api.panelConstructor[ data.type ] || api.Panel,
|
|
|
|
panel;
|
|
|
|
|
|
|
|
panel = new constructor( id, {
|
|
|
|
params: data
|
|
|
|
} );
|
|
|
|
api.panel.add( id, panel );
|
|
|
|
});
|
|
|
|
|
|
|
|
// Create Sections
|
|
|
|
$.each( api.settings.sections, function ( id, data ) {
|
|
|
|
var constructor = api.sectionConstructor[ data.type ] || api.Section,
|
|
|
|
section;
|
|
|
|
|
|
|
|
section = new constructor( id, {
|
|
|
|
params: data
|
|
|
|
} );
|
|
|
|
api.section.add( id, section );
|
|
|
|
});
|
|
|
|
|
|
|
|
// Create Controls
|
2012-08-22 20:04:18 -04:00
|
|
|
$.each( api.settings.controls, function( id, data ) {
|
|
|
|
var constructor = api.controlConstructor[ data.type ] || api.Control,
|
|
|
|
control;
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
control = new constructor( id, {
|
2012-08-22 20:04:18 -04:00
|
|
|
params: data,
|
2014-07-09 16:58:15 -04:00
|
|
|
previewer: api.previewer
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
} );
|
|
|
|
api.control.add( id, control );
|
|
|
|
});
|
|
|
|
|
|
|
|
// Focus the autofocused element
|
2016-03-01 17:04:27 -05:00
|
|
|
_.each( [ 'panel', 'section', 'control' ], function( type ) {
|
|
|
|
var id = api.settings.autofocus[ type ];
|
|
|
|
if ( ! id ) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Defer focus until:
|
|
|
|
* 1. The panel, section, or control exists (especially for dynamically-created ones).
|
|
|
|
* 2. The instance is embedded in the document (and so is focusable).
|
|
|
|
* 3. The preview has finished loading so that the active states have been set.
|
|
|
|
*/
|
|
|
|
api[ type ]( id, function( instance ) {
|
|
|
|
instance.deferred.embedded.done( function() {
|
|
|
|
api.previewer.deferred.active.done( function() {
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
instance.focus();
|
|
|
|
});
|
|
|
|
});
|
2016-03-01 17:04:27 -05:00
|
|
|
});
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
api.bind( 'ready', api.reflowPaneContents );
|
|
|
|
$( [ api.panel, api.section, api.control ] ).each( function ( i, values ) {
|
2016-06-26 10:26:29 -04:00
|
|
|
var debouncedReflowPaneContents = _.debounce( api.reflowPaneContents, 100 );
|
|
|
|
values.bind( 'add', debouncedReflowPaneContents );
|
|
|
|
values.bind( 'change', debouncedReflowPaneContents );
|
|
|
|
values.bind( 'remove', debouncedReflowPaneContents );
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
} );
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
// Check if preview url is valid and load the preview frame.
|
2014-07-09 16:58:15 -04:00
|
|
|
if ( api.previewer.previewUrl() ) {
|
|
|
|
api.previewer.refresh();
|
|
|
|
} else {
|
|
|
|
api.previewer.previewUrl( api.settings.url.home );
|
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
// Save and activated states
|
|
|
|
(function() {
|
|
|
|
var state = new api.Values(),
|
2014-03-14 15:16:14 -04:00
|
|
|
saved = state.create( 'saved' ),
|
|
|
|
activated = state.create( 'activated' ),
|
|
|
|
processing = state.create( 'processing' );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
state.bind( 'change', function() {
|
|
|
|
if ( ! activated() ) {
|
2014-07-08 13:04:15 -04:00
|
|
|
saveBtn.val( api.l10n.activate ).prop( 'disabled', false );
|
2014-07-08 14:19:14 -04:00
|
|
|
closeBtn.find( '.screen-reader-text' ).text( api.l10n.cancel );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
} else if ( saved() ) {
|
2014-07-08 13:04:15 -04:00
|
|
|
saveBtn.val( api.l10n.saved ).prop( 'disabled', true );
|
2014-07-08 14:19:14 -04:00
|
|
|
closeBtn.find( '.screen-reader-text' ).text( api.l10n.close );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
} else {
|
2014-07-08 13:04:15 -04:00
|
|
|
saveBtn.val( api.l10n.save ).prop( 'disabled', false );
|
2014-07-08 14:19:14 -04:00
|
|
|
closeBtn.find( '.screen-reader-text' ).text( api.l10n.cancel );
|
2012-08-22 20:04:18 -04:00
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
// Set default states.
|
|
|
|
saved( true );
|
|
|
|
activated( api.settings.theme.active );
|
2014-03-14 15:16:14 -04:00
|
|
|
processing( 0 );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
|
|
|
api.bind( 'change', function() {
|
|
|
|
state('saved').set( false );
|
|
|
|
});
|
|
|
|
|
|
|
|
api.bind( 'saved', function() {
|
|
|
|
state('saved').set( true );
|
|
|
|
state('activated').set( true );
|
|
|
|
});
|
|
|
|
|
|
|
|
activated.bind( function( to ) {
|
2016-06-26 10:26:29 -04:00
|
|
|
if ( to ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
api.trigger( 'activated' );
|
2016-06-26 10:26:29 -04:00
|
|
|
}
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
|
|
|
// Expose states to the API.
|
|
|
|
api.state = state;
|
|
|
|
}());
|
|
|
|
|
|
|
|
// Button bindings.
|
2014-07-08 13:04:15 -04:00
|
|
|
saveBtn.click( function( event ) {
|
2014-07-09 16:58:15 -04:00
|
|
|
api.previewer.save();
|
2012-08-22 20:04:18 -04:00
|
|
|
event.preventDefault();
|
2012-11-06 09:47:25 -05:00
|
|
|
}).keydown( function( event ) {
|
|
|
|
if ( 9 === event.which ) // tab
|
|
|
|
return;
|
|
|
|
if ( 13 === event.which ) // enter
|
2014-07-09 16:58:15 -04:00
|
|
|
api.previewer.save();
|
2012-11-06 09:47:25 -05:00
|
|
|
event.preventDefault();
|
|
|
|
});
|
2012-11-09 00:44:00 -05:00
|
|
|
|
2014-07-08 14:19:14 -04:00
|
|
|
closeBtn.keydown( function( event ) {
|
2012-11-06 09:47:25 -05:00
|
|
|
if ( 9 === event.which ) // tab
|
|
|
|
return;
|
|
|
|
if ( 13 === event.which ) // enter
|
2013-08-15 12:25:12 -04:00
|
|
|
this.click();
|
2012-11-06 09:47:25 -05:00
|
|
|
event.preventDefault();
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
2015-07-10 17:22:26 -04:00
|
|
|
$( '.collapse-sidebar' ).on( 'click', function() {
|
|
|
|
if ( 'true' === $( this ).attr( 'aria-expanded' ) ) {
|
|
|
|
$( this ).attr({ 'aria-expanded': 'false', 'aria-label': api.l10n.expandSidebar });
|
|
|
|
} else {
|
|
|
|
$( this ).attr({ 'aria-expanded': 'true', 'aria-label': api.l10n.collapseSidebar });
|
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032, #28579, #28580, #28650, #28709, #29758.
fixes #29529.
Built from https://develop.svn.wordpress.org/trunk@30102
git-svn-id: http://core.svn.wordpress.org/trunk@30102 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2014-10-29 18:51:22 -04:00
|
|
|
}
|
2012-11-20 16:25:54 -05:00
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
overlay.toggleClass( 'collapsed' ).toggleClass( 'expanded' );
|
|
|
|
});
|
|
|
|
|
2016-05-02 15:52:28 -04:00
|
|
|
// Keyboard shortcuts - esc to exit section/panel.
|
|
|
|
$( 'body' ).on( 'keydown', function( event ) {
|
|
|
|
var collapsedObject, expandedControls = [], expandedSections = [], expandedPanels = [];
|
|
|
|
|
|
|
|
if ( 27 !== event.which ) { // Esc.
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Check for expanded expandable controls (e.g. widgets and nav menus items), sections, and panels.
|
|
|
|
api.control.each( function( control ) {
|
|
|
|
if ( control.expanded && control.expanded() && _.isFunction( control.collapse ) ) {
|
|
|
|
expandedControls.push( control );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
api.section.each( function( section ) {
|
|
|
|
if ( section.expanded() ) {
|
|
|
|
expandedSections.push( section );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
api.panel.each( function( panel ) {
|
|
|
|
if ( panel.expanded() ) {
|
|
|
|
expandedPanels.push( panel );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
|
|
|
// Skip collapsing expanded controls if there are no expanded sections.
|
|
|
|
if ( expandedControls.length > 0 && 0 === expandedSections.length ) {
|
|
|
|
expandedControls.length = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Collapse the most granular expanded object.
|
|
|
|
collapsedObject = expandedControls[0] || expandedSections[0] || expandedPanels[0];
|
|
|
|
if ( collapsedObject ) {
|
|
|
|
collapsedObject.collapse();
|
|
|
|
event.preventDefault();
|
|
|
|
}
|
|
|
|
});
|
|
|
|
|
2016-04-17 11:41:27 -04:00
|
|
|
$( '.customize-controls-preview-toggle' ).on( 'click', function() {
|
2015-02-09 07:36:28 -05:00
|
|
|
overlay.toggleClass( 'preview-only' );
|
|
|
|
});
|
|
|
|
|
2016-02-15 20:57:26 -05:00
|
|
|
// Previewed device bindings.
|
|
|
|
api.previewedDevice = new api.Value();
|
|
|
|
|
|
|
|
// Set the default device.
|
|
|
|
api.bind( 'ready', function() {
|
|
|
|
_.find( api.settings.previewableDevices, function( value, key ) {
|
|
|
|
if ( true === value['default'] ) {
|
|
|
|
api.previewedDevice.set( key );
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
|
|
|
|
// Set the toggled device.
|
|
|
|
footerActions.find( '.devices button' ).on( 'click', function( event ) {
|
|
|
|
api.previewedDevice.set( $( event.currentTarget ).data( 'device' ) );
|
|
|
|
});
|
|
|
|
|
|
|
|
// Bind device changes.
|
|
|
|
api.previewedDevice.bind( function( newDevice ) {
|
|
|
|
var overlay = $( '.wp-full-overlay' ),
|
|
|
|
devices = '';
|
|
|
|
|
|
|
|
footerActions.find( '.devices button' )
|
|
|
|
.removeClass( 'active' )
|
|
|
|
.attr( 'aria-pressed', false );
|
|
|
|
|
|
|
|
footerActions.find( '.devices .preview-' + newDevice )
|
|
|
|
.addClass( 'active' )
|
|
|
|
.attr( 'aria-pressed', true );
|
|
|
|
|
|
|
|
$.each( api.settings.previewableDevices, function( device ) {
|
|
|
|
devices += ' preview-' + device;
|
|
|
|
} );
|
|
|
|
|
|
|
|
overlay
|
|
|
|
.removeClass( devices )
|
|
|
|
.addClass( 'preview-' + newDevice );
|
|
|
|
} );
|
|
|
|
|
2014-07-08 15:53:15 -04:00
|
|
|
// Bind site title display to the corresponding field.
|
|
|
|
if ( title.length ) {
|
2016-01-23 18:15:27 -05:00
|
|
|
api( 'blogname', function( setting ) {
|
|
|
|
var updateTitle = function() {
|
|
|
|
title.text( $.trim( setting() ) || api.l10n.untitledBlogName );
|
|
|
|
};
|
|
|
|
setting.bind( updateTitle );
|
|
|
|
updateTitle();
|
2014-07-08 15:53:15 -04:00
|
|
|
} );
|
|
|
|
}
|
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/*
|
|
|
|
* Create a postMessage connection with a parent frame,
|
|
|
|
* in case the Customizer frame was opened with the Customize loader.
|
|
|
|
*
|
|
|
|
* @see wp.customize.Loader
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
parent = new api.Messenger({
|
|
|
|
url: api.settings.url.parent,
|
|
|
|
channel: 'loader'
|
|
|
|
});
|
|
|
|
|
2015-09-05 15:53:24 -04:00
|
|
|
/*
|
|
|
|
* If we receive a 'back' event, we're inside an iframe.
|
|
|
|
* Send any clicks to the 'Return' link to the parent page.
|
|
|
|
*/
|
2012-08-22 20:04:18 -04:00
|
|
|
parent.bind( 'back', function() {
|
2014-07-08 14:19:14 -04:00
|
|
|
closeBtn.on( 'click.customize-controls-close', function( event ) {
|
2012-08-22 20:04:18 -04:00
|
|
|
event.preventDefault();
|
|
|
|
parent.send( 'close' );
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
2014-07-08 13:04:15 -04:00
|
|
|
// Prompt user with AYS dialog if leaving the Customizer with unsaved changes
|
|
|
|
$( window ).on( 'beforeunload', function () {
|
|
|
|
if ( ! api.state( 'saved' )() ) {
|
2015-02-24 23:17:27 -05:00
|
|
|
setTimeout( function() {
|
2015-02-24 15:31:24 -05:00
|
|
|
overlay.removeClass( 'customize-loading' );
|
|
|
|
}, 1 );
|
2014-07-08 13:04:15 -04:00
|
|
|
return api.l10n.saveAlert;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
// Pass events through to the parent.
|
2014-07-08 13:04:15 -04:00
|
|
|
$.each( [ 'saved', 'change' ], function ( i, event ) {
|
|
|
|
api.bind( event, function() {
|
|
|
|
parent.send( event );
|
|
|
|
});
|
|
|
|
} );
|
2012-08-22 20:04:18 -04:00
|
|
|
|
2015-03-25 13:26:26 -04:00
|
|
|
// Pass titles to the parent
|
|
|
|
api.bind( 'title', function( newTitle ) {
|
|
|
|
parent.send( 'title', newTitle );
|
|
|
|
});
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
// Initialize the connection with the parent frame.
|
|
|
|
parent.send( 'ready' );
|
|
|
|
|
|
|
|
// Control visibility for default controls
|
|
|
|
$.each({
|
|
|
|
'background_image': {
|
|
|
|
controls: [ 'background_repeat', 'background_position_x', 'background_attachment' ],
|
2013-11-15 01:08:10 -05:00
|
|
|
callback: function( to ) { return !! to; }
|
2012-08-22 20:04:18 -04:00
|
|
|
},
|
|
|
|
'show_on_front': {
|
|
|
|
controls: [ 'page_on_front', 'page_for_posts' ],
|
2013-11-15 01:08:10 -05:00
|
|
|
callback: function( to ) { return 'page' === to; }
|
2012-08-22 20:04:18 -04:00
|
|
|
},
|
|
|
|
'header_textcolor': {
|
|
|
|
controls: [ 'header_textcolor' ],
|
2013-11-15 01:08:10 -05:00
|
|
|
callback: function( to ) { return 'blank' !== to; }
|
2012-08-22 20:04:18 -04:00
|
|
|
}
|
|
|
|
}, function( settingId, o ) {
|
|
|
|
api( settingId, function( setting ) {
|
|
|
|
$.each( o.controls, function( i, controlId ) {
|
|
|
|
api.control( controlId, function( control ) {
|
|
|
|
var visibility = function( to ) {
|
|
|
|
control.container.toggle( o.callback( to ) );
|
|
|
|
};
|
|
|
|
|
|
|
|
visibility( setting.get() );
|
|
|
|
setting.bind( visibility );
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
|
|
|
// Juggle the two controls that use header_textcolor
|
|
|
|
api.control( 'display_header_text', function( control ) {
|
|
|
|
var last = '';
|
|
|
|
|
|
|
|
control.elements[0].unsync( api( 'header_textcolor' ) );
|
|
|
|
|
|
|
|
control.element = new api.Element( control.container.find('input') );
|
|
|
|
control.element.set( 'blank' !== control.setting() );
|
|
|
|
|
|
|
|
control.element.bind( function( to ) {
|
|
|
|
if ( ! to )
|
|
|
|
last = api( 'header_textcolor' ).get();
|
|
|
|
|
|
|
|
control.setting.set( to ? last : 'blank' );
|
|
|
|
});
|
|
|
|
|
|
|
|
control.setting.bind( function( to ) {
|
|
|
|
control.element.set( 'blank' !== to );
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
2015-06-27 15:59:25 -04:00
|
|
|
// Change previewed URL to the homepage when changing the page_on_front.
|
|
|
|
api( 'show_on_front', 'page_on_front', function( showOnFront, pageOnFront ) {
|
|
|
|
var updatePreviewUrl = function() {
|
|
|
|
if ( showOnFront() === 'page' && parseInt( pageOnFront(), 10 ) > 0 ) {
|
|
|
|
api.previewer.previewUrl.set( api.settings.url.home );
|
|
|
|
}
|
|
|
|
};
|
|
|
|
showOnFront.bind( updatePreviewUrl );
|
|
|
|
pageOnFront.bind( updatePreviewUrl );
|
|
|
|
});
|
|
|
|
|
|
|
|
// Change the previewed URL to the selected page when changing the page_for_posts.
|
|
|
|
api( 'page_for_posts', function( setting ) {
|
|
|
|
setting.bind(function( pageId ) {
|
|
|
|
pageId = parseInt( pageId, 10 );
|
|
|
|
if ( pageId > 0 ) {
|
|
|
|
api.previewer.previewUrl.set( api.settings.url.home + '?page_id=' + pageId );
|
|
|
|
}
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
2016-06-14 15:17:28 -04:00
|
|
|
// Update the setting validities.
|
|
|
|
api.previewer.bind( 'selective-refresh-setting-validities', function handleSelectiveRefreshedSettingValidities( settingValidities ) {
|
|
|
|
api._handleSettingValidities( {
|
|
|
|
settingValidities: settingValidities,
|
|
|
|
focusInvalidControl: false
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
|
2016-02-19 13:41:28 -05:00
|
|
|
// Focus on the control that is associated with the given setting.
|
|
|
|
api.previewer.bind( 'focus-control-for-setting', function( settingId ) {
|
|
|
|
var matchedControl;
|
|
|
|
api.control.each( function( control ) {
|
|
|
|
var settingIds = _.pluck( control.settings, 'id' );
|
|
|
|
if ( -1 !== _.indexOf( settingIds, settingId ) ) {
|
|
|
|
matchedControl = control;
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
if ( matchedControl ) {
|
|
|
|
matchedControl.focus();
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
// Refresh the preview when it requests.
|
|
|
|
api.previewer.bind( 'refresh', function() {
|
|
|
|
api.previewer.refresh();
|
|
|
|
});
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
api.trigger( 'ready' );
|
2012-11-06 09:47:25 -05:00
|
|
|
|
|
|
|
// Make sure left column gets focus
|
2014-07-08 14:19:14 -04:00
|
|
|
topFocus = closeBtn;
|
2012-11-06 09:47:25 -05:00
|
|
|
topFocus.focus();
|
|
|
|
setTimeout(function () {
|
|
|
|
topFocus.focus();
|
|
|
|
}, 200);
|
|
|
|
|
2012-08-22 20:04:18 -04:00
|
|
|
});
|
|
|
|
|
2012-11-06 09:47:25 -05:00
|
|
|
})( wp, jQuery );
|