DEV Community

Cover image for How to add Next.js 11 image component to your website
milindsoorya
milindsoorya

Posted on • Updated on • Originally published at milindsoorya.com

How to add Next.js 11 image component to your website

Next.js gives you the best developer experience with all the features you need for production: hybrid static & server rendering, TypeScript support, smart bundling, route pre-fetching, and more. No config needed.

With the latest version of Next.js, this react framework has become even more desirable due to addition of features to accelerate performance and developer collaboration.

In this article, we'll discuss:

  1. New Innovations in Next.js 11
  2. next/image Improvements
  3. Adding Next.js 11 image component to your project
  4. Using next/image with MDX

So let's dive in.

New Innovations in Next.js 11

  • Conformance: A system that provides carefully crafted solutions to support optimal UX.
  • Improved Performance: Further optimisations to improve cold startup time so you can start coding faster.
  • next/script: Automatically prioritise loading of third-party scripts to improve performance.
  • next/image: Reduce layout shift and create a smoother visual experience with automatic size detection and support for blur-up placeholders.
  • Webpack 5: Now enabled by default for all Next.js applications, bringing these benefits to all Next.js developers.
  • Create React App Migration (Experimental): Automatically convert Create React App to be Next.js compatible.
  • Next.js Live (Preview Release): Code in the browser, with your team, in real time.

next/image Improvements

The improvements made to next/image component is my favourite addition. In this latest iteration of Next.js, image component has been updated to reduce Cumulative Layout Shift and create a smoother visual experience.

I use MDX for my blog and serves the images from the public folder, one downfall of this approach was that to overcome Cumulative Layout Shift and to use Next.js image optimisations I had to give image width and height in the next/Image component. I did this by running a script that will traverse through my blog and convert the markdown images to Next.js images and find the image dimensions.

Adding image to markdown

![image info](./static/image.png)
Enter fullscreen mode Exit fullscreen mode

After running the script converted into

<Image
  alt={`image info`}
  src={`/static/image.png`}
  width={5000}
  height={3313}
/>
Enter fullscreen mode Exit fullscreen mode

This was a lot of work for displaying an image. With Next.js 11 this has become much simpler, no more scripts!! Yeah..

Adding Next.js 11 image component to your project

STEP 1 - First step is to update your project to Next.js 11.

Upgrade React version to latest
With Next.js 11 the minimum React version has been updated to 17.0.2.
To upgrade you can run the following command:

   npm install react@latest react-dom@latest
Enter fullscreen mode Exit fullscreen mode

Or using yarn:

   yarn add react@latest react-dom@latest
Enter fullscreen mode Exit fullscreen mode

Upgrade Next.js version to latest
To upgrade you can run the following command in the terminal:

   npm install next@latest
Enter fullscreen mode Exit fullscreen mode

Or using yarn:

   yarn add next@latest
Enter fullscreen mode Exit fullscreen mode

STEP 2 - Now you can just import your local image and not bother about providing dimensions.

   import Image from 'next/image'
   import author from '../public/me.png'

   export default function Home() {
     return (
       // When importing the image as the source, you
       // don't need to define `width` and `height`.
       <Image src={author} alt="Picture of the author" />
     )
   }
Enter fullscreen mode Exit fullscreen mode

Isn't that just amazing!!

STEP 3 - Adding Image placeholders
placeholder

This is the feature that really interested me, before this feature if we had to implement this feature, we had to save a low quality image and serve the image and wait for the full size image to load and then load the full size image etc.... in-short it was complicated 😵.
Now it is as simple as adding a placeholder prop to the component.

   import Image from 'next/image'
   import author from '../public/me.png'

   export default function Home() {
     return (
       // When importing the image as the source, you
       // don't need to define `width` and `height`.
       <Image src={author} alt="Picture of the author" placeholder="blur"/>
     )
   }
Enter fullscreen mode Exit fullscreen mode

If you are using a CDN to serve images, Next.js also supports blurring dynamic images by allowing you to provide a custom blurDataURL, which is provided by your back-end. For example, you can generate a blurha.sh on the server.

<Image
  src="https://nextjs.org/static/images/learn.png"
  blurDataURL="data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAAIAAoDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAb/xAAhEAACAQMDBQAAAAAAAAAAAAABAgMABAUGIWEREiMxUf/EABUBAQEAAAAAAAAAAAAAAAAAAAMF/8QAGhEAAgIDAAAAAAAAAAAAAAAAAAECEgMRkf/aAAwDAQACEQMRAD8AltJagyeH0AthI5xdrLcNM91BF5pX2HaH9bcfaSXWGaRmknyJckliyjqTzSlT54b6bk+h0R//2Q=="
  alt="Picture of the author"
  placeholder="blur"
/>
Enter fullscreen mode Exit fullscreen mode

Learn more Next.js Image improvements

Using next/image with MDX

This is how I implemented next/image component, It is extremely simple.
STEP 1 - Create a custom image component in your MDXComponents file
This is because I couldn't figure out how to import image to a MDX file, so I worked around it by creating a react component and importing the image in there and and calling that component in the MDX file like the code below.

// MDXComponets.js
import Image from 'next/image';

const NextImg = (props) => {
  const { src, alt } = props;
  return <Image src={require(`../public/static/images/${src}`)} alt={alt} placeholder="blur" />;
};

const MDXComponents = {
  NextImg,
};

export default MDXComponents;
Enter fullscreen mode Exit fullscreen mode

NOTE - placeholder={"blur"} wont work with gif files, so I used a disablePlaceholder prop to control whether to show the placeholder

STEP 2 - If you don't have a MDXComponents file, create one in your components folder and call it in your MDXProvider in _app.js. MDXComponents file is used to inject your custom components to your markdown.

// My _app.js file
import 'styles/global.scss';

import { ThemeProvider } from 'next-themes';
import { MDXProvider } from '@mdx-js/react';
import MDXComponents from 'components/MDXComponents';

function MyApp({ Component, pageProps }) {
  return (
    <ThemeProvider attribute="class">
      <MDXProvider components={MDXComponents}>
        <Component {...pageProps} />
      </MDXProvider>
    </ThemeProvider>
  );
}

export default MyApp;
Enter fullscreen mode Exit fullscreen mode

STEP 3 - Now I can use Nextimg component in my MDX file

// One of my article .mdx file
---
title: Tips For Using Async/Await - Write Better JavaScript!
tags: javaScript
---

<NextImg
  alt={`Tips-for-using-async-await-write-better-java-script`}
  src={'tips-for-using-async-await-write-better-java-script/banner.png'}
  // To disable placeholder feature use disablePlaceholder={true}
/>
Enter fullscreen mode Exit fullscreen mode

⚡ Final Result

img-placeholder

Most of the time you might not even see this loading as Next.js Images are really optimised and load blazing fast. If you want to see this in action just head over to my website milindsoorya.com and open any article.

Pro Tip : In-case you are not able to see this try a hard reload by ctrl+r or try throttling the website in the networks panel

Top comments (0)