Návod

Image

Renderování veřejných image referencí ve view pomocí bezpečných URL, skutečných rozměrů a prezentačních atributů.

Vyrenderuj ImageReference ve view

ImageReference nese bezpečnou veřejnou relativní cestu, skutečné rozměry a formát obrázku. Předej ji do $helpers->image() spolu s ImageViewOptions. Helper vyrenderuje escapované atributy src, alt, loading, width a height; při nastavení doplní class a decoding. Výchozí loading je lazy a výchozí decoding je async.

render-reference.php
<?php

use Lemonade\Framework\Image\ImageViewOptions;
use Lemonade\Framework\Image\Value\ImageDimensions;
use Lemonade\Framework\Image\Value\ImageFormat;
use Lemonade\Framework\Image\Value\ImageReference;

$avatar = new ImageReference(
    publicPath: 'images/avatars/jane.webp',
    dimensions: new ImageDimensions(320, 320),
    format: ImageFormat::Webp,
);

echo $helpers->image(
    $avatar,
    new ImageViewOptions(
        alt: 'Jane Doe',
        class: 'rounded-circle',
        loading: 'lazy',
    ),
);

Nech volitelný obrázek volitelným

Nullable referenci předej přímo do $helpers->image(). Když je reference null, helper vrátí prázdný řetězec, takže view nepotřebuje samostatnou podmínku jen kvůli vynechání image markup.

null-reference.php
<?php

use Lemonade\Framework\Image\Value\ImageReference;

/** @var ImageReference|null $avatar */
$avatar = null;

echo $helpers->image($avatar);
// ''