WordPress获取附件链接标签函数:wp_get_attachment_link
2022/07/13
当提供的附件ID为图像附件时,WordPress函数wp_get_attachment_link与wp_get_attachment_image()函数的区别在于,wp_get_attachment_image()函数输出一个img元素,而wp_get_attachment_link()函数是一个包含img元素的链接标签,该链接指向附件URL。
wp_get_attachment_link( int|WP_Post $id, string|int[] $size = 'thumbnail', bool $permalink = false, bool $icon = false, string|false $text = false, array|string $attr = '' )
函数参数
$id
整数或对象
附件ID或WP_Post对象
$size
字符串或数字数组,默认值:thumbnail
指定图像大小,可以是已定义的缩略图名称,或包含宽度和高度的数组。
$permalink
布尔值,默认值:false
默认值下,链接的URL为附件文件的URL,如果值true,则为附件页面的链接。
$icon
布尔值,默认值:false
值为true时,如果附件为非图像文件,将显示对应的图标。
$text
字符串,默认值:false
要使用的链接文本,即锚文本。如果附件为图像,默认的锚文本是img图像标签,当指定$text值后,锚文本将变为指定的文本。
$attr
数组
属性数组,可以指定多个属性。
函数返回值
<a href="https://www.dianjin123.com/wp-content/uploads/2020/05/baidusrf-for-linux.webp"> <img width="768" height="430" src="https://www.dianjin123.com/wp-content/uploads/2020/05/baidusrf-for-linux.webp" class="attachment-full size-full" alt="百度输入法Linux版本" loading="lazy"> </a>
函数使用示例
<?php $id = 9; echo wp_get_attachment_link($id, array('400', '300'), false, false, '点击这里'); ?>