如何获取WordPress中ACF字段关联图片的alt文本？

问题分析 #

你当前的ACF图片字段（still_image_url）应该设置为返回URL格式，所以直接调用get_sub_field('image')无效，且无法直接拿到图片ID和Alt文本。另外the_ID()在这里无效是因为它获取的是当前父文章/页面的ID，而非轮播图中图片附件的ID。

两种解决方案 #

方案1：修改ACF字段返回格式（推荐） #

1. 进入WordPress后台的ACF字段组编辑页面，找到对应still_image_url的图片字段
2. 将「返回格式」从「URL」改为「图像对象」或「图像ID」

若改为「图像对象」，代码调整如下：

<?php while (have_rows('top_slider')) : the_row(); ?>
<?php
    $video_url = get_sub_field('video_url');
    $video_url_responsive = get_sub_field('video_url_responsive');
    $video_link = get_sub_field('video_link');
    $image_link = get_sub_field('image_link');
    $has_target = strpos($image_link, '/') !== 0;

    // 获取图像对象及相关数据
    $image_obj = get_sub_field('still_image_url');
    if($image_obj) {
        $image_url = $image_obj['url'];
        $image_alt = $image_obj['alt'];
        $image_id = $image_obj['ID'];
    } else {
        // 图片不存在时的默认值
        $image_url = '';
        $image_alt = '轮播图默认描述';
    }
?>
<!-- 使用示例 -->
<img src="<?php echo esc_url($image_url); ?>" alt="<?php echo esc_attr($image_alt); ?>">
<?php endwhile; ?>

方案2：通过图片URL反向获取ID与Alt文本（无需修改字段设置） #

利用WordPress内置函数attachment_url_to_postid()通过图片URL获取附件ID，再用get_post_meta()读取Alt文本：

<?php while (have_rows('top_slider')) : the_row(); ?>
<?php
    $video_url = get_sub_field('video_url');
    $video_url_responsive = get_sub_field('video_url_responsive');
    $video_link = get_sub_field('video_link');
    $image_url = get_sub_field('still_image_url');
    $image_link = get_sub_field('image_link');
    $has_target = strpos($image_link, '/') !== 0;

    // 获取图片Alt文本
    $image_alt = '';
    if($image_url) {
        $image_id = attachment_url_to_postid($image_url);
        if($image_id) {
            $image_alt = get_post_meta($image_id, '_wp_attachment_image_alt', true);
            // 若Alt为空，设置默认文本
            $image_alt = $image_alt ?: '轮播图片';
        }
    }
?>
<!-- 使用示例 -->
<img src="<?php echo esc_url($image_url); ?>" alt="<?php echo esc_attr($image_alt); ?>">
<?php endwhile; ?>

关键说明 #

• esc_url()和esc_attr()是为了防止XSS漏洞，务必在输出URL和属性时使用
• 如果图片未设置Alt文本，建议添加默认值以符合SEO规范

内容的提问来源于stack exchange，提问作者Ryan Hubbuck