Skip to content

Commit

Permalink
docs: update script.md (#1088)
Browse files Browse the repository at this point in the history
  • Loading branch information
@lumirlumir
lumirlumir authored Oct 26, 2024
1 parent 9f0bba8 commit 32144c2
Showing 1 changed file with 22 additions and 20 deletions.
42 changes: 22 additions & 20 deletions src/content/reference/react-dom/components/script.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실

<Intro>

[내장된 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 사용하면 문서의 제목을 지정할 수 있습니다.
[내장 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 사용하면 문서에 스크립트를 추가할 수 있습니다.

```js
<script> alert("hi!") </script>
Expand All @@ -27,7 +27,7 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실

### `<script>` {/*script*/}

문서에 인라인 또는 외부 스크립트를 추가하려면 [내장된 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 렌더링하십시오. `<script>`는 어떤 컴포넌트에서든 렌더링할 수 있으며, React는 [특정 경우](#special-rendering-behavior)에 해당 DOM 요소를 문서의 head에 배치하고 동일한 스크립트를 중복 제거합니다.
문서에 인라인 또는 외부 스크립트를 추가하려면 [내장 브라우저 `<script>` 컴포넌트](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)를 렌더링하세요. `<script>`는 어떤 컴포넌트에서든 렌더링할 수 있으며, React는 [특정 경우](#special-rendering-behavior)에 해당 DOM 요소를 문서의 `<head>`에 배치하고 중복된 동일 스크립트를 제거합니다.

```js
<script> alert("hi!") </script>
Expand All @@ -38,16 +38,16 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실

#### Props {/*props*/}

`<script>`는 [모든 컴포넌트 속성](/reference/react-dom/components/common#props)을 지원합니다.
`<script>`는 모든 [공통 컴포넌트 속성](/reference/react-dom/components/common#props)을 지원합니다.

다음 중 하나의 속성을 가져야 합니다.
`children` 또는 `src` 속성을 가져야 합니다.

* `children`: 문자열. 인라인 스크립트의 소스 코드
* `src`: 문자열. 외부 스크립트의 URL
* `children`: 문자열. 인라인 스크립트의 소스 코드.
* `src`: 문자열. 외부 스크립트의 URL.

다른 지원되는 속성들:
지원하는 다른 속성들:

* `async`: 불리언 값. 문서의 나머지가 처리될 때까지 스크립트 실행을 브라우저에게 연기할 수 있도록 합니다. — 성능을 위한 우선적인 동작 방식입니다.
* `async`: 불리언 값. 브라우저가 문서의 남은 부분을 처리할 때까지 스크립트 실행을 연기할 수 있도록 합니다. 이는 성능을 위한 우선적인 동작 방식입니다.
* `crossOrigin`: 문자열. 사용할 [CORS 정책](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/crossorigin)입니다. 가능한 값은 `anonymous`와 `use-credentials`입니다.
* `fetchPriority`: 문자열. 여러 스크립트를 동시에 가져올 때 브라우저가 스크립트를 우선순위로 순위 지정할 수 있도록 합니다. `"high"`, `"low"`, 또는 `"auto"` (기본값)일 수 있습니다.
* `integrity`: 문자열. 스크립트의 암호화 해시로, [진위성을 검증](https://developer.mozilla.org/en-US/docs/Web/Security/Subresource_Integrity)합니다.
Expand All @@ -56,23 +56,25 @@ React의 `<script>` 확장은 현재 React의 카나리(Canary) 버전 및 실
* `referrer`: 문자열. 스크립트를 가져오고 스크립트가 다시 가져온 리소스를 가져올 때 보낼 [Referer 헤더를 지정합니다.](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#referrerpolicy)
* `type`: 문자열. 스크립트가 [전통적인 스크립트, ES 모듈 또는 import 맵](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type)인지를 나타냅니다.

React의 [스크립트의 특수 처리](#special-rendering-behavior)를 비활성화하는 속성들:
React의 [스크립트 특수 처리](#special-rendering-behavior)를 비활성화하는 속성들:

* `onError`: 함수. 스크립트가 로딩에 실패할 때 호출됩니다.
* `onLoad`: 함수. 스크립트의 로딩이 완료되었을 때 호출됩니다.
* `onError`: 함수. 스크립트의 로딩을 실패하였을 때 호출됩니다.
* `onLoad`: 함수. 스크립트의 로딩을 완료하였을 때 호출됩니다.

React에서 **권장되지 않는** 속성들:
React에서 **권장하지 않는** 속성들:

* `blocking`: 문자열. `"render"`로 설정하면 페이지가 스크립트시트를 로드할 때까지 브라우저에게 페이지를 렌더링하지 말라고 지시합니다. React는 Suspense를 사용하여 더 세밀한 제어를 제공합니다.
* `blocking`: 문자열. `"render"`로 설정하면 페이지가 스크립트시트를 로드할 때까지 브라우저에게 페이지를 렌더링하지 않도록 지시합니다. React는 Suspense를 사용하여 더 세밀한 제어를 제공합니다.
* `defer`: 문자열. 문서가 로딩될 때까지 브라우저가 스크립트를 실행하지 못하도록 합니다. 스트리밍 서버에 렌더링된 컴포넌트와 호환되지 않습니다. 대신 `async` 속성을 사용하세요.

#### 특별한 렌더링 동작 {/*special-rendering-behavior*/}

React는 `<script>` 컴포넌트를 문서의 `<head>`로 이동시키고, 동일한 스크립트를 중복으로 처리합니다.
이 동작을 사용하려면 `src` 와 `async={true}` 속성을 제공하세요. React는 `src`가 동일한 경우에만 스크립트를 중복 처리합니다. 스크립트를 안전하게 이동하려면 `async` 속성이 반드시 true여야 합니다.
React는 `<script>` 컴포넌트를 문서의 `<head>`로 이동시키고, 중복된 동일 스크립트를 제거합니다.

이 동작을 사용하려면 `src`와 `async={true}` 속성을 제공하세요. React는 `src`가 동일한 경우에만 중복된 스크립트를 제거합니다. 스크립트를 안전하게 이동하려면 `async` 속성이 반드시 `true`여야 합니다.

이 특별한 처리에는 두 가지 주의사항이 있습니다.

* React는 스크립트를 렌더링한 후에 속성 변경을 무시합니다. (개발 환경에서 이러한 경우에는 경고가 표시됩니다.)
* React는 스크립트를 렌더링한 후에 속성 변경을 무시합니다. (개발 환경에서는 이러한 경우에 경고가 발생합니다.)
* React는 컴포넌트를 마운트 해제한 후에도 DOM에 스크립트를 남길 수 있습니다. (스크립트는 DOM에 삽입될 때 한 번만 실행되므로 이것은 영향을 미치지 않습니다.)

---
Expand All @@ -81,11 +83,11 @@ React는 `<script>` 컴포넌트를 문서의 `<head>`로 이동시키고, 동

### 외부 스크립트 렌더링 {/*rendering-an-external-script*/}

특정 script 에 의존하여 컴포넌트를 올바르게 표시해야 한다면, 컴포넌트 내에서 `<script>`를 렌더링할 수 있습니다.
특정 스크립트에 의존하여 컴포넌트를 올바르게 표시해야 한다면, 컴포넌트 내에서 `<script>`를 렌더링할 수 있습니다.
그러나 script 로딩이 완료되기 전에 컴포넌트가 커밋될 수 있습니다.
`load` 이벤트가 발생하면 스크립트 내용에 따라 시작할 수 있습니다. 예를 들어 `onLoad` prop 을 이용할 수 있습니다.

React는 동일한 `src`를 가진 스크립트의 중복을 제거하여 여러 컴포넌트가 렌더링하더라도 그 중 하나만 DOM에 삽입합니다.
React는 동일한 `src`를 가진 중복된 스크립트를 제거하여 여러 컴포넌트를 렌더링하더라도 그 중 하나만 DOM에 삽입합니다.

<SandpackWithHTMLOutput>

Expand Down Expand Up @@ -113,12 +115,12 @@ export default function Page() {
</SandpackWithHTMLOutput>

<Note>
스크립트를 사용할 때 [preinit](/reference/react-dom/preinit) 함수를 호출하는 것이 유익할 수 있습니다. 이 함수를 호출하면 `<script>` 컴포넌트를 그냥 렌더링하는 것보다 브라우저가 스크립트를 더 빨리 가져오도록 할 수 있습니다. 예를 들어 [HTTP Early Hints response](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103)를 보내는 것입니다.
스크립트를 사용하려는 경우, [`preinit`](/reference/react-dom/preinit) 함수를 호출하는 것이 유리할 수 있습니다. 이 함수를 호출하면 `<script>` 컴포넌트를 그냥 렌더링하는 것보다 브라우저가 스크립트를 더 빨리 가져오도록 할 수 있습니다. 예를 들어 [HTTP Early Hints 응답](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103)을 통해 스크립트를 더 빨리 가져올 수 있습니다.
</Note>

### 인라인 스크립트 렌더링 {/*rendering-an-inline-script*/}

인라인 script 를 포함하려면 `<script>` 컴포넌트를 자식으로 스크립트 소스 코드와 함께 렌더링하세요. 인라인 스크립트는 중복 처리되거나 문서 `<head>`로 이동되지 않습니다.
인라인 스크립트를 포함하려면 `<script>` 컴포넌트를 자식으로 스크립트 소스 코드와 함께 렌더링하세요. 인라인 스크립트는 중복 제거되거나 문서의 `<head>`로 이동하지 않습니다.

<SandpackWithHTMLOutput>

Expand Down

0 comments on commit 32144c2

Please sign in to comment.