参数
- $size
-
(string|int[])(可选) 图片尺寸。接受任何注册的图像尺寸名称，或以像素为单位的宽度和高度值数组（按该顺序）。
默认值: 'thumbnail'
- $text
-
(string|false)(可选) 链接文本。
默认值: false
说明
用法：
通常用于attachment.php。在WordPress默认主题Twenty Eleven 和 Twenty Twelve中，它用于image.php。
previous_image_link( $size, $text );
注意：
这将创建一个指向附加到当前文章的上一张图片的链接。每当一系列图像链接到附件页面时，在附件页面中查看时，它会将“上一张图片链接”与图像放在一起。
源码
更新日志
| 版本 | 描述 |
|---|---|
| 2.5.0 | 开始引入 |
使用示例
基本示例
默认用法
<?php previous_image_link(); ?>
工作示例
<div class="alignleft"><?php previous_image_link(); ?></div>
选择可识别的图像尺寸
<?php previous_image_link( 'thumbnail' ); ?> <?php previous_image_link( 'medium' ); ?> <?php previous_image_link( 'large' ); ?> <?php previous_image_link( 'fullsize' ); ?>
定义自定义图片尺寸
<?php previous_image_link( array( 37, 37 ) ); ?>
请注意，传递数组作为第一个参数不会创建新图像；它将使用web浏览器重新调整缩略图的大小，以适应给定的尺寸。虽然这在紧要关头起作用，但由于浏览器无法对重新调整大小的图像进行重新采样，因此会产生相当扭曲的图像视图。
将图像标题用作链接文本
如果将布尔值false用作第一个参数，该函数将使用图像的标题值（通过媒体库设置）。
<?php previous_image_link( false ); ?> <?php previous_image_link( 0 ); ?>
使用自定义字符串作为链接文本
要将自定义字符串指定为链接文本，请将布尔值false作为第一个参数，将自定义文本作为字符串传递给第二个参数。
<?php previous_image_link( false, 'Previous Image' ); ?>