2023-10-18 10:35:58 +00:00
|
|
|
---
|
|
|
|
title: "<NuxtImg>"
|
|
|
|
description: "Nuxt provides a <NuxtImg> component to handle automatic image optimization."
|
2023-10-18 10:59:43 +00:00
|
|
|
links:
|
|
|
|
- label: Source
|
|
|
|
icon: i-simple-icons-github
|
|
|
|
to: https://github.com/nuxt/image/blob/main/src/runtime/components/nuxt-img.ts
|
|
|
|
size: xs
|
2023-10-18 10:35:58 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
`<NuxtImg>` is a drop-in replacement for the native `<img>` tag.
|
|
|
|
|
|
|
|
- Uses built-in provider to optimize local and remote images
|
|
|
|
- Converts `src` to provider-optimized URLs
|
|
|
|
- Automatically resizes images based on `width` and `height`
|
|
|
|
- Generates responsive sizes when providing `sizes` option
|
|
|
|
- Supports native lazy loading as well as other `<img>` attributes
|
|
|
|
|
|
|
|
## Setup
|
|
|
|
|
|
|
|
In order to use `<NuxtImg>` you should install and enable the Nuxt Image module:
|
|
|
|
|
|
|
|
```bash [Terminal]
|
|
|
|
npx nuxi@latest module add image
|
|
|
|
```
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
`<NuxtImg>` outputs a native `img` tag directly (without any wrapper around it). Use it like you would use the `<img>` tag:
|
|
|
|
|
|
|
|
```html
|
|
|
|
<NuxtImg src="/nuxt-icon.png" />
|
|
|
|
```
|
|
|
|
|
|
|
|
Will result in:
|
|
|
|
|
|
|
|
```html
|
|
|
|
<img src="/nuxt-icon.png" />
|
|
|
|
```
|
|
|
|
|
2023-10-18 10:59:43 +00:00
|
|
|
::read-more{to="https://image.nuxt.com/usage/nuxt-img" target="_blank"}
|
2023-10-18 10:35:58 +00:00
|
|
|
Read more about the `<NuxtImg>` component.
|
|
|
|
::
|