` 컴포넌트가 지원하지 않는 옵션이 필요한 경우, `getImage()` 함수를 사용하여 사용자 정의 `` 컴포넌트를 생성할 수 있습니다.
diff --git a/src/content/docs/ko/reference/configuration-reference.mdx b/src/content/docs/ko/reference/configuration-reference.mdx
index b95b7c7861134..36563bdf3ec51 100644
--- a/src/content/docs/ko/reference/configuration-reference.mdx
+++ b/src/content/docs/ko/reference/configuration-reference.mdx
@@ -1151,62 +1151,75 @@ Sharp 이미지 서비스의 기본 이미지 크기 제한을 우회하고 큰
- 모든 하위 경로 ('startsWith')를 허용하려면 '/\*\*' 로 끝납니다.
- 한 수준의 하위 경로만 허용하려면 '/\*' 로 끝납니다.
-### image.experimentalLayout
+### image.responsiveStyles
+
+
+
+**타입:** `boolean`
+**기본값:** `false`
+
+
+
+반응형 이미지에 전역 스타일을 자동으로 추가할지 여부입니다. 이미지를 직접 스타일링하는 경우가 아니라면 이 옵션을 활성화해야 합니다.
+
+이 옵션은 구성 또는 이미지 컴포넌트의 `layout` prop을 사용하여 `layout`이 `constrained`, `full-width`, `fixed`로 설정된 경우에만 사용할 수 있습니다.
+
+자세한 내용은 [이미지 문서](/ko/guides/images/#반응형-이미지-스타일)를 참조하세요.
+
+### image.layout
**타입:** `ImageLayout`
-**기본값:** `undefined`
+**기본값:** `undefined`
+
반응형 이미지의 기본 레이아웃 타입입니다. 이미지 컴포넌트의 `layout` 속성으로 재정의할 수 있습니다.
-`experimental.responsiveImages` 플래그를 활성화해야 합니다.
- `constrained` - 이미지가 지정된 크기를 초과하지 않으면서 종횡비를 유지한 채로 컨테이너에 맞게 크기가 조정됩니다.
- `fixed` - 이미지가 원래 크기를 유지합니다.
- `full-width` - 이미지가 종횡비를 유지한 채로 컨테이너에 맞게 크기가 조정됩니다.
-### image.experimentalObjectFit
+자세한 내용은 [`layout` 컴포넌트 속성](/ko/reference/modules/astro-assets/#layout)을 참조하세요.
+
+### image.objectFit
**타입:** `ImageFit`
-**기본값:** `"cover"`
+**기본값:** `"cover"`
+
-반응형 이미지의 기본 object-fit 값입니다. 이미지 컴포넌트의 `fit` 속성으로 재정의할 수 있습니다.
-`experimental.responsiveImages` 플래그를 활성화해야 합니다.
+반응형 이미지의 [`object-fit` CSS 속성 값](https://developer.mozilla.org/ko/docs/Web/CSS/object-fit)입니다. 이미지 컴포넌트의 `fit` prop을 사용하여 재정의할 수 있습니다.
+`layout`의 값을 먼저 설정해야 합니다.
+
+자세한 내용은 [`fit` 컴포넌트 속성](/ko/reference/modules/astro-assets/#fit)을 참조하세요.
-### image.experimentalObjectPosition
+### image.objectPosition
**타입:** `string`
-**기본값:** `"center"`
+**기본값:** `"center"`
+
-반응형 이미지의 기본 object-position 값입니다. 이미지 컴포넌트의 `position` 속성으로 재정의할 수 있습니다.
-`experimental.responsiveImages` 플래그를 활성화해야 합니다.
-
-### image.experimentalBreakpoints
+반응형 이미지의 기본 [`object-position` CSS 속성 값](https://developer.mozilla.org/ko/docs/Web/CSS/object-position)입니다. 이미지 컴포넌트의 `position` prop을 사용하여 재정의할 수 있습니다.
+`layout`의 값을 먼저 설정해야 합니다.
-
+자세한 내용은 [`position` 컴포넌트 속성](/ko/reference/modules/astro-assets/#position)을 참조하세요.
-**타입:** `Array`
-**기본값:** `[640, 750, 828, 1080, 1280, 1668, 2048, 2560] | [640, 750, 828, 960, 1080, 1280, 1668, 1920, 2048, 2560, 3200, 3840, 4480, 5120, 6016]`
-
-
-반응형 이미지를 생성하는 데 사용되는 중단점입니다. `experimental.responsiveImages` 플래그를 활성화해야 합니다. 전체 목록은 일반적으로 사용되지 않으며, 소스 및 출력 크기에 따라 필터링됩니다. 사용되는 기본값은 로컬 또는 원격 이미지 서비스를 사용하는지에 따라 다릅니다. 원격 서비스의 경우 필요한 크기만 생성되므로 더 포괄적인 목록이 사용됩니다. 로컬 서비스의 경우 생성되는 이미지 수를 줄이기 위해 더 짧은 목록이 사용됩니다.
-
-### image.experimentalDefaultStyles
+### image.breakpoints
-**타입:** `boolean`
-**기본값:** `true`
+**타입:** `Array`
+**기본값:** `[640, 750, 828, 1080, 1280, 1668, 2048, 2560] | [640, 750, 828, 960, 1080, 1280, 1668, 1920, 2048, 2560, 3200, 3840, 4480, 5120, 6016]`
+
-실험적 이미지의 크기가 올바르게 조정되도록 전역 스타일을 자동으로 추가할지 여부입니다. 이 옵션은 기본적으로 활성화되어 있지만, 스타일을 직접 관리하려는 경우 비활성화할 수 있습니다.
-이 옵션은 `experimental.responsiveImages` 플래그가 활성화된 경우에만 사용할 수 있습니다.
+반응형 이미지를 생성하는 데 사용되는 중단점입니다. `layout`의 값을 먼저 설정해야 합니다. 전체 목록은 일반적으로 사용되지 않으며, 소스 및 출력 크기에 따라 필터링됩니다. 사용되는 기본값은 로컬 또는 원격 이미지 서비스를 사용하는지에 따라 다릅니다. 원격 서비스의 경우 필요한 크기만 생성되므로 더 포괄적인 목록이 사용됩니다. 로컬 서비스의 경우 생성되는 이미지 수를 줄이기 위해 더 짧은 목록이 사용됩니다.
## Markdown 옵션
diff --git a/src/content/docs/ko/reference/modules/astro-assets.mdx b/src/content/docs/ko/reference/modules/astro-assets.mdx
index f9c3aae980e1c..55e01ffa7e81c 100644
--- a/src/content/docs/ko/reference/modules/astro-assets.mdx
+++ b/src/content/docs/ko/reference/modules/astro-assets.mdx
@@ -27,6 +27,10 @@ import {
### ``
+`` 컴포넌트는 이미지를 최적화하고 변환합니다.
+
+이 컴포넌트는 컨테이너 크기 또는 기기 화면의 크기와 해상도에 따라 조정할 수 있는 [반응형 이미지](#반응형-이미지-속성)를 만드는 데도 사용할 수 있습니다.
+
```astro title="src/components/MyComponent.astro"
---
// Image 컴포넌트 및 이미지 가져오기
@@ -53,7 +57,7 @@ import myImage from "../assets/my_image.png"; // 1600x900의 이미지
#### Image 속성
-`` 컴포넌트는 아래에 설명된 속성 외에도 HTML `
` 태그의 모든 속성을 허용합니다.
+`` 컴포넌트는 HTML의 `
` 태그가 허용하는 모든 속성 외에도 다음에 나열된 속성과 [반응형 이미지 속성](#반응형-이미지-속성)을 허용합니다.
##### src (필수)
@@ -122,7 +126,9 @@ import myImage from "../assets/my_image.png"; // 1600x900의 이미지
이러한 속성은 이미지에 사용할 크기를 정의합니다.
-이미지를 원본 가로세로 비율로 사용하는 경우 `width` 및 `height`는 선택사항입니다. 이러한 치수는 `src/`에 있는 이미지 파일에서 자동으로 유추할 수 있습니다. 원격 이미지의 경우 `` 또는 `` 컴포넌트의 [`inferSize` 속성을 `true`로 설정](#infersize)하거나 [`inferRemoteSize()` 함수](#inferremotesize)를 사용하세요.
+`layout` 유형이 설정되면, 이미지의 크기에 따라 이 값들이 자동으로 생성되므로 대부분의 경우 수동으로 설정하지 않아도 됩니다.
+
+이미지를 원본 가로세로 비율로 사용하는 경우 `width` 및 `height`는 선택사항입니다. 이러한 크기는 `src/`에 있는 이미지 파일에서 자동으로 유추할 수 있습니다. 원격 이미지의 경우 `` 또는 `` 컴포넌트의 [`inferSize` 속성을 `true`로 설정](#infersize)하거나 [`inferRemoteSize()` 함수](#inferremotesize)를 사용하세요.
그러나 Astro는 이러한 파일을 분석할 수 없으므로 `public/` 폴더에 저장된 이미지에는 이 두 속성이 모두 필요합니다.
@@ -136,6 +142,8 @@ import myImage from "../assets/my_image.png"; // 1600x900의 이미지
이미지에 대해 생성할 픽셀 밀도 목록입니다.
+`densities` 속성은 `layout` 속성을 사용하는 반응형 이미지와 호환되지 않으며 설정된 경우 무시됩니다.
+
제공된 경우 이 값은 `
` 태그에 `srcset` 속성을 생성하는 데 사용됩니다. 이 값을 사용할 때 `widths` 값을 제공하지 마세요.
이미지 크기가 커지는 것을 방지하기 위해 원본 이미지보다 더 큰 너비와 동일한 밀도는 무시됩니다.
@@ -180,6 +188,8 @@ import myImage from '../assets/my_image.png';
제공된 경우 이 값은 `
` 태그에 `srcset` 속성을 생성하는 데 사용됩니다. [`sizes` 속성](https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/sizes)도 제공해야 합니다.
+`layout` 속성을 사용하는 반응형 이미지는 `widths` 및 `sizes` 속성을 자동으로 생성합니다. 일반적으로 이러한 값을 제공할 필요는 없지만 자동으로 생성된 값을 재정의하는 데 사용할 수 있습니다.
+
이 값을 사용할 때는 `densities` 값을 제공하지 마세요. 이 두 값 중 하나만 사용하여 `srcset`을 생성할 수 있습니다.
이미지 크기가 커지는 것을 방지하기 위해 원본 이미지보다 큰 너비는 무시됩니다.
@@ -221,6 +231,20 @@ import myImage from '../assets/my_image.png'; // 1600x900의 이미지
/>
```
+##### sizes
+
+
+
+**타입:** `string | undefined`
+
+
+
+각 미디어 조건 목록에 대한 이미지의 레이아웃 너비를 지정합니다. `widths`를 지정할 때 반드시 제공해야 합니다.
+
+`layout` 속성을 사용하는 반응형 이미지는 `widths` 및 `sizes` 속성을 자동으로 생성합니다. 일반적으로 이러한 값을 제공할 필요는 없지만 자동으로 생성된 값을 재정의하는 데 사용할 수 있습니다.
+
+`constrained` 및 `full-width` 이미지에 대해 생성된 `sizes` 속성은 뷰포트가 이미지 너비보다 작은 경우 이미지가 화면 전체 너비에 가깝게 표시된다는 가정을 기반으로 합니다. 크게 다른 경우 (예: 작은 화면의 다중 열 레이아웃)에는 최상의 결과를 위해 `sizes` 속성을 수동으로 조정해야 할 수 있습니다.
+
##### format
@@ -248,6 +272,7 @@ import myImage from '../assets/my_image.png'; // 1600x900의 이미지
**타입:** `boolean`
+**기본값:** `false`
@@ -257,7 +282,7 @@ import myImage from '../assets/my_image.png'; // 1600x900의 이미지
`` 컴포넌트에 `inferSize`를 추가하거나 `getImage()`에 `inferSize: true`를 추가하여 가져올 때 이미지 콘텐츠에서 이러한 값을 추론합니다. 이는 원격 이미지의 크기를 모르거나 변경될 수 있는 경우에 유용합니다.
-```astro mark="inferSize"
+```astro title="src/components/MyComponent.astro" "inferSize"
---
import { Image } from 'astro:assets';
---
@@ -266,11 +291,42 @@ import { Image } from 'astro:assets';
`inferSize`는 [승인되지 않은 도메인의 원격 이미지](/ko/guides/images/#원격-이미지-승인)의 크기를 가져올 수 있지만 이미지 자체는 처리되지 않은 상태로 유지됩니다.
+#### priority
+
+
+
+**타입:** `boolean`
+**기본값:** `false`
+
+
+
+웹 페이지에 접속 시, 스크롤하지 않아도 화면에 바로 나타나는 이미지에 대해 `loading`, `decoding`, `fetchpriority` 속성을 최적화된 값으로 자동 설정합니다.
+
+```astro title="src/components/MyComponent.astro" "priority"
+---
+import { Image } from 'astro:assets';
+import myImage from '../assets/my_image.png';
+---
+
+```
+
+`priority: true` (또는 단축 구문 `priority`)를 `` 또는 `` 컴포넌트에 추가하면 브라우저에 이미지를 즉시 로드하도록 지시하는 다음 속성이 추가됩니다.
+
+```
+loading="eager"
+decoding="sync"
+fetchpriority="high"
+```
+
+이러한 개별 속성을 사용자 정의하는 경우 수동으로 설정할 수 있습니다.
+
### ``
-다양한 형식 및/또는 크기로 반응형 이미지를 표시하려면 Astro의 `` 컴포넌트를 사용하세요.
+`` 컴포넌트는 여러 형식 및/또는 크기로 최적화된 이미지를 생성합니다.
+
+이 컴포넌트는 컨테이너 크기 또는 기기 화면의 크기와 해상도에 따라 조정할 수 있는 [반응형 이미지](#반응형-이미지-속성)를 만드는 데도 사용할 수 있습니다.
```astro title="src/pages/index.astro"
---
@@ -300,7 +356,7 @@ import myImage from "../assets/my_image.png"; // 1600x900의 이미지
#### Picture 속성
-``는 [`` 컴포넌트](#image-속성)의 모든 속성과 함께 다음을 허용합니다.
+``는 [반응형 이미지 속성](#반응형-이미지-속성)을 포함하여 [`` 컴포넌트](#image-속성)의 모든 속성과 다음을 허용합니다.
##### `formats`
@@ -359,6 +415,136 @@ import myImage from "../my_image.png"; // 1600x900의 이미지