模板标签-previous_image_link()

0条评论

说明

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

用法

<?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()。