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. |