Unverified Commit 381d1f9a authored by Steven's avatar Steven Committed by GitHub

feat(next/image): add support for `decoding` prop (#70678)

- Backport https://github.com/vercel/next.js/pull/70298 to `14.2.x`
parent dbbec6ad
...@@ -461,13 +461,24 @@ For example, when upgrading an existing website from `<img>` to `<Image>`, you m ...@@ -461,13 +461,24 @@ For example, when upgrading an existing website from `<img>` to `<Image>`, you m
/> />
``` ```
### decoding
A hint to the browser indicating if it should wait for the image to be decoded before presenting other content updates or not. Defaults to `async`.
Possible values are the following:
- `async` - Asynchronously decode the image and allow other content to be rendered before it completes.
- `sync` - Synchronously decode the image for atomic presentation with other content.
- `auto` - No preference for the decoding mode; the browser decides what's best.
Learn more about the [`decoding` attribute](https://developer.mozilla.org/docs/Web/HTML/Element/img#loading).
### Other Props ### Other Props
Other properties on the `<Image />` component will be passed to the underlying Other properties on the `<Image />` component will be passed to the underlying
`img` element with the exception of the following: `img` element with the exception of the following:
- `srcSet`. Use [Device Sizes](#devicesizes) instead. - `srcSet`. Use [Device Sizes](#devicesizes) instead.
- `decoding`. It is always `"async"`.
## Configuration Options ## Configuration Options
...@@ -1020,6 +1031,7 @@ This `next/image` component uses browser native [lazy loading](https://caniuse.c ...@@ -1020,6 +1031,7 @@ This `next/image` component uses browser native [lazy loading](https://caniuse.c
| Version | Changes | | Version | Changes |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `v14.2.15` | `decoding` prop added. |
| `v14.2.0` | `overrideSrc` prop added. | | `v14.2.0` | `overrideSrc` prop added. |
| `v14.1.0` | `getImageProps()` is stable. | | `v14.1.0` | `getImageProps()` is stable. |
| `v14.0.0` | `onLoadingComplete` prop and `domains` config deprecated. | | `v14.0.0` | `onLoadingComplete` prop and `domains` config deprecated. |
......
...@@ -252,6 +252,7 @@ export function getImgProps( ...@@ -252,6 +252,7 @@ export function getImgProps(
placeholder = 'empty', placeholder = 'empty',
blurDataURL, blurDataURL,
fetchPriority, fetchPriority,
decoding = 'async',
layout, layout,
objectFit, objectFit,
objectPosition, objectPosition,
...@@ -673,7 +674,7 @@ export function getImgProps( ...@@ -673,7 +674,7 @@ export function getImgProps(
fetchPriority, fetchPriority,
width: widthInt, width: widthInt,
height: heightInt, height: heightInt,
decoding: 'async', decoding,
className, className,
style: { ...imgStyle, ...placeholderStyle }, style: { ...imgStyle, ...placeholderStyle },
sizes: imgAttributes.sizes, sizes: imgAttributes.sizes,
......
...@@ -277,4 +277,27 @@ describe('getImageProps()', () => { ...@@ -277,4 +277,27 @@ describe('getImageProps()', () => {
['src', '/override.png'], ['src', '/override.png'],
]) ])
}) })
it('should handle decoding=sync', async () => {
const { props } = getImageProps({
alt: 'a nice desc',
src: '/test.png',
decoding: 'sync',
width: 100,
height: 200,
})
expect(warningMessages).toStrictEqual([])
expect(Object.entries(props)).toStrictEqual([
['alt', 'a nice desc'],
['loading', 'lazy'],
['width', 100],
['height', 200],
['decoding', 'sync'],
['style', { color: 'transparent' }],
[
'srcSet',
'/_next/image?url=%2Ftest.png&w=128&q=75 1x, /_next/image?url=%2Ftest.png&w=256&q=75 2x',
],
['src', '/_next/image?url=%2Ftest.png&w=256&q=75'],
])
})
}) })
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment