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

image_downsize( int $id, string|int[] $size = 'medium' )

缩放图片以适合特定大小(如“thumb”或“medium”)

downsize

imagemore...


描述

URL可能是原始图像,也可能是调整尺寸的版本。此函数不会创建一个新的调整尺寸的副本,它只会返回一个已调整尺寸的拷贝(如果存在)。

插件可以使用‘image_downsize’过滤器连接到图像并提供图片尺寸调整服务。钩子必须返回一个数组,该数组包含通常从函数返回的元素。


参数

$id

(int)(必填) 图片附件ID。

$size

(string|int[])(可选) 图像尺寸。接受任何已注册的图片尺寸名称,或以像素为单位的宽度和高度值数组(按该顺序)。

默认值: 'medium'


返回

(array|false) 图像数据数组,如果没有图像可用,则为布尔false。

  • (string) 图片源URL。
  • '1'
    (int) 以像素为单位的图片宽度。
  • '2'
    (int) 以像素为单位的图片高度。
  • '3'
    (bool) 图片是否是调整尺寸的图片。


源码

查看源码 官方文档


更新日志

版本描述
2.5.0开始引入

使用示例

  • 示例1

    添加选择媒体附件图像的函数

    也许你已经知道wp_get_attachment_thumb_url();。现在,我将演示如何执行相同的操作来返回中等大小附件的url。

    function wp_get_attachment_medium_url( $id )
    {
        $medium_array = image_downsize( $id, 'medium' );
        $medium_path = $medium_array[0];
    
        return $medium_path;
    }
    

    $id是附件的ID。这对于像WP Choose Thumb这样的插件非常有用。使用此功能,您可以获得中等大小的预览。