WP_Customize_Manager::set_autofocus() WordPress Method

The WP_Customize_Manager::set_autofocus() method is used to set the focus for a specific control in the Customizer. This is useful when you want to ensure that a particular control is given focus when the Customizer is first loaded.

WP_Customize_Manager::set_autofocus( array $autofocus ) #

Sets the autofocused constructs.


Parameters

$autofocus

(array)(Required)Mapping of 'panel', 'section', 'control' to the ID which should be autofocused.

  • 'control'
    (string) ID for control to be autofocused.
  • 'section'
    (string) ID for section to be autofocused.
  • 'panel'
    (string) ID for panel to be autofocused.


Top ↑

Source

File: wp-includes/class-wp-customize-manager.php

	public function set_autofocus( $autofocus ) {
		$this->autofocus = array_filter( wp_array_slice_assoc( $autofocus, array( 'panel', 'section', 'control' ) ), 'is_string' );
	}


Top ↑

Changelog

Changelog
VersionDescription
4.4.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More