TYPO3中如何添加扩展资源链接并获取路径实现字体预加载?
TYPO3 站点包字体预加载配置实现
核心逻辑
不需要手动拼接EXT:my_site/Resources目录对应的web访问地址,借助TypoScript内置的资源解析能力,配合你已经尝试使用的headerData机制,即可完成head区域的预加载link标签配置。
落地配置步骤
- 通过TypoScript内置的
resource数据处理器,自动完成站点包内部路径到公开可访问URL的转换,无需手动计算路径映射关系 - 将解析完成的资源路径包装为符合字体预加载规范的link标签,挂载到页面的head渲染节点中
- 可直接复用的配置示例:
# 解析站点包Public目录下的字体资源 lib.fontPreload = TEXT lib.fontPreload { data = resource:EXT:my_site/Resources/Public/Fonts/main-font.woff2 stdWrap.wrap = <link rel="preload" href="|" as="font" type="font/woff2" crossorigin> } # 将节点挂载到页面头部输出 page.headerData.200 < lib.fontPreload
常见问题排查
- 禁止直接将
EXT:格式的内部路径字符串直接写入link的href属性,这类路径仅对TYPO3内部逻辑生效,浏览器无法识别访问 - 若需要预加载多份字体,可依次为每个字体分配独立的headerData索引(如201、202),或通过批量处理逻辑循环输出对应标签
- 配置不生效时优先排查两项:
- 字体文件是否放置在站点包的
Resources/Public目录下,已被TYPO3自动发布到web可访问路径 - 编写的TypoScript配置是否在当前站点的模板根位置生效,未被其他优先级更高的模板覆盖
- 字体文件是否放置在站点包的
内容的提问来源于stack exchange,提问作者user500665
相关产品推荐
相关产品推荐

