You need to enable JavaScript to run this app. 如何在自定义Typoscript模板中输出页面资源头部图的说明文字
优惠活动
大模型
产品
解决方案
定价
更多

如何在自定义Typoscript模板中输出页面资源头部图的说明文字

问题解答

一、通过###CAPTION###输出图片说明的实现方案

原生TYPO3的IMAGE对象默认不会自动将文件的描述字段填充到###CAPTION###占位符,你只需在现有代码的renderObj配置段中新增caption属性即可实现需求,修改示例如下:

renderObj = IMAGE
renderObj {
    # 原有file、altText、titleText配置保留
    caption.data = file:current:description
    caption.wrap = <figcaption class="header-image__caption">|</figcaption>
    # 原有layout、sourceCollection等配置保留
}

配置后你代码中预留在img标签后的###CAPTION###会自动替换为图片的描述文本,直接展示在图片下方。如果需要将描述放在picture标签外部,也可以调整COA结构,新增独立的40序号配置段输出caption,结构会更灵活。

二、FLUID与纯TypoScript的适配性对比

这个场景下更推荐使用FLUID实现,优势非常明确:

  • 结构逻辑完全分离:前端调整HTML结构、样式类、元素位置直接修改FLUID模板即可,不需要改动TypoScript配置,维护成本大幅降低
  • 媒体资源处理更便捷:TYPO3原生FLUID视图助手<f:image />、<f:media />自带响应式配置、字段输出能力,代码可读性远高于多层嵌套的TypoScript
  • 扩展能力更强:如果后续需要新增图片版权信息、跳转链接、多图轮播等逻辑,在FLUID中实现的复杂度远低于纯TypoScript

FLUID实现参考示例

首先通过DataProcessor将页面资源传递给模板:

page.10.dataProcessing {
    10 = TYPO3\CMS\Frontend\DataProcessing\FilesProcessor
    10 {
        references.fieldName = media
        references.table = pages
        as = headerImages
    }
}

之后直接在FLUID模板中编写输出逻辑即可:

<f:if condition="{headerImages.0}">
    <div class="header-image">
        <picture class="header-image__picture">
            <source srcset="{f:uri.image(image: headerImages.0, maxWidth: 2000, maxHeight: 1080)}" media="(min-width: 1025px)">
            <source srcset="{f:uri.image(image: headerImages.0, maxWidth: 640, maxHeight: 360)}" media="(max-width: 767px)">
            <img src="{f:uri.image(image: headerImages.0, maxWidth: 640, maxHeight: 360)}" alt="{headerImages.0.alternative}" title="{headerImages.0.title}">
        </picture>
        <f:if condition="{headerImages.0.description}">
            <figcaption class="header-image__caption">{headerImages.0.description}</figcaption>
        </f:if>
    </div>
</f:if>

内容的提问来源于stack exchange,提问作者June

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 18:15:03