Skip to content

Commit 356822d

Browse files
authored
docs: add none provider documentation (#2002)
1 parent 578c04b commit 356822d

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

docs/content/3.providers/none.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: None
3+
description: A pass-through provider that returns images without any transformations.
4+
links:
5+
- label: Source
6+
icon: i-simple-icons-github
7+
to: https://github.com/nuxt/image/blob/main/src/runtime/providers/none.ts
8+
size: xs
9+
---
10+
11+
The `none` provider is a minimal pass-through provider that returns image URLs without applying any transformations or optimizations.
12+
13+
This provider is useful when you want to use Nuxt Image components for consistent markup and loading behavior, but don't need actual image optimization.
14+
15+
## Usage
16+
17+
```ts [nuxt.config.ts]
18+
export default defineNuxtConfig({
19+
image: {
20+
provider: 'none'
21+
}
22+
})
23+
```
24+
25+
## Behavior
26+
27+
When using the `none` provider:
28+
- No image transformations are applied (resizing, format conversion, etc.)
29+
- Modifiers are ignored
30+
- The original image URL is returned as-is
31+
- All Nuxt Image component features like lazy loading and placeholders still work
32+
33+
This is particularly useful for development, testing, or when your images are already optimized and you just want the component interface.
34+

0 commit comments

Comments
 (0)