用途:在 Hyvä Theme 的 PHTML 模板中渲染图片,尤其是需要响应式 <picture> 元素的场景,例如移动端与桌面端使用不同图源的 banner、产品图或 CMS 内容图,并通过加载策略优化 Core Web Vitals 中的 LCP 与 CLS。
主要能力:使用 \Hyva\Theme\ViewModel\Media 视图模型,调用 getResponsivePictureHtml($images, $imgAttributes, $pictureAttributes) 生成响应式图片代码。第一个参数为图片配置数组;第二个可选参数用于 alt、class、loading、fetchpriority 等 img 属性;第三个可选参数用于为 <picture> 外层设置 class、data-* 等属性。
使用方式:先在模板中通过 $viewModels->require(\Hyva\Theme\ViewModel\Media::class) 获取 Media 视图模型。单张图片使用字面量配置;来自变量时需包裹为数组 [$imageData] 传入;多张图片可直接传入 $images;需要区分移动端与桌面端图源时,按 Media Queries 模式配置。加载策略上,首屏或 LCP 图片使用 'loading' => 'eager' 和 'fetchpriority' => 'high',非首屏图片使用 'loading' => 'lazy'。具体数组结构与完整配置项需参考 references/rendering-images.md 中的 Image Configuration Format。
适用场景:Hyvä 主题开发中的图片渲染、响应式图源切换与图片性能优化。
限制:资料仅涉及 Hyvä Theme 与上述视图模型,未提供其他平台、价格、依赖版本或兼容性信息;使用前需确认模板中已具备可用的 Media 视图模型。