当前浏览:首页 / WordPress函数 / wp_lazy_loading_enabled()

wp_lazy_loading_enabled( string $tag_name, string $context ): bool

确定是否将loading属性添加到指定上下文中的指定标签

enabled

lazy

loading


参数

$tag_namestring必填
标签名
$contextstring必填
附加的上下文,如当前过滤器名称或调用的函数名称。

返回

bool 是否添加属性。


钩子



源码

查看源码 官方文档


更新日志

版本描述
5.7.0现在,对于iframe标签,默认情况下返回true
5.5.0开始引入

使用示例

  • 示例1

    wp_lazy_loading_enabled为所有标签返回true,默认情况下,每次调用此函数时都返回true。挂钩到wp_lazy_loading_enabled过滤器是启用或禁用此功能的主要方式,但它不允许为特定附件或mime类型启用或禁用。

    add_filter( 'wp_lazy_loading_enabled', '__return_false' );

    1.要更改此功能对特定附件的工作方式,可以将“loading”属性提供给wp_get_attachment_image函数,或者您可以使用wp_get_attachment_image_attributes过滤器修改或删除该属性。

    $attr['loading'] = false;
    return wp_get_attachment_image( $attachment_id, $size, $icon, $attr );

    add_filter( 'wp_get_attachment_image_attributes', function( $attr, $attachment, $size ) {
    	if ( $attachment->post_mime_type === 'image/svg+xml' ) {
    		unset( $attr['loading'] );
    	}
    	return $attr;
    } );

    2.要更改特定头像的工作方式,您可以重新定义get_avatar函数,在‘extra_attr’参数中提供“loading”属性,或者使用get_avatar过滤器替换HTML。

    3.the_contentthe_excerptwidget_text_filters将在内容上调用wp_filter_content_tags过滤器,这也将为图像标签添加“loading”属性。为了调整这一点,可以使用wp_img_tag_add_loading_attr过滤器逐个管理标签的“loading”属性。