Make WordPress Core

Ticket #39930: 39930-1.patch

File 39930-1.patch, 2.5 KB (added by shramee, 7 years ago)

Second patch for docs

  • src/wp-admin/js/customize-controls.js

    diff --git a/src/wp-admin/js/customize-controls.js b/src/wp-admin/js/customize-controls.js
    index 5987bf4..0322bfb 100644
    a b  
    33813381        // Change objects contained within the main customize object to Settings.
    33823382        api.defaultConstructor = api.Setting;
    33833383
    3384         // Create the collections for Controls, Sections and Panels.
     3384        /**
     3385         * Get instance of control by ID
     3386         * Use wp.customize.control.each( function(){ ... } ) to loop through each control registered in customizer
     3387         *
     3388         * @param {string} ID of control
     3389         * @param {function} Called if control with ID is found, control instance passed as first parameter
     3390         * @returns {wp.customize.Control|undefined} Control instance or undefined
     3391         *
     3392         * @example wp.customize.control('background_color') Getting `background_color` control instance
     3393         * @example wp.customize.control('background_color').setting.get() Getting `background_color` value
     3394         * @example wp.customize.control('background_color', function( control ){ control.setting.set('#f00') } ) Setting `background_color` to red
     3395         */
    33853396        api.control = new api.Values({ defaultConstructor: api.Control });
     3397
     3398        /**
     3399         * Get instance of section by ID
     3400         * Use wp.customize.section.each( function(){ ... } ) to loop through each section registered in customizer
     3401         *
     3402         * @param {string} ID of section
     3403         * @param {function} Called if section with ID is found, section instance passed as first parameter
     3404         * @returns {wp.customize.Section|undefined} Section instance or undefined
     3405         *
     3406         * @example wp.customize.section('title_tagline') Getting `title_tagline` section instance
     3407         * @example wp.customize.section('title_tagline', function( section ){ section.expand() } ) Expand (enter) `title_tagline` section
     3408         */
    33863409        api.section = new api.Values({ defaultConstructor: api.Section });
     3410
     3411        /**
     3412         * Get instance of panel by ID
     3413         * Use wp.customize.panel.each( function(){ ... } ) to loop through each panel registered in customizer
     3414         *
     3415         * @param {string} ID of panel
     3416         * @param {function} Called if panel with ID is found, panel instance passed as first parameter
     3417         * @returns {wp.customize.Panel|undefined} Panel instance or undefined
     3418         *
     3419         * @example wp.customize.panel('nav_menus') Getting nav_menus panel instance
     3420         * @example wp.customize.panel('nav_menus', function( panel ){ panel.expand() } ) Expand (enter) nav_menus panel
     3421         */
    33873422        api.panel = new api.Values({ defaultConstructor: api.Panel });
    33883423
    33893424        /**