描述
另见
- add_image_size(): 关于裁剪行为的细节。
参数
- $width
-
(int) (必填) 图像宽度(像素)
- $height
-
(int) (必填) 图像高度(像素)
- $crop
-
(bool|array) (可选) 是将图像裁剪到指定的宽度和高度还是调整大小。可以指定裁剪区域位置的数组。
默认值: false
说明
- 要为特色图片注册额外的图片尺寸,请使用:add_image_size()
- 要启用特色图像,在当前主题的 functions.php 文件 中添加
add_theme_support( 'post-thumbnails' );
,另见 文章缩略图 - 这个函数不会调整你现有的特色图片的尺寸,要以新的尺寸重新生成现有图像,请使用 Regenerate Thumbnails 插件
源码
更新日志
版本 | 描述 |
---|---|
2.9.0 | 开始引入 |
使用示例
在当前主题的
functions.php
文件中使用的默认用法。function wpdocs_setup_theme() { add_theme_support( 'post-thumbnails' ); set_post_thumbnail_size( 150, 150 ); } add_action( 'after_setup_theme', 'wpdocs_setup_theme' );
裁剪模式
通过按比例调整图像大小(即不扭曲图像)来设置默认的文章缩略图尺寸:set_post_thumbnail_size( 50, 50 ); // 50 pixels wide by 50 pixels tall, resize mode
通过裁剪图像(从侧面或从顶部和底部)来设置默认的文章缩略图尺寸:
set_post_thumbnail_size( 50, 50, true ); // 50 pixels wide by 50 pixels tall, crop mode
通过从左上角裁剪图像来设置默认的文章缩略图尺寸:
set_post_thumbnail_size( 50, 50, array( 'top', 'left') ); // 50 pixels wide by 50 pixels tall, crop from the top left corner
通过从中心裁剪图像来设置默认的我缩略图尺寸:
set_post_thumbnail_size( 50, 50, array( 'center', 'center') ); // 50 pixels wide by 50 pixels tall, crop from the center
注意:此功能不会调整现有特色图像的尺寸。要以新大小重新生成现有图像,请使用“Regenerate Thumbnails”插件。