blueways/bw-placeholder-images

Inline SVG placeholder images with lazy loading

Installs: 870

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:typo3-cms-extension

v1.2.0 2022-10-29 13:46 UTC

This package is auto-updated.

Last update: 2022-11-30 08:35:48 UTC


README

TYPO3 Extension: Placeholder Images

Generates SVG inline placeholder images from FAL Media elements. The Foundation Interchange plugin is configured to resolve the right responsive image. The SVG placeholder consists of three gradients with 9 different colors from the original FAL image to make it look more natural.

The color extrection code is based on Frans Saris lazy_load_placeholder TYPO3 extension. Lazy loading code inspired by Mika Tuupola. SVG inline compression is done like Taylor Hunt explained it in his blog post.

Requirements

  • TYPO3 v8.0+
  • Foundation 6 (or Foundation.Interchange Plugin)

Installation

This extension is installable only via composer.

  • composer require blueways/bw-placeholder-images
  • include TypoScript template

Configuration

The Javascript File is automatically included via includeJSFooterLibs. This can be disabled by unsetting

plugin.bw_placeholder_images.settings.placeholderImagesJS = EXT:bw_placeholder_images/Resources/Public/JavaScript/placeholderImages.js

Useage

The color extraction starts automatically after uploading any jpg, jpeg, gif or png image via FAL.

Viewhelper

Register the viewhelpers in any fluid template.

{namespace bw=Blueways\BwPlaceholderImages\ViewHelpers}

bw:lazyImage

This viewhelper acts like the normal <f:image /> viewhelper, however there is an svg image output of the referenced src or image. The final images are added via additionalAttributes in Foundation Interchange style.

Example with different crop variants:

<bw:lazyImage
    image="{mediaElement}"
    cropVariant="small"
    width="585"
    additionalAttributes="{data-lazy-interchange: '
        [{f:uri.image(image:mediaElement,maxWidth:\'600\', cropVariant:\'small\')}, small],
        [{f:uri.image(image:mediaElement,maxWidth:\'500\', cropVariant:\'medium\')}, medium],
        [{f:uri.image(image:mediaElement,maxWidth:\'450\', cropVariant:\'large\')}, large]
    '}"
/>

bw:lazyPlaceholder

Acts like <f:uri.image /> viewhelper.

Foundation Interchange can handle responsive background images, this viewhelper helps to generate the nessecary Output of an image resource path.

Example without crop variant and only one final image for all sizes:

<div
    style='background-image: url("{bw:lazyPlaceholder(src:'{image.properties.uid}')}");'
    data-lazy-interchange="[{f:uri.image(src:'{image.properties.uid}', maxWidth:'640')}, small]"
></div>

Attention: The style='' Tag needs to be rendered with single quotes.

TODO

  • include dependencies in package
  • make fallback color editable via typoscript
  • animate image switch