Installation
- Simply copy the
ResponsiveImg
folder intosite/addons/
- Ensure you are Serving Cached Images Directly
- That's it!
Usage
ResponsiveImg makes use of Statamic's shorthand tag syntax:
{{ responsive_img:[image_name] }}
Add additional attributes by using the attr
option:
{{ responsive_img:[image_name] attr="id:my-id|class:some-class|alt:Lorem Ipsum" }}
Loop over an array of images using the assets
tag:
{{ assets:gallery }} {{ responsive_img:id attr="class:image-{ index }|alt:{ alt }" }}{{ /assets:gallery }}
To lazy-load images using JS, add the data-src
option:
{{ responsive_img:[image_name] data-src="true" }}
When using data-src
, you are free to use any lazy-loading library that makes use of this technique. If you want to keep things simple and merely defer image loading until the rest of the page is ready, the following vanilla JS snippet should get you started:
Parameters
Name | Type | Default | Description |
---|---|---|---|
quality |
Integer | 75 |
Defines the quality of the image (see Glide parameters). |
attr |
String | Add additional HTML attributes to the <img> tag, specify multiple attributes by pipe delimiting them. |
|
data-src |
Boolean | false |
Change src & srcset into data-src & data-srcset (for lazy-loading using JS). |