TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper Class Reference

Inheritance diagram for TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper:

Public Member Functions
	__construct ()
	initializeArguments ()
	render ()

Protected Member Functions
	getExceptionMessage (string $detailedMessage)

Protected Attributes
string	$tagName = 'img'
ImageService	$imageService

Detailed Description

Resizes a given image (if required) and renders the respective img tag.

Note that image operations (cropping, scaling, converting) on non-FAL files (i.e. extension resources) may be changed in future TYPO3 versions, since those operations are coupled with FAL metadata. Each non-FAL image operation creates a "fake" FAL record, which may lead to problems.

External URLs are not processed. Only a given width and height will be set on the tag.

Examples

Default

::

<f:image src="EXT:myext/Resources/Public/typo3_logo.png" alt="alt text" />

Output in frontend::

or in backend::

Image Object

::

<f:image image="{imageObject}" />

Output::

Inline notation

::

{f:image(src: 'EXT:viewhelpertest/Resources/Public/typo3_logo.png', alt: 'alt text', minWidth: 30, maxWidth: 40)}

Output::

Depending on your TYPO3s encryption key.

Other resource type (e.g. PDF)

::

<f:image src="fileadmin/user_upload/example.pdf" alt="foo" />

If your graphics processing library is set up correctly then it will output a thumbnail of the first page of your PDF document: <img src="fileadmin/_processed_/1/2/csm_example_aabbcc112233.gif" width="200" height="284" alt="foo">

Non-existent image

::

<f:image src="NonExistingImage.png" alt="foo" />

Could not get image resource for "NonExistingImage.png".

Definition at line 101 of file ImageViewHelper.php.

Constructor & Destructor Documentation

__construct()

TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper::__construct

(

)

Definition at line 109 of file ImageViewHelper.php.

Member Function Documentation

getExceptionMessage()

TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper::getExceptionMessage ( string  $detailedMessage )

protected

Definition at line 231 of file ImageViewHelper.php.

Referenced by TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper\render().

initializeArguments()

TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper::initializeArguments

(

)

Definition at line 115 of file ImageViewHelper.php.

render()

TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper::render

(

)

Resizes a given image (if required) and renders the respective img tag.

See also

‪https://docs.typo3.org/typo3cms/TyposcriptReference/ContentObjects/Image/

Exceptions

Exception

Definition at line 148 of file ImageViewHelper.php.

References $GLOBALS, TYPO3\CMS\Core\Imaging\ImageManipulation\CropVariantCollection\create(), TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper\getExceptionMessage(), and TYPO3\CMS\Core\Utility\GeneralUtility\inList().

Member Data Documentation

$imageService

ImageService TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper::$imageService

protected

Definition at line 107 of file ImageViewHelper.php.

$tagName

string TYPO3\CMS\Fluid\ViewHelpers\ImageViewHelper::$tagName = 'img'

protected

Definition at line 105 of file ImageViewHelper.php.