钩子文档

image_save_progressive

💡 云策文档标注

概述

image_save_progressive 是一个 WordPress 过滤器,用于控制是否输出渐进式图像(如果可用)。它允许开发者根据 MIME 类型动态设置图像保存时的交错参数。

关键要点

  • 这是一个过滤器,用于修改图像保存时是否使用渐进式输出。
  • 接受两个参数:$interlace(布尔值,默认 false)和 $mime_type(字符串)。
  • 在 WP_Image_Editor_Imagick 和 WP_Image_Editor_GD 的 _save() 方法中被调用。
  • 从 WordPress 6.5.0 版本开始引入。

代码示例

interlace( $image, apply_filters( 'image_save_progressive', false, $mime_type ) );

📄 原文内容

Filters whether to output progressive images (if available).

Parameters

$interlacebool
Whether to use progressive images for output if available. Default false.
$mime_typestring
The mime type being saved.

Source

imageinterlace( $image, apply_filters( 'image_save_progressive', false, $mime_type ) );

Changelog

Version Description
6.5.0 Introduced.