All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.
4.3.1 - January 30, 2023
- Allow disabling path encoding in ix_image_url ([#125] (#125))
4.3.0 - December 14, 2022
- Add img_tag_options to ix_picture_tag ([#118] (#118))
4.2.0 - January 05, 2021
- Add support for lazy image loading (#108)
4.1.0 - October 13, 2020
Version 4.1.0 has been released! The goal of this release is to offer flexibility to those using imgix-rb's purger capabilities through imgix-rails.
Prior to this release, this gem offered purging capability through imgix '~> 3.0'
. However, that purging capability has been deprecated in favor of the new-style purging API––available now in imgix-rb v4.0.0.
To upgrade to the new purging API used in imgix '~> 4.0'
:
- navigate to the API Keys portion of your dashboard
- generate a new API Key
- use this new key in your imgix client:
Imgix::Client.new(domain: '...', api_key: NEW_API_KEY)
- build: use optimistic constraint for imgix >= 3.0 (#104)
4.0.2 - July 31, 2020
- fix: replace
opts[:host
] withopts[:domain]
to resolve deprecation warnings (#96)
4.0.1 - June 10, 2020
- fix: update rake version (#94)
4.0.0 - December 03, 2019
The v4.0.0 release of imgix-rails introduces a variety of improvements relating to how this gem handles and generates srcset
attributes. However, in releasing this version there are some significant interface/behavioral changes that users need to be aware of. Users should note that the min_width
and max_width
fields (passed via tag_options
), as well as the widths
field, have all been moved to their own encompassing srcset_options
field. This is done with the intention of providing a more organized and intuitive experience when fine-tuning how srcset
width pairs are generated. See the following example demonstrating this new pattern:
<%= ix_image_tag('/unsplash/hotairballoon.jpg',
srcset_options: { min_width: 1000, max_width: 2500},
tag_options: { alt: 'A hot air balloon on a sunny day' }) %>
For users migrating to version 4.0 or later, it is important that all srcset-related modifiers be passed via srcset_options
, as doing so through tag_options
or widths
directly will result in errors. For more details on these modifiers, please see the ix_image_tag or ix_picture_tag sections.
In addition to these changes, imgix-rails is now capable of producing fixed-image srcsets. Users should note that when certain dimension information is provided, imgix-rails will produce a srcset
at different screen resolutions rather than the typical width pairs. This feature provides expanded functionality to cover more srcset
use cases that users can take advantage of. We are always happy to provide our users with more tools to assist them in their efforts to build out responsive images on the web.
- feat: utilize Imgix::Path#to_srcset when constructing srcsets (#83)
- chore: remove deprecated domain sharding behavior (#80)
- fix: deprecate resizing height when maintaining aspect ratio (#78)