云策 WordPress 开发者社区

类文档

WP_Customize_Nav_Menu_Name_Control

查看官方原文 ↗
💡 云策文档标注

概述

WP_Customize_Nav_Menu_Name_Control 是 WordPress 自定义控件，用于在自定义器中表示菜单的名称字段。它继承自 WP_Customize_Control，主要依赖 JS 模板进行渲染。

关键要点

  • 控件类型为 'nav_menu_name'，用于 JavaScript 识别。
  • render_content() 方法为空操作，因为渲染使用 JS 模板。
  • content_template() 方法渲染 Underscore 模板，包含标签、输入框和描述。
  • 自 WordPress 4.3.0 版本引入。

代码示例

class WP_Customize_Nav_Menu_Name_Control extends WP_Customize_Control {
    public $type = 'nav_menu_name';
    protected function render_content() {}
    protected function content_template() {
        ?>
        <label>
            <# if ( data.label ) { #>
                <span class="customize-control-title">{{ data.label }}</span>
            <# } #>
            <input type="text"
                <# if ( data.description ) { #>
                    aria-describedby="{{ data.section }}-description"
                <# } #>
            />
        </label>
        <# if ( data.description ) { #>
            <span class="description customize-control-description">{{ data.description }}</span>
        <# } #>
        <?php
    }
}
📄 原文内容

Customize control to represent the name field for a given menu.

Description

See also

Methods

Name Description
WP_Customize_Nav_Menu_Name_Control::content_template Render the Underscore template for this control.
WP_Customize_Nav_Menu_Name_Control::render_content No-op since we’re using JS template.

Source

class WP_Customize_Nav_Menu_Name_Control extends WP_Customize_Control {


	/**

	 * Type of control, used by JS.

	 *

	 * @since 4.3.0

	 * @var string

	 */

	public $type = 'nav_menu_name';


	/**

	 * No-op since we're using JS template.

	 *

	 * @since 4.3.0

	 */

	protected function render_content() {}


	/**

	 * Render the Underscore template for this control.

	 *

	 * @since 4.3.0

	 */

	protected function content_template() {

		?>

		<label>

			<# if ( data.label ) { #>

				<span class="customize-control-title">{{ data.label }}</span>

			<# } #>

			<input type="text" class="menu-name-field live-update-section-title"

				<# if ( data.description ) { #>

					aria-describedby="{{ data.section }}-description"

				<# } #>

				/>

		</label>

		<# if ( data.description ) { #>

			<p id="{{ data.section }}-description">{{ data.description }}</p>

		<# } #>

		</pre><p class="wporg-dot-link-list"><a href="https://developer.wordpress.org/reference/files/wp-includes/customize/class-wp-customize-nav-menu-name-control.php/">View all references</a> <a href="https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/customize/class-wp-customize-nav-menu-name-control.php#L17">View on Trac</a> <a href="https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/customize/class-wp-customize-nav-menu-name-control.php#L17-L56">View on GitHub</a></p></section>


		<section class="wp-block-wporg-code-reference-related" data-nosnippet="true"><h2 id="related" class="is-toc-heading wp-block-heading has-heading-5-font-size" tabindex="-1" ><a href="#related">Related</a></h2> <section style="margin-top:var(--wp--preset--spacing--20)" class="wp-block-wporg-code-table" id="uses"><figure class="wp-block-table "><table><thead><tr><th scope="col">Uses</th><th scope="col">Description</th></tr></thead><tbody><tr class=""><td><a href="https://developer.wordpress.org/reference/classes/wp_customize_control/">WP_Customize_Control</a><code>wp-includes/class-wp-customize-control.php

Changelog

Version Description
4.3.0 Introduced.