当前浏览:首页 / WordPress函数 / the_attachment_link()

the_attachment_link( int|WP_Post $id, bool $fullsize = false, bool $deprecated = false, bool $permalink = false )

使用图片或图标显示附件页面链接

attachment 附件more...

linkmore...

themore...


参数

$id

(int|WP_Post)(可选) Post ID或Post对象。

$fullsize

(bool)(可选) 是否使用全(full)尺寸。

默认值: false

$deprecated

(bool)(可选) 已弃用。勿使用。

默认值: false

$permalink

(bool)(可选) 是否包括固定链接。

默认值: false


说明

将HTML超链接输出到附件文件或页面,其中包含

  1. 用于图片附件的全尺寸图像或缩略图;
  2. 非图像附件的附件标题(作为文本)

如果找不到附件,函数将显示字符串Missing Attachment

如果您只想获取超链接,而不是打印它,请使用wp_get_attachment_link()



源码

查看源码 官方文档


更新日志

版本描述
2.0.0开始引入

使用示例

  • 示例1

    示例

    <?php
    
    // Show an image at full size linked to the attachment file
    the_attachment_link( 4, true );
    
    // Show a thumbnail linked to the attachment page
    the_attachment_link( 4, false, false, true );
    
    ?>