函数描述

输出链接到附件文件或附件页面的HTML链接，可以为：

1. 图片附件的缩略图或原图链接。
2. 其他类型的附件，输出附件的标题

如果没找到附件，此函数显示字符串： Missing Attachment。

使用方法

<?php the_attachment_link( $id, $fullsize, $deprecated, $permalink ); ?>

默认使用方法

<?php the_attachment_link( 7 ); ?>

参数

$id

(integer) (可选) 附件ID。

Default: 在主循环（必须是显示附件的主循环）中使用时，为当前文章 ID。

$fullsize

(boolean) (可选) 如果是图片附件，使用原始图片（true）或WordPress生成的缩略图（flase），如果设置为( false)，但是找不到缩略图，将设置为全尺寸图片。

默认: ‘False’

$max_dims

(array) (2.3以后的版本中已弃用) ，图片或图标的最大宽度，应用到图片元素的 width和 height 属性，长宽比将保持不变。

默认: not used

$permalink

boolean) (可选) 直接连接到附件（默认），或链接到附件页面。

默认: ‘False’

使用示例

<?php

// 显示全尺寸的附件文件
the_attachment_link( 4, true );

// 显示连接到附件页面的缩略图
the_attachment_link( 4, false, false, true );

?>

注意

如果只是获取，而不是直接显示连接，使用 wp_get_attachment_link() 。