Documentation >
Templating >
Twig function reference >
Image Twig functions

Image Twig functions¶

ibexa_image_alias returns the selected variation of an image field.
ibexa_content_field_identifier_first_filled_image returns the identifier of the first image field in a content item that isn't empty.

Image rendering¶

To render images, use the ibexa_render_field() Twig function with the variation name passed as an argument, for example:

{{ ibexa_render_field(content, 'image', {
    'template': '@ibexadesign/fields/image.html.twig',
    'attr': {class: 'thumbnail-image'},
    'parameters': {
        'alias': 'small'
    }
}) }}

Image information¶

`ibexa_image_alias()`¶

ibexa_image_alias() returns the selected variation of an image field.

Argument	Type	Description
`field`	`Ibexa\Contracts\Core\Repository\Values\Content\Field`	The image field.
`versionInfo`	`Ibexa\Contracts\Core\Repository\Values\Content\VersionInfo`	The VersionInfo that the field belongs to.
`variantName`	`string`	Name of the image variation to be used. To display the original image variation, use `original` as the variation name.

{% set thumbnail = ibexa_image_alias(imageField, content.versionInfo, 'small') %}

Tip

You can access the name of a variation from the variation object with variation.name. You can, for example, use it as parameter in the ibexa_render_field() Twig function.

`ibexa_content_field_identifier_first_filled_image()`¶

ibexa_content_field_identifier_first_filled_image() returns the identifier of the first image field that isn't empty.

Caution

This function works only for Image fields. It doesn't work for ImageAsset fields.

Argument	Type	Description
`content`	`Content` or `ContentAwareInterface`	Content item to display the image for.

{% set firstImage = ibexa_content_field_identifier_first_filled_image(content) %}

{% set firstImage = ibexa_content_field_identifier_first_filled_image(product) %}

Examples¶

You can use ibexa_content_field_identifier_first_filled_image() to find and render the first existing image in an article:

{% set firstImage = ibexa_content_field_identifier_first_filled_image(content) %}
{{ ibexa_render_field(content, firstImage) }}