如何在自定义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
相关产品推荐
相关产品推荐

