Window width:
Breakpoint:
Display a responsive image in a normal container column layout.
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-6 col-lg-4 col-xl-3">
<?= ResponsivePics::get_image(1, 'xs-12, md-6, lg-4, xl-3'); ?>
</div>
</div>
</div>
This method will output a <img> element that spans 12 columns from the xs breakpoint and up, 6 columns from the md breakpoint, 4 columns from the lg breakpoint and up and 3 columns from the xl breakpoint and up.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<img srcset="/app/uploads/2020/10/samuel-zeller-168223-240x360.jpg 240w, /app/uploads/2020/10/samuel-zeller-168223-240x360@2x.jpg 480w, /app/uploads/2020/10/samuel-zeller-168223-290x435.jpg 290w, /app/uploads/2020/10/samuel-zeller-168223-290x435@2x.jpg 580w, /app/uploads/2020/10/samuel-zeller-168223-330x495.jpg 330w, /app/uploads/2020/10/samuel-zeller-168223-330x495@2x.jpg 660w, /app/uploads/2020/10/samuel-zeller-168223-510x765.jpg 510w, /app/uploads/2020/10/samuel-zeller-168223-510x765@2x.jpg 1020w, /app/uploads/2020/10/samuel-zeller-168223-546x819.jpg 546w, /app/uploads/2020/10/samuel-zeller-168223-546x819@2x.jpg 1092w" sizes="(min-width: 1200px) 240px, (min-width: 992px) 290px, (min-width: 768px) 330px, (min-width: 576px) 510px, (min-width: 0px) 546px, 100vw" width="240" height="360" alt="Responsive image"/>
Data
{
"alpha": false,
"alt": "Responsive image",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2020/10/samuel-zeller-168223-240x360.jpg",
"source2x": "/app/uploads/2020/10/samuel-zeller-168223-240x360@2x.jpg",
"width": 240,
"height": 360,
"ratio": 0.6666666666666666
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2020/10/samuel-zeller-168223-290x435.jpg",
"source2x": "/app/uploads/2020/10/samuel-zeller-168223-290x435@2x.jpg",
"width": 290,
"height": 435,
"ratio": 0.6666666666666666
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2020/10/samuel-zeller-168223-330x495.jpg",
"source2x": "/app/uploads/2020/10/samuel-zeller-168223-330x495@2x.jpg",
"width": 330,
"height": 495,
"ratio": 0.6666666666666666
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2020/10/samuel-zeller-168223-510x765.jpg",
"source2x": "/app/uploads/2020/10/samuel-zeller-168223-510x765@2x.jpg",
"width": 510,
"height": 765,
"ratio": 0.6666666666666666
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2020/10/samuel-zeller-168223-546x819.jpg",
"source2x": "/app/uploads/2020/10/samuel-zeller-168223-546x819@2x.jpg",
"width": 546,
"height": 819,
"ratio": 0.6666666666666666
}
],
"lazyload": false,
"decorative": false,
"classes": []
}
Rendered
Display a responsive image in a normal container column layout with a cropped height from the left bottom of 75% of the width.
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-6 col-lg-12">
<?= ResponsivePics::get_image(1, 'xs-12, md-6, lg:400', 0,75|l b); ?>
</div>
</div>
</div>
This method will output a <img> element that spans 12 columns from the xs breakpoint and up, 6 columns from the md breakpoint and up and 400px from the lg breakpoint and up.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<img srcset="/app/uploads/2020/09/alex-shutin-204369-unsplash-400x300-crop-0-100.jpg 400w, /app/uploads/2020/09/alex-shutin-204369-unsplash-400x300-crop-0-100@2x.jpg 800w, /app/uploads/2020/09/alex-shutin-204369-unsplash-330x248-crop-0-100.jpg 330w, /app/uploads/2020/09/alex-shutin-204369-unsplash-330x248-crop-0-100@2x.jpg 660w, /app/uploads/2020/09/alex-shutin-204369-unsplash-546x410-crop-0-100.jpg 546w, /app/uploads/2020/09/alex-shutin-204369-unsplash-546x410-crop-0-100@2x.jpg 1092w" sizes="(min-width: 992px) 400px, (min-width: 768px) 330px, (min-width: 0px) 546px, 100vw" width="400" height="300" alt="Image with srcset & sizes attacking example"/>
Data
{
"alpha": false,
"alt": "Image with srcset & sizes attacking example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 992,
"source1x": "/app/uploads/2020/09/alex-shutin-204369-unsplash-400x300-crop-0-100.jpg",
"source2x": "/app/uploads/2020/09/alex-shutin-204369-unsplash-400x300-crop-0-100@2x.jpg",
"width": 400,
"height": 300,
"ratio": 1.3333333333333333
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2020/09/alex-shutin-204369-unsplash-330x248-crop-0-100.jpg",
"source2x": "/app/uploads/2020/09/alex-shutin-204369-unsplash-330x248-crop-0-100@2x.jpg",
"width": 330,
"height": 248,
"ratio": 1.3306451612903225
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2020/09/alex-shutin-204369-unsplash-546x410-crop-0-100.jpg",
"source2x": "/app/uploads/2020/09/alex-shutin-204369-unsplash-546x410-crop-0-100@2x.jpg",
"width": 546,
"height": 410,
"ratio": 1.3317073170731708
}
],
"lazyload": false,
"decorative": false,
"classes": []
}
Rendered
To crop an image from the focal point that has been set manually from the media library, use the f crop shorthand.
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-6 col-lg-4">
<?= ResponsivePics::get_image(1, 'xs-12, md-6, lg-4', 2|f, true); ?>
</div>
</div>
</div>
This method will output a <img> element that spans 12 columns from the xs breakpoint and up, 6 columns from the md breakpoint and up and 4 columns from the lg breakpoint and up.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<img class="lazyload" data-srcset="/app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48.jpg 330w, /app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48@2x.jpg 660w, /app/uploads/2020/10/chris-holgersson-236098-290x580-crop-16-48.jpg 290w, /app/uploads/2020/10/chris-holgersson-236098-290x580-crop-16-48@2x.jpg 580w, /app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48.jpg 330w, /app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48@2x.jpg 660w, /app/uploads/2020/10/chris-holgersson-236098-510x1020-crop-16-48.jpg 510w, /app/uploads/2020/10/chris-holgersson-236098-510x1020-crop-16-48@2x.jpg 1020w, /app/uploads/2020/10/chris-holgersson-236098-546x1092-crop-16-48.jpg 546w, /app/uploads/2020/10/chris-holgersson-236098-546x1092-crop-16-48@2x.jpg 1092w" sizes="(min-width: 1200px) 330px, (min-width: 992px) 290px, (min-width: 768px) 330px, (min-width: 576px) 510px, (min-width: 0px) 546px, 100vw" width="330" height="660" alt="Responsive background image"/>
Data
{
"alpha": false,
"alt": "Responsive background image",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48@2x.jpg",
"width": 330,
"height": 660,
"ratio": 0.5
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-290x580-crop-16-48.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-290x580-crop-16-48@2x.jpg",
"width": 290,
"height": 580,
"ratio": 0.5
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-330x660-crop-16-48@2x.jpg",
"width": 330,
"height": 660,
"ratio": 0.5
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-510x1020-crop-16-48.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-510x1020-crop-16-48@2x.jpg",
"width": 510,
"height": 1020,
"ratio": 0.5
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-546x1092-crop-16-48.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-546x1092-crop-16-48@2x.jpg",
"width": 546,
"height": 1092,
"ratio": 0.5
}
],
"lazyload": true,
"decorative": false,
"classes": [
"lazyload"
]
}
Rendered
To enable a LQIP (low quality image placeholder) for your responsive image, pass true as the 5th parameter:
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-6 col-lg-12">
<?= ResponsivePics::get_image(1, 'xs-12, md-6, lg-4', false, true, true); ?>
</div>
</div>
</div>
Now your responsive image will show as a small (pixelated) placeholder image before the actual full (sharp) image is done loading.
Additionally you could even add a ‘fade-out blur’ effect when you also enabled lazyload for the image:
img {
&.blur-up {
width: 100%;
height: auto;
&.lazyload {
opacity: 1;
filter: blur(5px);
transition: filter .75s ease;
}
&.lazyloaded {
filter: blur(0);
}
}
}
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<img class="lazyload blur-up" data-srcset="/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495.jpg 330w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495@2x.jpg 660w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-290x435.jpg 290w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-290x435@2x.jpg 580w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495.jpg 330w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495@2x.jpg 660w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-510x765.jpg 510w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-510x765@2x.jpg 1020w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-546x819.jpg 546w, /app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-546x819@2x.jpg 1092w" sizes="(min-width: 1200px) 330px, (min-width: 992px) 290px, (min-width: 768px) 330px, (min-width: 576px) 510px, (min-width: 0px) 546px, 100vw" src="/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-100x150.jpg" width="100" height="150" alt="LQIP example"/>
Data
{
"alpha": false,
"alt": "LQIP example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495.jpg",
"source2x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495@2x.jpg",
"width": 330,
"height": 495,
"ratio": 0.6666666666666666
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-290x435.jpg",
"source2x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-290x435@2x.jpg",
"width": 290,
"height": 435,
"ratio": 0.6666666666666666
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495.jpg",
"source2x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-330x495@2x.jpg",
"width": 330,
"height": 495,
"ratio": 0.6666666666666666
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-510x765.jpg",
"source2x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-510x765@2x.jpg",
"width": 510,
"height": 765,
"ratio": 0.6666666666666666
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-546x819.jpg",
"source2x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-546x819@2x.jpg",
"width": 546,
"height": 819,
"ratio": 0.6666666666666666
}
],
"lazyload": true,
"decorative": false,
"lqip": {
"breakpoint": "0",
"source1x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-100x150.jpg",
"source2x": "/app/uploads/2021/03/george-kedenburg-iii-561935-unsplash-100x150@2x.jpg",
"width": 100,
"height": 150,
"ratio": 0.6666666666666666
},
"classes": [
"lazyload",
"blur-up"
]
}
Rendered
Display an responsive picture in a normal container column layout:
<div class="container">
<div class="row">
<div class="col-xs-12 col-sm-6 col-md-4">
<?= ResponsivePics::get_picture(1, 'xs-12, sm-6, md-4'); ?>
</div>
</div>
</div>
This method will output a <picture> element that spans 12 contained columns from the xs breakpoint and up, 6 contained columns from the sm breakpoint and up and 4 contained columns from the md breakpoint and up.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 1200px)" srcset="/app/uploads/2019/06/martin-adams-740397-unsplash-330x220.jpg 1x, /app/uploads/2019/06/martin-adams-740397-unsplash-330x220@2x.jpg 2x" height="220" width="330" /> <source media="(min-width: 992px)" srcset="/app/uploads/2019/06/martin-adams-740397-unsplash-290x193.jpg 1x, /app/uploads/2019/06/martin-adams-740397-unsplash-290x193@2x.jpg 2x" height="193" width="290" /> <source media="(min-width: 768px)" srcset="/app/uploads/2019/06/martin-adams-740397-unsplash-210x140.jpg 1x, /app/uploads/2019/06/martin-adams-740397-unsplash-210x140@2x.jpg 2x" height="140" width="210" /> <source media="(min-width: 576px)" srcset="/app/uploads/2019/06/martin-adams-740397-unsplash-240x160.jpg 1x, /app/uploads/2019/06/martin-adams-740397-unsplash-240x160@2x.jpg 2x" height="160" width="240" /> <source srcset="/app/uploads/2019/06/martin-adams-740397-unsplash-546x364.jpg" height="364" width="546" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Grid system columns example" /> </picture>
Data
{
"alpha": false,
"alt": "Grid system columns example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/06/martin-adams-740397-unsplash-330x220.jpg",
"source2x": "/app/uploads/2019/06/martin-adams-740397-unsplash-330x220@2x.jpg",
"width": 330,
"height": 220,
"ratio": 1.5
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/06/martin-adams-740397-unsplash-290x193.jpg",
"source2x": "/app/uploads/2019/06/martin-adams-740397-unsplash-290x193@2x.jpg",
"width": 290,
"height": 193,
"ratio": 1.5025906735751295
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/06/martin-adams-740397-unsplash-210x140.jpg",
"source2x": "/app/uploads/2019/06/martin-adams-740397-unsplash-210x140@2x.jpg",
"width": 210,
"height": 140,
"ratio": 1.5
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2019/06/martin-adams-740397-unsplash-240x160.jpg",
"source2x": "/app/uploads/2019/06/martin-adams-740397-unsplash-240x160@2x.jpg",
"width": 240,
"height": 160,
"ratio": 1.5
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/martin-adams-740397-unsplash-546x364.jpg",
"source2x": "/app/uploads/2019/06/martin-adams-740397-unsplash-546x364@2x.jpg",
"width": 546,
"height": 364,
"ratio": 1.5
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
When your image is in a full-width fluid container, you can use the -full suffix:
<div class="container-fluid">
<div class="row">
<div class="col-xs-12 col-sm-6 col-md-4">
<?= ResponsivePics::get_picture(1, 'xs-12-full, sm-6-full, md-4-full'); ?>
</div>
</div>
</div>
This method will output a <picture> element that spans 12 full-width columns from the xs breakpoint and up, 6 full-width columns from the sm breakpoint and up and 4 full-width columns from the md breakpoint and up.
Since the largest default breakpoint
xxl is 1400px, the width of the image will never exceed the 12 full-width columns of 1400px (1370px) with this method. To prevent this, you need to add custom breakpoints higher then xxl.Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 1200px)" srcset="/app/uploads/2019/07/aziz-acharki-549137-unsplash-436x281.jpg 1x, /app/uploads/2019/07/aziz-acharki-549137-unsplash-436x281@2x.jpg 2x" height="281" width="436" /> <source media="(min-width: 992px)" srcset="/app/uploads/2019/07/aziz-acharki-549137-unsplash-370x238.jpg 1x, /app/uploads/2019/07/aziz-acharki-549137-unsplash-370x238@2x.jpg 2x" height="238" width="370" /> <source media="(min-width: 768px)" srcset="/app/uploads/2019/07/aziz-acharki-549137-unsplash-300x193.jpg 1x, /app/uploads/2019/07/aziz-acharki-549137-unsplash-300x193@2x.jpg 2x" height="193" width="300" /> <source media="(min-width: 576px)" srcset="/app/uploads/2019/07/aziz-acharki-549137-unsplash-354x228.jpg 1x, /app/uploads/2019/07/aziz-acharki-549137-unsplash-354x228@2x.jpg 2x" height="228" width="354" /> <source srcset="/app/uploads/2019/07/aziz-acharki-549137-unsplash-546x352.jpg" height="352" width="546" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Full width image example" /> </picture>
Data
{
"alpha": false,
"alt": "Full width image example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-436x281.jpg",
"source2x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-436x281@2x.jpg",
"width": 436,
"height": 281,
"ratio": 1.5516014234875444
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-370x238.jpg",
"source2x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-370x238@2x.jpg",
"width": 370,
"height": 238,
"ratio": 1.5546218487394958
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-300x193.jpg",
"source2x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-300x193@2x.jpg",
"width": 300,
"height": 193,
"ratio": 1.5544041450777202
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-354x228.jpg",
"source2x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-354x228@2x.jpg",
"width": 354,
"height": 228,
"ratio": 1.5526315789473684
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-546x352.jpg",
"source2x": "/app/uploads/2019/07/aziz-acharki-549137-unsplash-546x352@2x.jpg",
"width": 546,
"height": 352,
"ratio": 1.5511363636363635
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
When your image is not in a container and you want to display your image full-width, you can use the full shorthand:
<div> <?= ResponsivePics::get_picture(1, 'xs-full'); ?> </div>
This method will output a <picture> element that spans the full-width defined by the next breakpoint width from the xs breakpoint and up.
Since the largest default breakpoint
xxl is 1400px, the width of the image will never exceed the 1400px with this method. To prevent this, you need to add custom breakpoints higher then xxl.Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 1200px)" srcset="/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1400x1051.jpg 1x, /app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1400x1051@2x.jpg 2x" height="1051" width="1400" /> <source media="(min-width: 992px)" srcset="/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1200x901.jpg 1x, /app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1200x901@2x.jpg 2x" height="901" width="1200" /> <source media="(min-width: 768px)" srcset="/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-992x745.jpg 1x, /app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-992x745@2x.jpg 2x" height="745" width="992" /> <source media="(min-width: 576px)" srcset="/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-768x577.jpg 1x, /app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-768x577@2x.jpg 2x" height="577" width="768" /> <source srcset="/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-576x432.jpg" height="432" width="576" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Full-width image example" /> </picture>
Data
{
"alpha": false,
"alt": "Full-width image example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1400x1051.jpg",
"source2x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1400x1051@2x.jpg",
"width": 1400,
"height": 1051,
"ratio": 1.3320647002854424
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1200x901.jpg",
"source2x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-1200x901@2x.jpg",
"width": 1200,
"height": 901,
"ratio": 1.3318534961154274
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-992x745.jpg",
"source2x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-992x745@2x.jpg",
"width": 992,
"height": 745,
"ratio": 1.3315436241610739
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-768x577.jpg",
"source2x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-768x577@2x.jpg",
"width": 768,
"height": 577,
"ratio": 1.3310225303292895
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-576x432.jpg",
"source2x": "/app/uploads/2020/11/willian-justen-de-vasconcellos-515780-unsplash-576x432@2x.jpg",
"width": 576,
"height": 432,
"ratio": 1.3333333333333333
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
When your image is not in a normal container or column layout, you can also use custom image widths:
<?= ResponsivePics::get_picture(1, 'xs:500, sm:725, md:950'); ?>
This method will output a <picture> element of 500px from the xs breakpoint and up, 725px from the sm breakpoint and up and 950px from the md breakpoint and up.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 768px)" srcset="/app/uploads/2019/06/hyunwon-jang-741306-unsplash-950x633.jpg 1x, /app/uploads/2019/06/hyunwon-jang-741306-unsplash-950x633@2x.jpg 2x" height="633" width="950" /> <source media="(min-width: 576px)" srcset="/app/uploads/2019/06/hyunwon-jang-741306-unsplash-725x483.jpg 1x, /app/uploads/2019/06/hyunwon-jang-741306-unsplash-725x483@2x.jpg 2x" height="483" width="725" /> <source srcset="/app/uploads/2019/06/hyunwon-jang-741306-unsplash-500x333.jpg" height="333" width="500" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Custom image sizes example" /> </picture>
Data
{
"alpha": false,
"alt": "Custom image sizes example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/06/hyunwon-jang-741306-unsplash-950x633.jpg",
"source2x": "/app/uploads/2019/06/hyunwon-jang-741306-unsplash-950x633@2x.jpg",
"width": 950,
"height": 633,
"ratio": 1.5007898894154819
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2019/06/hyunwon-jang-741306-unsplash-725x483.jpg",
"source2x": "/app/uploads/2019/06/hyunwon-jang-741306-unsplash-725x483@2x.jpg",
"width": 725,
"height": 483,
"ratio": 1.5010351966873705
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/hyunwon-jang-741306-unsplash-500x333.jpg",
"source2x": "/app/uploads/2019/06/hyunwon-jang-741306-unsplash-500x333@2x.jpg",
"width": 500,
"height": 333,
"ratio": 1.5015015015015014
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
You can also mix container column image widths with custom image widths:
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-6 col-lg-12">
<?= ResponsivePics::get_picture(1, 'xs-12, md-6, lg:800, xl:1024'); ?>
</div>
</div>
</div>
This method will output a <picture> element that spans 12 columns from the xs breakpoint and up, 6 columns from the md breakpoint and up, 800px from the lg breakpoint and up and 1000px from the xl breakpoint and up.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 1200px)" srcset="/app/uploads/2019/06/kyler-nixon-208875-unsplash-1024x682.jpg 1x, /app/uploads/2019/06/kyler-nixon-208875-unsplash-1024x682@2x.jpg 2x" height="682" width="1024" /> <source media="(min-width: 992px)" srcset="/app/uploads/2019/06/kyler-nixon-208875-unsplash-800x533.jpg 1x, /app/uploads/2019/06/kyler-nixon-208875-unsplash-800x533@2x.jpg 2x" height="533" width="800" /> <source media="(min-width: 768px)" srcset="/app/uploads/2019/06/kyler-nixon-208875-unsplash-330x220.jpg 1x, /app/uploads/2019/06/kyler-nixon-208875-unsplash-330x220@2x.jpg 2x" height="220" width="330" /> <source srcset="/app/uploads/2019/06/kyler-nixon-208875-unsplash-546x364.jpg" height="364" width="546" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Combined image sizes example" /> </picture>
Data
{
"alpha": false,
"alt": "Combined image sizes example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-1024x682.jpg",
"source2x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-1024x682@2x.jpg",
"width": 1024,
"height": 682,
"ratio": 1.501466275659824
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-800x533.jpg",
"source2x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-800x533@2x.jpg",
"width": 800,
"height": 533,
"ratio": 1.5009380863039399
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-330x220.jpg",
"source2x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-330x220@2x.jpg",
"width": 330,
"height": 220,
"ratio": 1.5
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-546x364.jpg",
"source2x": "/app/uploads/2019/06/kyler-nixon-208875-unsplash-546x364@2x.jpg",
"width": 546,
"height": 364,
"ratio": 1.5
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
When your picture needs to change size on a non-default breakpoint, you can also use custom breakpoints:
<?= ResponsivePics::get_picture(1, '400:200, 800:400'); ?>
This method will output a <picture> element that spans 200px from 400px breakpoint and up and 400px from 800px breakpoint and up.
Since we didn’t define any image size before breakpoint 400px, the image won’t be resized from breakpoint 0px to 400px which will be bad for performance.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 800px)" srcset="/app/uploads/2019/06/denys-nevozhai-189623-unsplash-400x284.jpg 1x, /app/uploads/2019/06/denys-nevozhai-189623-unsplash-400x284@2x.jpg 2x" height="284" width="400" /> <source media="(min-width: 400px)" srcset="/app/uploads/2019/06/denys-nevozhai-189623-unsplash-200x142.jpg 1x, /app/uploads/2019/06/denys-nevozhai-189623-unsplash-200x142@2x.jpg 2x" height="142" width="200" /> <source srcset="/app/uploads/2019/06/denys-nevozhai-189623-unsplash.jpg" height="3167" width="4450" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Custom breakpoints example" /> </picture>
Data
{
"alpha": false,
"alt": "Custom breakpoints example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": "800",
"source1x": "/app/uploads/2019/06/denys-nevozhai-189623-unsplash-400x284.jpg",
"source2x": "/app/uploads/2019/06/denys-nevozhai-189623-unsplash-400x284@2x.jpg",
"width": 400,
"height": 284,
"ratio": 1.408450704225352
},
{
"breakpoint": "400",
"source1x": "/app/uploads/2019/06/denys-nevozhai-189623-unsplash-200x142.jpg",
"source2x": "/app/uploads/2019/06/denys-nevozhai-189623-unsplash-200x142@2x.jpg",
"width": 200,
"height": 142,
"ratio": 1.408450704225352
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/denys-nevozhai-189623-unsplash.jpg",
"width": 4450,
"height": 3167,
"ratio": 1.4051152510262077
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
When you want to limit the height of your picture without cropping it, you can set the (maximum) image height:
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-8 col-lg-12">
<?= ResponsivePics::get_picture(1, 'xs-12 800, md-8 500, lg:400 400, xl:600/0.75'); ?>
</div>
</div>
</div>
This method will output a <picture> element that spans 12 columns and a max height of 800px from the xs breakpoint and up, 8 columns and a max height of 500px from the md breakpoint and up, 400px and a max height of 400px from the lg breakpoint and up and 600px and a max height of 600px * 0.75 (= 450px) from the xl breakpoint and up.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 1200px)" srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-600x450.jpg 1x, /app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-600x450@2x.jpg 2x" height="450" width="600" /> <source media="(min-width: 992px)" srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400.jpg 1x, /app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400@2x.jpg 2x" height="400" width="400" /> <source media="(min-width: 768px)" srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500.jpg 1x, /app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500@2x.jpg 2x" height="500" width="450" /> <source srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-546x800.jpg" height="800" width="546" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Custom image heights example" /> </picture>
Data
{
"alpha": false,
"alt": "Custom image heights example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-600x450.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-600x450@2x.jpg",
"width": 600,
"height": 450,
"ratio": 1.3333333333333333
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400@2x.jpg",
"width": 400,
"height": 400,
"ratio": 1
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500@2x.jpg",
"width": 450,
"height": 500,
"ratio": 0.9
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-546x800.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-546x800@2x.jpg",
"width": 546,
"height": 800,
"ratio": 0.6825
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
When you want full control over your picture dimensions, you can enable cropping:
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-8 col-lg-12">
<?= ResponsivePics::get_picture(1, 'xs-12 800|c, md-8 500|c, lg:400 400|l t, xl:500/0.75|r b'); ?>
</div>
</div>
</div>
This method will output a <picture> element that spans 12 columns and with a height of 800px cropped from the center from the xs breakpoint and up, 8 columns and a height of 500px cropped from the center from the md breakpoint and up, 400px and a height of 400px cropped from the left top from the lg breakpoint and up and 600px and a height of 600px * 0.75 (= 450px) cropped from the right bottom from the xl breakpoint and up.
When setting a height and a crop, ResponsivePics will try to resize and crop the image to the desired width and height only if the original image dimensions allow it. If not, it will resize and crop to the largest possible size while keeping the desired crop ratio.
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 1200px)" srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-500x375-crop-100-100.jpg 1x, /app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-500x375-crop-100-100@2x.jpg 2x" height="375" width="500" /> <source media="(min-width: 992px)" srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400-crop-0-0.jpg 1x, /app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400-crop-0-0@2x.jpg 2x" height="400" width="400" /> <source media="(min-width: 768px)" srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500-center-center.jpg 1x, /app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500-center-center@2x.jpg 2x" height="500" width="450" /> <source srcset="/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-546x800-center-center.jpg" height="800" width="546" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Custom image heights example" /> </picture>
Data
{
"alpha": false,
"alt": "Custom image heights example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-500x375-crop-100-100.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-500x375-crop-100-100@2x.jpg",
"width": 500,
"height": 375,
"ratio": 1.3333333333333333
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400-crop-0-0.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-400x400-crop-0-0@2x.jpg",
"width": 400,
"height": 400,
"ratio": 1
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500-center-center.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-450x500-center-center@2x.jpg",
"width": 450,
"height": 500,
"ratio": 0.9
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-546x800-center-center.jpg",
"source2x": "/app/uploads/2019/06/h-e-n-g-s-t-r-e-a-m-744456-unsplash-546x800-center-center@2x.jpg",
"width": 546,
"height": 800,
"ratio": 0.6825
}
],
"lazyload": false,
"intrinsic": false,
"picture_classes": [],
"image_classes": []
}
Rendered
When you want to make sure that a certain part of your image is always visible while cropping, you can use the f crop shorthand.
You can manually set the crop point in the WordPress media library:
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-6 col-lg-4">
<?= ResponsivePics::get_picture(1, 'xs-12/0.5|f, md-6/1|f, lg-4/2|f', null, true); ?>
</div>
</div>
</div>
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<picture> <source media="(min-width: 1200px)" data-srcset="/app/uploads/2022/01/linus-nylund-437333-unsplash-330x660-crop-64-40.jpg 1x, /app/uploads/2022/01/linus-nylund-437333-unsplash-330x660-crop-64-40@2x.jpg 2x" height="660" width="330" /> <source media="(min-width: 992px)" data-srcset="/app/uploads/2022/01/linus-nylund-437333-unsplash-290x580-crop-64-40.jpg 1x, /app/uploads/2022/01/linus-nylund-437333-unsplash-290x580-crop-64-40@2x.jpg 2x" height="580" width="290" /> <source media="(min-width: 768px)" data-srcset="/app/uploads/2022/01/linus-nylund-437333-unsplash-330x330-crop-64-40.jpg 1x, /app/uploads/2022/01/linus-nylund-437333-unsplash-330x330-crop-64-40@2x.jpg 2x" height="330" width="330" /> <source media="(min-width: 576px)" data-srcset="/app/uploads/2022/01/linus-nylund-437333-unsplash-510x255-crop-64-40.jpg 1x, /app/uploads/2022/01/linus-nylund-437333-unsplash-510x255-crop-64-40@2x.jpg 2x" height="255" width="510" /> <source data-srcset="/app/uploads/2022/01/linus-nylund-437333-unsplash-546x273-crop-64-40.jpg" height="273" width="546" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" class="lazyload" /> </picture>
Data
{
"alpha": false,
"alt": "",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-330x660-crop-64-40.jpg",
"source2x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-330x660-crop-64-40@2x.jpg",
"width": 330,
"height": 660,
"ratio": 0.5
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-290x580-crop-64-40.jpg",
"source2x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-290x580-crop-64-40@2x.jpg",
"width": 290,
"height": 580,
"ratio": 0.5
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-330x330-crop-64-40.jpg",
"source2x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-330x330-crop-64-40@2x.jpg",
"width": 330,
"height": 330,
"ratio": 1
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-510x255-crop-64-40.jpg",
"source2x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-510x255-crop-64-40@2x.jpg",
"width": 510,
"height": 255,
"ratio": 2
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-546x273-crop-64-40.jpg",
"source2x": "/app/uploads/2022/01/linus-nylund-437333-unsplash-546x273-crop-64-40@2x.jpg",
"width": 546,
"height": 273,
"ratio": 2
}
],
"lazyload": true,
"intrinsic": false,
"picture_classes": [],
"image_classes": [
"lazyload"
]
}
Rendered
To enable lazy loading for your responsive picture, pass true as the 4th parameter:
<div class="container">
<div class="row">
<div class="col-xs-12 col-lg-10 col-xl-8">
<?= ResponsivePics::get_picture(1, 'xs-12, lg-10, xl-8', 'lazyload-effect', true); ?>
</div>
</div>
</div>
Now your responsive image will only load when it’s in the viewport and thus will increase performance on your website!
Additionally you could even add a fade-in css effect once the image is lazyloaded:
picture.lazyload-effect {
img {
&.lazyload,
&.lazyloading {
opacity: 0;
transition: opacity .75s ease;
}
&.lazyloaded {
opacity: 1;
}
}
}
Depending on the maximum size of the uploaded image with ID 1, the output with special lazyload markup will be something like:
HTML
<picture class="lazyload-effect"> <source media="(min-width: 1200px)" data-srcset="/app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460.jpg 1x, /app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460@2x.jpg 2x" height="460" width="690" /> <source media="(min-width: 992px)" data-srcset="/app/uploads/2019/06/joshua-coleman-654602-unsplash-770x513.jpg 1x, /app/uploads/2019/06/joshua-coleman-654602-unsplash-770x513@2x.jpg 2x" height="513" width="770" /> <source media="(min-width: 768px)" data-srcset="/app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460.jpg 1x, /app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460@2x.jpg 2x" height="460" width="690" /> <source media="(min-width: 576px)" data-srcset="/app/uploads/2019/06/joshua-coleman-654602-unsplash-510x340.jpg 1x, /app/uploads/2019/06/joshua-coleman-654602-unsplash-510x340@2x.jpg 2x" height="340" width="510" /> <source data-srcset="/app/uploads/2019/06/joshua-coleman-654602-unsplash-546x364.jpg" height="364" width="546" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="Lazyloading example" class="lazyload" /> </picture>
Data
{
"alpha": false,
"alt": "Lazyloading example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460.jpg",
"source2x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460@2x.jpg",
"width": 690,
"height": 460,
"ratio": 1.5
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-770x513.jpg",
"source2x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-770x513@2x.jpg",
"width": 770,
"height": 513,
"ratio": 1.5009746588693957
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460.jpg",
"source2x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-690x460@2x.jpg",
"width": 690,
"height": 460,
"ratio": 1.5
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-510x340.jpg",
"source2x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-510x340@2x.jpg",
"width": 510,
"height": 340,
"ratio": 1.5
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-546x364.jpg",
"source2x": "/app/uploads/2019/06/joshua-coleman-654602-unsplash-546x364@2x.jpg",
"width": 546,
"height": 364,
"ratio": 1.5
}
],
"lazyload": true,
"intrinsic": false,
"picture_classes": [
"lazyload-effect"
],
"image_classes": [
"lazyload"
]
}
Rendered
To enable intrinsic aspect ratio for your responsive picture, pass true as the 5th parameter:
<div class="container">
<div class="row">
<div class="col-xs-12 col-lg-10 col-xl-8">
<?= ResponsivePics::get_picture(1, 'xs-12, lg-10, xl-8', '', true, true); ?>
</div>
</div>
</div>
When you installed the Lazysizes aspectratio extension, it will try to calculate each picture’s image element’s height based upon each data-aspectratio attribute and set the height as an inline style. This way the image already takes up space in your layout.
Additionally you could even add some placeholder styling when the image is not loaded yet, but does have a height already:
picture.intrinsic {
position: relative;
display: block;
margin: 0;
width: 100%;
background: #e4e4e4 url('../images/icon.svg') no-repeat center;
background-size: 50px 50px;
&__item {
display: block;
width: 100%;
}
}
Depending on the maximum size of the uploaded image with ID 1, the output with special intrinsic markup will be something like:
HTML
<picture class="intrinsic"> <source media="(min-width: 1200px)" data-srcset="/app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035.jpg 1x, /app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035@2x.jpg 2x" height="1035" width="690" data-aspectratio="0.66666666666667" /> <source media="(min-width: 992px)" data-srcset="/app/uploads/2019/06/lionel-gustave-171878-unsplash-770x1155.jpg 1x, /app/uploads/2019/06/lionel-gustave-171878-unsplash-770x1155@2x.jpg 2x" height="1155" width="770" data-aspectratio="0.66666666666667" /> <source media="(min-width: 768px)" data-srcset="/app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035.jpg 1x, /app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035@2x.jpg 2x" height="1035" width="690" data-aspectratio="0.66666666666667" /> <source media="(min-width: 576px)" data-srcset="/app/uploads/2019/06/lionel-gustave-171878-unsplash-510x765.jpg 1x, /app/uploads/2019/06/lionel-gustave-171878-unsplash-510x765@2x.jpg 2x" height="765" width="510" data-aspectratio="0.66666666666667" /> <source data-srcset="/app/uploads/2019/06/lionel-gustave-171878-unsplash-546x819.jpg" height="819" width="546" data-aspectratio="0.66666666666667" /> <img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" data-aspectratio="" alt="Intrinsic example" class="lazyload intrinsic__item" style="width:100%;" /> </picture>
Data
{
"alpha": false,
"alt": "Intrinsic example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035.jpg",
"source2x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035@2x.jpg",
"width": 690,
"height": 1035,
"ratio": 0.6666666666666666
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-770x1155.jpg",
"source2x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-770x1155@2x.jpg",
"width": 770,
"height": 1155,
"ratio": 0.6666666666666666
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035.jpg",
"source2x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-690x1035@2x.jpg",
"width": 690,
"height": 1035,
"ratio": 0.6666666666666666
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-510x765.jpg",
"source2x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-510x765@2x.jpg",
"width": 510,
"height": 765,
"ratio": 0.6666666666666666
},
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-546x819.jpg",
"source2x": "/app/uploads/2019/06/lionel-gustave-171878-unsplash-546x819@2x.jpg",
"width": 546,
"height": 819,
"ratio": 0.6666666666666666
}
],
"lazyload": true,
"intrinsic": true,
"picture_classes": [
"intrinsic"
],
"image_classes": [
"lazyload",
"intrinsic__item"
]
}
Rendered
When you want to create a responsive background image, you can use the get_background function.
For displaying a responsive background image in a normal container column layout:
<div class="container">
<div class="row">
<div class="col-xs-12 col-md-8 col-lg-4 col-xl-6">
<?= ResponsivePics::get_background(1, 'xs-12, md-8, lg-4, xl-6', 'responsive-bg-example'); ?>
</div>
</div>
</div>
Don’t forget to style your background image otherwise you won’t see anything. You can do this by passing a css class as the 3rd parameter:
.responsive-bg-example {
display: block;
width: 100%;
overflow: hidden;
height: 0;
padding-top: 75%;
background-repeat: no-repeat;
background-position: center;
background-size: cover;
}
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<style scoped="scoped" type="text/css">
@media (min-width: 0px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-546x364.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 0px), only screen and (min-resolution: 192dpi) and (min-width: 0px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-546x364@2x.jpg");}
}
@media (min-width: 576px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-510x340.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 576px), only screen and (min-resolution: 192dpi) and (min-width: 576px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-510x340@2x.jpg");}
}
@media (min-width: 768px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-450x300.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 768px), only screen and (min-resolution: 192dpi) and (min-width: 768px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-450x300@2x.jpg");}
}
@media (min-width: 992px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-290x193.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 992px), only screen and (min-resolution: 192dpi) and (min-width: 992px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-290x193@2x.jpg");}
}
@media (min-width: 1200px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-510x340.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 1200px), only screen and (min-resolution: 192dpi) and (min-width: 1200px) {
#responsive-pics-background-708 {background-image: url("/app/uploads/2020/10/chris-holgersson-236098-510x340@2x.jpg");}
}
}
</style>
<div id="responsive-pics-background-708" class="responsive-bg-example"></div>
Data
{
"alpha": false,
"alt": "Responsive background image",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 0,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-546x364.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-546x364@2x.jpg",
"width": 546,
"height": 364,
"ratio": 1.5
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-510x340.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-510x340@2x.jpg",
"width": 510,
"height": 340,
"ratio": 1.5
},
{
"breakpoint": 768,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-450x300.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-450x300@2x.jpg",
"width": 450,
"height": 300,
"ratio": 1.5
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-290x193.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-290x193@2x.jpg",
"width": 290,
"height": 193,
"ratio": 1.5025906735751295
},
{
"breakpoint": 1200,
"source1x": "/app/uploads/2020/10/chris-holgersson-236098-510x340.jpg",
"source2x": "/app/uploads/2020/10/chris-holgersson-236098-510x340@2x.jpg",
"width": 510,
"height": 340,
"ratio": 1.5
}
],
"id": "responsive-pics-background-708-1",
"classes": [
"responsive-bg-example"
]
}
Rendered
In this example, we will be creating a full-width banner background image with a responsive aspect ratio:
<?= ResponsivePics::get_background(1, 'xs-full/0.65|c, sm-full/0.5|c, md-full|c, lg-full/0.5|c, xl:1500/0.35|c, 1500:1750/0.35|c, 1750:2000/0.3|c, 2000:2500/0.25|c', 'my-hero-bg-example'); ?>
When you pass a class as the 3rd parameter, you can style the div that contains the background image:
.my-hero-bg-example {
display: block;
width: 100%;
height: 65vw;
background-image: url('data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7');
background-repeat: no-repeat;
background-position: center;
background-size: cover;
transition: background-image .75s ease;
@include media-breakpoint-up(sm) {
height: 50vw;
}
@include media-breakpoint-up(lg) {
height: 40vw;
}
@include media-breakpoint-up(xl) {
height: 35vw;
}
@media (min-width: 1600px) {
height: 30vw;
}
@media (min-width: 2000px) {
height: 25vw;
}
}
Depending on the maximum size of the uploaded image with ID 1, the output will be something like:
HTML
<style scoped="scoped" type="text/css">
@media (min-width: 0px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-576x374-center-center.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 0px), only screen and (min-resolution: 192dpi) and (min-width: 0px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-576x374-center-center@2x.jpg");}
}
@media (min-width: 576px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-768x384-center-center.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 576px), only screen and (min-resolution: 192dpi) and (min-width: 576px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-768x384-center-center@2x.jpg");}
}
@media (min-width: 992px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-1200x480-center-center.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 992px), only screen and (min-resolution: 192dpi) and (min-width: 992px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-1200x480-center-center@2x.jpg");}
}
@media (min-width: 1200px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-1500x525-center-center.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 1200px), only screen and (min-resolution: 192dpi) and (min-width: 1200px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-1500x525-center-center@2x.jpg");}
}
@media (min-width: 1500px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-1750x612-center-center.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 1500px), only screen and (min-resolution: 192dpi) and (min-width: 1500px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-1750x612-center-center@2x.jpg");}
}
@media (min-width: 1750px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-2000x600-center-center.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 1750px), only screen and (min-resolution: 192dpi) and (min-width: 1750px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-2000x600-center-center@2x.jpg");}
}
@media (min-width: 2000px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-2500x625-center-center.jpg");}
}
@media only screen and (-webkit-min-device-pixel-ratio: 2) and (min-width: 2000px), only screen and (min-resolution: 192dpi) and (min-width: 2000px) {
#responsive-pics-background-581 {background-image: url("/app/uploads/2019/07/fuyong-hua-274676-unsplash-2500x625-center-center@2x.jpg");}
}
}
</style>
<div id="responsive-pics-background-581" class="my-hero-bg-example"></div>
Data
{
"alpha": false,
"alt": "Background image example",
"animated": false,
"mimetype": "image/jpeg",
"sources": [
{
"breakpoint": 0,
"source1x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-576x374-center-center.jpg",
"source2x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-576x374-center-center@2x.jpg",
"width": 576,
"height": 374,
"ratio": 1.5401069518716577
},
{
"breakpoint": 576,
"source1x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-768x384-center-center.jpg",
"source2x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-768x384-center-center@2x.jpg",
"width": 768,
"height": 384,
"ratio": 2
},
{
"breakpoint": 992,
"source1x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-1200x480-center-center.jpg",
"source2x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-1200x480-center-center@2x.jpg",
"width": 1200,
"height": 480,
"ratio": 2.5
},
{
"breakpoint": 1200,
"source1x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-1500x525-center-center.jpg",
"source2x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-1500x525-center-center@2x.jpg",
"width": 1500,
"height": 525,
"ratio": 2.857142857142857
},
{
"breakpoint": "1500",
"source1x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-1750x612-center-center.jpg",
"source2x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-1750x612-center-center@2x.jpg",
"width": 1750,
"height": 612,
"ratio": 2.8594771241830066
},
{
"breakpoint": "1750",
"source1x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-2000x600-center-center.jpg",
"source2x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-2000x600-center-center@2x.jpg",
"width": 2000,
"height": 600,
"ratio": 3.3333333333333335
},
{
"breakpoint": "2000",
"source1x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-2500x625-center-center.jpg",
"source2x": "/app/uploads/2019/07/fuyong-hua-274676-unsplash-2500x625-center-center@2x.jpg",
"width": 2500,
"height": 625,
"ratio": 4
}
],
"id": "responsive-pics-background-581-1",
"classes": [
"my-hero-bg-example"
]
}