参数
$tag_name
string必填-
标签名
$context
string必填-
附加的上下文,如当前过滤器名称或调用的函数名称。
返回
bool 是否添加属性。
钩子
-
apply_filters( 'wp_lazy_loading_enabled',
bool $default ,string $tag_name ,string $context ) -
筛选是否将
loading
属性添加到指定上下文中的指定标签。
源码
更新日志
版本 | 描述 |
---|---|
5.7.0 | 现在,对于iframe 标签,默认情况下返回true 。 |
5.5.0 | 开始引入 |
使用示例
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_content
、the_excerpt
和widget_text_filters
将在内容上调用wp_filter_content_tags
过滤器,这也将为图像标签添加“loading”属性。为了调整这一点,可以使用wp_img_tag_add_loading_attr
过滤器逐个管理标签的“loading”属性。