说明
该标签为当前文章附件中的上一幅图片生成链接。
用法
<?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()。
分类:中文手册