mirror of
https://github.com/WordPress/WordPress.git
synced 2024-09-30 16:17:56 +02:00
Docs: Add wp-admin/js/custom-background.js
documentation.
Props jipmoors. Fixes #41067. Built from https://develop.svn.wordpress.org/trunk@40914 git-svn-id: http://core.svn.wordpress.org/trunk@40764 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
c569080cd1
commit
952975fd0d
@ -1,9 +1,24 @@
|
|||||||
/* global ajaxurl */
|
/* global ajaxurl */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @summary Registers all events for customizing the background.
|
||||||
|
*
|
||||||
|
* @since 3.0.0
|
||||||
|
*
|
||||||
|
* @requires jQuery
|
||||||
|
*/
|
||||||
(function($) {
|
(function($) {
|
||||||
$(document).ready(function() {
|
$(document).ready(function() {
|
||||||
var frame,
|
var frame,
|
||||||
bgImage = $( '#custom-background-image' );
|
bgImage = $( '#custom-background-image' );
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @summary Instantiates the WordPress color picker and binds the change and clear events.
|
||||||
|
*
|
||||||
|
* @since 3.5.0
|
||||||
|
*
|
||||||
|
* @returns {void}
|
||||||
|
*/
|
||||||
$('#background-color').wpColorPicker({
|
$('#background-color').wpColorPicker({
|
||||||
change: function( event, ui ) {
|
change: function( event, ui ) {
|
||||||
bgImage.css('background-color', ui.color.toString());
|
bgImage.css('background-color', ui.color.toString());
|
||||||
@ -13,22 +28,57 @@
|
|||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @summary Alters the background size CSS property whenever the background size input has changed.
|
||||||
|
*
|
||||||
|
* @since 4.7.0
|
||||||
|
*
|
||||||
|
* @returns {void}
|
||||||
|
*/
|
||||||
$( 'select[name="background-size"]' ).change( function() {
|
$( 'select[name="background-size"]' ).change( function() {
|
||||||
bgImage.css( 'background-size', $( this ).val() );
|
bgImage.css( 'background-size', $( this ).val() );
|
||||||
});
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @summary Alters the background position CSS property whenever the background position input has changed.
|
||||||
|
*
|
||||||
|
* @since 4.7.0
|
||||||
|
*
|
||||||
|
* @returns {void}
|
||||||
|
*/
|
||||||
$( 'input[name="background-position"]' ).change( function() {
|
$( 'input[name="background-position"]' ).change( function() {
|
||||||
bgImage.css( 'background-position', $( this ).val() );
|
bgImage.css( 'background-position', $( this ).val() );
|
||||||
});
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @summary Alters the background repeat CSS property whenever the background repeat input has changed.
|
||||||
|
*
|
||||||
|
* @since 3.0.0
|
||||||
|
*
|
||||||
|
* @returns {void}
|
||||||
|
*/
|
||||||
$( 'input[name="background-repeat"]' ).change( function() {
|
$( 'input[name="background-repeat"]' ).change( function() {
|
||||||
bgImage.css( 'background-repeat', $( this ).is( ':checked' ) ? 'repeat' : 'no-repeat' );
|
bgImage.css( 'background-repeat', $( this ).is( ':checked' ) ? 'repeat' : 'no-repeat' );
|
||||||
});
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @summary Alters the background attachment CSS property whenever the background attachment input has changed.
|
||||||
|
*
|
||||||
|
* @since 4.7.0
|
||||||
|
*
|
||||||
|
* @returns {void}
|
||||||
|
*/
|
||||||
$( 'input[name="background-attachment"]' ).change( function() {
|
$( 'input[name="background-attachment"]' ).change( function() {
|
||||||
bgImage.css( 'background-attachment', $( this ).is( ':checked' ) ? 'scroll' : 'fixed' );
|
bgImage.css( 'background-attachment', $( this ).is( ':checked' ) ? 'scroll' : 'fixed' );
|
||||||
});
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @summary Binds the event for opening the WP Media dialog.
|
||||||
|
*
|
||||||
|
* @since 3.5.0
|
||||||
|
*
|
||||||
|
* @returns {void}
|
||||||
|
*/
|
||||||
$('#choose-from-library-link').click( function( event ) {
|
$('#choose-from-library-link').click( function( event ) {
|
||||||
var $el = $(this);
|
var $el = $(this);
|
||||||
|
|
||||||
@ -54,13 +104,21 @@
|
|||||||
button: {
|
button: {
|
||||||
// Set the text of the button.
|
// Set the text of the button.
|
||||||
text: $el.data('update'),
|
text: $el.data('update'),
|
||||||
// Tell the button not to close the modal, since we're
|
/*
|
||||||
// going to refresh the page when the image is selected.
|
* Tell the button not to close the modal, since we're
|
||||||
|
* going to refresh the page when the image is selected.
|
||||||
|
*/
|
||||||
close: false
|
close: false
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
// When an image is selected, run a callback.
|
/**
|
||||||
|
* @summary When an image is selected, run a callback.
|
||||||
|
*
|
||||||
|
* @since 3.5.0
|
||||||
|
*
|
||||||
|
* @returns {void}
|
||||||
|
*/
|
||||||
frame.on( 'select', function() {
|
frame.on( 'select', function() {
|
||||||
// Grab the selected attachment.
|
// Grab the selected attachment.
|
||||||
var attachment = frame.state().get('selection').first();
|
var attachment = frame.state().get('selection').first();
|
||||||
|
@ -4,7 +4,7 @@
|
|||||||
*
|
*
|
||||||
* @global string $wp_version
|
* @global string $wp_version
|
||||||
*/
|
*/
|
||||||
$wp_version = '4.9-alpha-40913';
|
$wp_version = '4.9-alpha-40914';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||||
|
Loading…
Reference in New Issue
Block a user