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