说明

该标签为当前文章附件中的上一幅图片生成链接。

用法

<?php previous_image_link( [string $size = ‘thumbnail’], [string $text = false] ); ?>

示例

默认用法

<?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' ); ?>

参数

$size

（字符串）（可选）可选，默认值为thumbnail。表示图片的大小，值可为字符串或数组。若值为0或null，则默认为post_title或$text。

默认值：None

$text

（字符串）（可选）可选，默认值为false。若包含该参数，图片链接会反映出$text变量。

默认值：None

历史记录

• 始见于WordPress 2.5.0版本。

相关资料

参见next_image_link()。

分类：中文手册