函数文档

wp_admin_viewport_meta()

💡 云策文档标注

概述

wp_admin_viewport_meta() 函数用于在 WordPress 后台输出视口元标签,以优化移动设备上的显示效果。它通过一个过滤器允许开发者自定义视口元标签的内容。

关键要点

  • 函数 wp_admin_viewport_meta() 在 WordPress 5.5.0 版本中引入,专门用于管理后台的视口元标签输出。
  • 使用 apply_filters('admin_viewport_meta', $viewport_meta) 钩子,开发者可以过滤和修改视口元标签的默认值。
  • 默认视口元标签为 'width=device-width,initial-scale=1.0',适用于响应式设计。
  • 如果过滤后的视口元标签为空,函数将不输出任何内容。

代码示例

function wp_admin_viewport_meta() {
    $viewport_meta = apply_filters( 'admin_viewport_meta', 'width=device-width,initial-scale=1.0' );
    if ( empty( $viewport_meta ) ) {
        return;
    }
    echo '';
}

注意事项

  • 此函数仅影响 WordPress 后台界面,不适用于前端。
  • 使用 admin_viewport_meta 过滤器时,确保返回有效的视口元标签字符串,否则可能影响后台的移动端显示。
  • 相关函数包括 esc_attr() 用于 HTML 属性转义,apply_filters() 用于调用过滤器钩子。

📄 原文内容

Displays the viewport meta in the admin.

Source

function wp_admin_viewport_meta() {
	/**
	 * Filters the viewport meta in the admin.
	 *
	 * @since 5.5.0
	 *
	 * @param string $viewport_meta The viewport meta.
	 */
	$viewport_meta = apply_filters( 'admin_viewport_meta', 'width=device-width,initial-scale=1.0' );

	if ( empty( $viewport_meta ) ) {
		return;
	}

	echo '<meta name="viewport" content="' . esc_attr( $viewport_meta ) . '">';
}

Hooks

apply_filters( ‘admin_viewport_meta’, string $viewport_meta )

Filters the viewport meta in the admin.

Changelog

Version Description
5.5.0 Introduced.