You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/reference/react-dom/components/script.md
+22-20
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실
11
11
12
12
<Intro>
13
13
14
-
[내장된 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 사용하면 문서의 제목을 지정할 수 있습니다.
14
+
[내장 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 사용하면 문서에 스크립트를 추가할 수 있습니다.
15
15
16
16
```js
17
17
<script>alert("hi!") </script>
@@ -27,7 +27,7 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실
27
27
28
28
### `<script>` {/*script*/}
29
29
30
-
문서에 인라인 또는 외부 스크립트를 추가하려면 [내장된 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 렌더링하십시오. `<script>`는 어떤 컴포넌트에서든 렌더링할 수 있으며, React는 [특정 경우](#special-rendering-behavior)에 해당 DOM 요소를 문서의 head에 배치하고 동일한 스크립트를 중복 제거합니다.
30
+
문서에 인라인 또는 외부 스크립트를 추가하려면 [내장 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 렌더링하세요. `<script>`는 어떤 컴포넌트에서든 렌더링할 수 있으며, React는 [특정 경우](#special-rendering-behavior)에 해당 DOM 요소를 문서의 `<head>`에 배치하고 중복된 동일 스크립트를 제거합니다.
31
31
32
32
```js
33
33
<script>alert("hi!") </script>
@@ -38,16 +38,16 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실
`<script>`는 모든 [공통 컴포넌트 속성](/reference/react-dom/components/common#props)을 지원합니다.
42
42
43
-
다음 중 하나의 속성을 가져야 합니다.
43
+
`children` 또는 `src` 속성을 가져야 합니다.
44
44
45
-
*`children`: 문자열. 인라인 스크립트의 소스 코드
46
-
*`src`: 문자열. 외부 스크립트의 URL
45
+
*`children`: 문자열. 인라인 스크립트의 소스 코드.
46
+
*`src`: 문자열. 외부 스크립트의 URL.
47
47
48
-
다른 지원되는 속성들:
48
+
지원하는 다른 속성들:
49
49
50
-
*`async`: 불리언 값. 문서의 나머지가 처리될 때까지 스크립트 실행을 브라우저에게 연기할 수 있도록 합니다. — 성능을 위한 우선적인 동작 방식입니다.
50
+
*`async`: 불리언 값. 브라우저가 문서의 남은 부분을 처리할 때까지 스크립트 실행을 연기할 수 있도록 합니다. 이는 성능을 위한 우선적인 동작 방식입니다.
51
51
*`crossOrigin`: 문자열. 사용할 [CORS 정책](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin)입니다. 가능한 값은 `anonymous`와 `use-credentials`입니다.
52
52
*`fetchPriority`: 문자열. 여러 스크립트를 동시에 가져올 때 브라우저가 스크립트를 우선순위로 순위 지정할 수 있도록 합니다. `"high"`, `"low"`, 또는 `"auto"` (기본값)일 수 있습니다.
@@ -56,23 +56,25 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실
56
56
*`referrer`: 문자열. 스크립트를 가져오고 스크립트가 다시 가져온 리소스를 가져올 때 보낼 [Referer 헤더를 지정합니다.](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#referrerpolicy)
57
57
*`type`: 문자열. 스크립트가 [전통적인 스크립트, ES 모듈 또는 import 맵](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type)인지를 나타냅니다.
58
58
59
-
React의 [스크립트의 특수 처리](#special-rendering-behavior)를 비활성화하는 속성들:
59
+
React의 [스크립트 특수 처리](#special-rendering-behavior)를 비활성화하는 속성들:
60
60
61
-
*`onError`: 함수. 스크립트가 로딩에 실패할 때 호출됩니다.
62
-
*`onLoad`: 함수. 스크립트의 로딩이 완료되었을 때 호출됩니다.
61
+
*`onError`: 함수. 스크립트의 로딩을 실패하였을 때 호출됩니다.
62
+
*`onLoad`: 함수. 스크립트의 로딩을 완료하였을 때 호출됩니다.
63
63
64
-
React에서 **권장되지 않는** 속성들:
64
+
React에서 **권장하지 않는** 속성들:
65
65
66
-
*`blocking`: 문자열. `"render"`로 설정하면 페이지가 스크립트시트를 로드할 때까지 브라우저에게 페이지를 렌더링하지 말라고 지시합니다. React는 Suspense를 사용하여 더 세밀한 제어를 제공합니다.
66
+
*`blocking`: 문자열. `"render"`로 설정하면 페이지가 스크립트시트를 로드할 때까지 브라우저에게 페이지를 렌더링하지 않도록 지시합니다. React는 Suspense를 사용하여 더 세밀한 제어를 제공합니다.
67
67
*`defer`: 문자열. 문서가 로딩될 때까지 브라우저가 스크립트를 실행하지 못하도록 합니다. 스트리밍 서버에 렌더링된 컴포넌트와 호환되지 않습니다. 대신 `async` 속성을 사용하세요.
68
68
69
69
#### 특별한 렌더링 동작 {/*special-rendering-behavior*/}
70
70
71
-
React는 `<script>` 컴포넌트를 문서의 `<head>`로 이동시키고, 동일한 스크립트를 중복으로 처리합니다.
72
-
이 동작을 사용하려면 `src` 와 `async={true}` 속성을 제공하세요. React는 `src`가 동일한 경우에만 스크립트를 중복 처리합니다. 스크립트를 안전하게 이동하려면 `async` 속성이 반드시 true여야 합니다.
71
+
React는 `<script>` 컴포넌트를 문서의 `<head>`로 이동시키고, 중복된 동일 스크립트를 제거합니다.
72
+
73
+
이 동작을 사용하려면 `src`와 `async={true}` 속성을 제공하세요. React는 `src`가 동일한 경우에만 중복된 스크립트를 제거합니다. 스크립트를 안전하게 이동하려면 `async` 속성이 반드시 `true`여야 합니다.
74
+
73
75
이 특별한 처리에는 두 가지 주의사항이 있습니다.
74
76
75
-
* React는 스크립트를 렌더링한 후에 속성 변경을 무시합니다. (개발 환경에서 이러한 경우에는 경고가 표시됩니다.)
77
+
* React는 스크립트를 렌더링한 후에 속성 변경을 무시합니다. (개발 환경에서는 이러한 경우에 경고가 발생합니다.)
76
78
* React는 컴포넌트를 마운트 해제한 후에도 DOM에 스크립트를 남길 수 있습니다. (스크립트는 DOM에 삽입될 때 한 번만 실행되므로 이것은 영향을 미치지 않습니다.)
77
79
78
80
---
@@ -81,11 +83,11 @@ React는 `<script>` 컴포넌트를 문서의 `<head>`로 이동시키고, 동
81
83
82
84
### 외부 스크립트 렌더링 {/*rendering-an-external-script*/}
83
85
84
-
특정 script 에 의존하여 컴포넌트를 올바르게 표시해야 한다면, 컴포넌트 내에서 `<script>`를 렌더링할 수 있습니다.
86
+
특정 스크립트에 의존하여 컴포넌트를 올바르게 표시해야 한다면, 컴포넌트 내에서 `<script>`를 렌더링할 수 있습니다.
85
87
그러나 script 로딩이 완료되기 전에 컴포넌트가 커밋될 수 있습니다.
86
88
`load` 이벤트가 발생하면 스크립트 내용에 따라 시작할 수 있습니다. 예를 들어 `onLoad` prop 을 이용할 수 있습니다.
87
89
88
-
React는 동일한 `src`를 가진 스크립트의 중복을 제거하여 여러 컴포넌트가 렌더링하더라도 그 중 하나만 DOM에 삽입합니다.
90
+
React는 동일한 `src`를 가진 중복된 스크립트를 제거하여 여러 컴포넌트를 렌더링하더라도 그 중 하나만 DOM에 삽입합니다.
89
91
90
92
<SandpackWithHTMLOutput>
91
93
@@ -113,12 +115,12 @@ export default function Page() {
113
115
</SandpackWithHTMLOutput>
114
116
115
117
<Note>
116
-
스크립트를 사용할 때 [preinit](/reference/react-dom/preinit) 함수를 호출하는 것이 유익할 수 있습니다. 이 함수를 호출하면 `<script>` 컴포넌트를 그냥 렌더링하는 것보다 브라우저가 스크립트를 더 빨리 가져오도록 할 수 있습니다. 예를 들어 [HTTP Early Hints response](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103)를 보내는 것입니다.
118
+
스크립트를 사용하려는 경우, [`preinit`](/reference/react-dom/preinit) 함수를 호출하는 것이 유리할 수 있습니다. 이 함수를 호출하면 `<script>` 컴포넌트를 그냥 렌더링하는 것보다 브라우저가 스크립트를 더 빨리 가져오도록 할 수 있습니다. 예를 들어 [HTTP Early Hints 응답](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103)을 통해 스크립트를 더 빨리 가져올 수 있습니다.
117
119
</Note>
118
120
119
121
### 인라인 스크립트 렌더링 {/*rendering-an-inline-script*/}
120
122
121
-
인라인 script 를 포함하려면 `<script>` 컴포넌트를 자식으로 스크립트 소스 코드와 함께 렌더링하세요. 인라인 스크립트는 중복 처리되거나 문서`<head>`로 이동되지 않습니다.
123
+
인라인 스크립트를 포함하려면 `<script>` 컴포넌트를 자식으로 스크립트 소스 코드와 함께 렌더링하세요. 인라인 스크립트는 중복 제거되거나 문서의`<head>`로 이동하지 않습니다.
0 commit comments