函数描述
输出链接到附件文件或附件页面的HTML链接,可以为:
- 图片附件的缩略图或原图链接。
- 其他类型的附件,输出附件的标题
如果没找到附件,此函数显示字符串: Missing Attachment。
使用方法
<?php the_attachment_link( $id, $fullsize, $deprecated, $permalink ); ?>
默认使用方法
<?php the_attachment_link( 7 ); ?>
参数
参数 | 数据类型 | 是否必需 | 描述 | 默认值 |
---|---|---|---|---|
$id | 整数 | 否 | 附件ID,在主循环(必须是显示附件的主循环)中使用时,为当前文章 ID。 | 无 |
$fullsize | 布尔值 | 否 | 如果是图片附件,使用原始图片(true)或WordPress生成的缩略图(flase),如果设置为(false),但是找不到缩略图,将设置为全尺寸图片 | False |
$max_dims | 数组 | 否 | 图片或图标的最大宽度,应用到图片元素的width和 height 属性,长宽比将保持不变。 | 无 |
$permalink | 布尔值 | 否 | 直接连接到附件(默认),或链接到附件页面。 | False |
使用示例
// 显示全尺寸的附件文件
the_attachment_link( 4, true );
// 显示连接到附件页面的缩略图
the_attachment_link( 4, false, false, true );
注意
如果只是获取,而不是直接显示连接,使用 wp_get_attachment_link() 。