Skip to content

Commit 9d9fbd7

Browse files
jjammingclaude
andauthored
docs: unify optional parameter translation (#1502)
Closes #1478 # 선택적 매개변수 라벨 통일 **AS-IS** - 레퍼런스 문서 매개변수 목록에서 optional 라벨 표기가 ```md **optional**, **선택사항**, **선택 사항**, **(선택사항)**, **(선택적)** ``` 등 여러 형태로 혼재되어 있습니다. **TO-BE** - #1478 의 논의에 따라, ``` `identifier`**(선택사항)**: ``` 형식으로 통일합니다. ## 필수 확인 사항 - [x] [기여자 행동 강령 규약<sup>Code of Conduct</sup>](https://github.com/reactjs/ko.react.dev/blob/main/CODE_OF_CONDUCT.md) - [x] [기여 가이드라인<sup>Contributing</sup>](https://github.com/reactjs/ko.react.dev/blob/main/CONTRIBUTING.md) - [x] [공통 스타일 가이드<sup>Universal Style Guide</sup>](https://github.com/reactjs/ko.react.dev/blob/main/wiki/universal-style-guide.md) - [x] [번역을 위한 모범 사례<sup>Best Practices for Translation</sup>](https://github.com/reactjs/ko.react.dev/blob/main/wiki/best-practices-for-translation.md) - [x] [번역 용어 정리<sup>Translate Glossary</sup>](https://github.com/reactjs/ko.react.dev/blob/main/wiki/translate-glossary.md) - [x] [`textlint` 가이드<sup>Textlint Guide</sup>](https://github.com/reactjs/ko.react.dev/blob/main/wiki/textlint-guide.md) - [x] [맞춤법 검사<sup>Spelling Check</sup>](https://nara-speller.co.kr/speller/) ## 선택 확인 사항 - [ ] 번역 초안 작성<sup>Draft Translation</sup> - [ ] 리뷰 반영<sup>Resolve Reviews</sup> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 00c48d4 commit 9d9fbd7

28 files changed

Lines changed: 99 additions & 99 deletions

src/content/reference/react-dom/client/createRoot.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -42,11 +42,11 @@ root.render(<App />);
4242
4343
* `domNode`: [DOM 엘리먼트](https://developer.mozilla.org/en-US/docs/Web/API/Element). React는 DOM 엘리먼트에 대한 루트를 생성하고 렌더링된 React 콘텐츠를 표시하는 `render`와 같은 함수를 루트에서 호출할 수 있도록 합니다.
4444
45-
* **optional** `options`: React 루트에 대한 옵션을 가진 객체입니다.
46-
* **optional** `onCaughtError`: React가 Error Boundary에서 오류를 잡을 때 호출되는 콜백. Error Boundary에서 잡은 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
47-
* **optional** `onUncaughtError`: 오류가 Error Boundary에 의해 잡히지 않을 때 호출되는 콜백. 오류가 발생한 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
48-
* **optional** `onRecoverableError`: React가 오류로부터 자동으로 복구될 때 호출되는 콜백. React가 던지는 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다. 복구 가능한 오류는 원본 오류 원인을 `error.cause`로 포함할 수 있습니다.
49-
* **optional** `identifierPrefix`: React가 [`useId`](/reference/react/useId)에 의해 생성된 ID에 사용하는 문자열 접두사. 같은 페이지에서 여러개의 루트를 사용할 때 충돌을 피하는 데 유용합니다.
45+
* `options`**(선택사항)**: React 루트에 대한 옵션을 가진 객체입니다.
46+
* `onCaughtError`**(선택사항)**: React가 Error Boundary에서 오류를 잡을 때 호출되는 콜백. Error Boundary에서 잡은 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
47+
* `onUncaughtError`**(선택사항)**: 오류가 Error Boundary에 의해 잡히지 않을 때 호출되는 콜백. 오류가 발생한 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
48+
* `onRecoverableError`**(선택사항)**: React가 오류로부터 자동으로 복구될 때 호출되는 콜백. React가 던지는 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다. 복구 가능한 오류는 원본 오류 원인을 `error.cause`로 포함할 수 있습니다.
49+
* `identifierPrefix`**(선택사항)**: React가 [`useId`](/reference/react/useId)에 의해 생성된 ID에 사용하는 문자열 접두사. 같은 페이지에서 여러개의 루트를 사용할 때 충돌을 피하는 데 유용합니다.
5050
5151
#### 반환값 {/*returns*/}
5252

src/content/reference/react-dom/client/hydrateRoot.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -39,11 +39,11 @@ React는 `domNode` 내부에 존재하는 HTML에 연결되어, 그 내부의 DO
3939
4040
* `reactNode`: 기존 HTML에 렌더링하기 위한 "React 노드" 입니다. 주로 `ReactDOM Server``renderToPipeableStream(<App />)`와 같은 메서드로 렌더링된 `<App />`과 같은 JSX 조각들입니다.
4141
42-
* **optional** `options`: React 루트에 대한 옵션을 가진 객체입니다.
43-
* **optional** `onCaughtError`: React가 Error Boundary에서 오류를 잡았을 때 호출되는 콜백입니다. Error Boundary에서 잡은 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
44-
* **optional** `onUncaughtError`: 오류가 Error Boundary에 의해 잡히지 않았을 때 호출되는 콜백입니다. 발생한 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
45-
* **optional** `onRecoverableError`: React가 오류로부터 자동으로 복구될 때 호출되는 콜백입니. React가 던지는 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다. 복구 가능한 오류는 원본 오류 원인을 `error.cause`로 포함할 수 있습니다.
46-
* **optional** `identifierPrefix`: React가 [`useId`](/reference/react/useId)에 의해 생성된 ID에 사용하는 문자열 접두사. 같은 페이지에서 여러개의 루트를 사용할 때 충돌을 피하는 데 유용합니다. 서버에서 사용한 값과 반드시 동일한 값이어야 합니다.
42+
* `options`**(선택사항)**: React 루트에 대한 옵션을 가진 객체입니다.
43+
* `onCaughtError`**(선택사항)**: React가 Error Boundary에서 오류를 잡았을 때 호출되는 콜백입니다. Error Boundary에서 잡은 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
44+
* `onUncaughtError`**(선택사항)**: 오류가 Error Boundary에 의해 잡히지 않았을 때 호출되는 콜백입니다. 발생한 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다.
45+
* `onRecoverableError`**(선택사항)**: React가 오류로부터 자동으로 복구될 때 호출되는 콜백입니다. React가 던지는 `error``componentStack`을 포함하는 `errorInfo` 객체와 함께 호출됩니다. 복구 가능한 오류는 원본 오류 원인을 `error.cause`로 포함할 수 있습니다.
46+
* `identifierPrefix`**(선택사항)**: React가 [`useId`](/reference/react/useId)에 의해 생성된 ID에 사용하는 문자열 접두사. 같은 페이지에서 여러개의 루트를 사용할 때 충돌을 피하는 데 유용합니다. 서버에서 사용한 값과 반드시 동일한 값이어야 합니다.
4747
4848
#### 반환값 {/*returns*/}
4949

src/content/reference/react-dom/components/common.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -275,7 +275,7 @@ React는 *다른* `ref` 콜백을 전달할 때마다 `ref` 콜백도 호출합
275275

276276
#### 반환값 {/*returns*/}
277277

278-
* **optional** `Cleanup 함수`: `ref`가 분리되면, React는 cleanup 함수를 호출합니다. `ref` 콜백에 의해 함수가 반환되지 않으면 React는 `ref`가 분리되면 인수로 `null`을 사용하여 다시 콜백을 호출합니다. 이 동작은 향후 버전에서 제거될 예정입니다.
278+
* `Cleanup 함수`**(선택사항)**: `ref`가 분리되면, React는 cleanup 함수를 호출합니다. `ref` 콜백에 의해 함수가 반환되지 않으면 React는 `ref`가 분리되면 인수로 `null`을 사용하여 다시 콜백을 호출합니다. 이 동작은 향후 버전에서 제거될 예정입니다.
279279

280280
#### 주의 사항 {/*caveats*/}
281281

src/content/reference/react-dom/server/renderToPipeableStream.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -48,18 +48,18 @@ const { pipe } = renderToPipeableStream(<App />, {
4848
4949
* `reactNode`: HTML로 렌더링하려는 React 노드. 예를 들어, `<App />`과 같은 JSX 엘리먼트입니다. 전체 문서를 나타낼 것으로 예상되므로 `App` 컴포넌트는 `<html>` 태그를 렌더링해야 합니다.
5050
51-
* **선택 사항** `options`: 스트리밍 옵션이 있는 객체입니다.
52-
* **선택 사항** `bootstrapScriptContent`: 지정하면 이 문자열이 인라인 `<script>` 태그에 배치됩니다.
53-
* **선택 사항** `bootstrapScripts`: 페이지에 표시할 `<script>` 태그에 대한 문자열 URL 배열입니다. 이를 사용하여 [`hydrateRoot`](/reference/react-dom/client/hydrateRoot)를 호출하는 `<script>`를 포함하세요. 클라이언트에서 React를 전혀 실행하지 않으려면 생략하세요.
54-
* **선택 사항** `bootstrapModules`: `bootstrapScripts`와 같지만 대신 [`<script type="module">`](https://developer.mozilla.org/ko/docs/Web/JavaScript/Guide/Modules)를 출력합니다.
55-
* **선택 사항** `identifierPrefix`: React가 [`useId`](/reference/react/useId)에 의해 생성된 ID에 사용하는 문자열 접두사입니다. 같은 페이지에서 여러 루트를 사용할 때 충돌을 피하는 데 유용합니다. [`hydrateRoot`](/reference/react-dom/client/hydrateRoot#parameters)에 전달된 것과 동일한 접두사여야 합니다.
56-
* **선택 사항** `namespaceURI`: 스트림의 루트 [네임스페이스 URI](https://developer.mozilla.org/ko/docs/Web/API/Document/createElementNS#important_namespace_uris)가 포함된 문자열입니다. 기본값은 일반 HTML입니다. SVG의 경우 `'http://www.w3.org/2000/svg'`를, MathML의 경우 `'http://www.w3.org/1998/Math/MathML'`를 전달합니다.
57-
* **선택 사항** `nonce`: [`script-src` Content-Security-Policy](https://developer.mozilla.org/ko/docs/Web/HTTP/Headers/Content-Security-Policy/script-src)에 대한 스크립트를 허용하는 [`nonce`](http://developer.mozilla.org/ko/docs/Web/HTML/Element/script#nonce) 문자열입니다.
58-
* **선택 사항** `onAllReady`: [셸](#specifying-what-goes-into-the-shell)과 모든 추가 [콘텐츠](#streaming-more-content-as-it-loads)를 포함하여 모든 렌더링이 완료되면 호출되는 콜백입니다. [크롤러 및 정적 생성에](#waiting-for-all-content-to-load-for-crawlers-and-static-generation) `onShellReady` 대신 이 함수를 사용할 수 있습니다. 여기서 스트리밍을 시작하면 프로그레시브 로딩이 발생하지 않습니다. 스트림에는 최종 HTML이 포함됩니다.
59-
* **선택 사항** `onError`: [복구 가능](#recovering-from-errors-outside-the-shell) 또는 [불가능](#recovering-from-errors-inside-the-shell)에 관계없이 서버 오류가 발생할 때마다 호출되는 콜백입니다. 기본적으로 `console.error`만 호출합니다. 이 함수를 재정의하여 [크래시 리포트를 기록](#logging-crashes-on-the-server)하는 경우 `console.error`를 계속 호출해야 합니다. 셸이 출력되기 전에 [상태 코드를 조정](#setting-the-status-code)하는 데 사용할 수도 있습니다.
60-
* **선택 사항** `onShellReady`: [초기 셸](#specifying-what-goes-into-the-shell)이 렌더링된 직후에 실행되는 콜백입니다. 여기서 [상태 코드를 설정](#setting-the-status-code)하고 `pipe`를 호출하여 스트리밍을 시작할 수 있습니다. React는 HTML 로딩 폴백을 콘텐츠로 대체하는 인라인 `<script>` 태그와 함께 셸 뒤에 [추가 콘텐츠를 스트리밍](#streaming-more-content-as-it-loads)합니다.
61-
* **선택 사항** `onShellError`: 초기 셸을 렌더링하는 데 오류가 발생하면 호출되는 콜백입니다. 오류를 인자로 받습니다. 스트림에서 아직 바이트가 전송되지 않았고, `onShellReady``onAllReady`도 호출되지 않으므로 [폴백 HTML 셸을 출력](#recovering-from-errors-inside-the-shell) 할 수 있습니다.
62-
* **선택 사항** `progressiveChunkSize`: 청크의 바이트 수입니다. [기본 휴리스틱에 대해 자세히 알아보세요.](https://github.com/facebook/react/blob/14c2be8dac2d5482fda8a0906a31d239df8551fc/packages/react-server/src/ReactFizzServer.js#L210-L225)
51+
* `options`**(선택사항)**: 스트리밍 옵션이 있는 객체입니다.
52+
* `bootstrapScriptContent`**(선택사항)**: 지정하면 이 문자열이 인라인 `<script>` 태그에 배치됩니다.
53+
* `bootstrapScripts`**(선택사항)**: 페이지에 표시할 `<script>` 태그에 대한 문자열 URL 배열입니다. 이를 사용하여 [`hydrateRoot`](/reference/react-dom/client/hydrateRoot)를 호출하는 `<script>`를 포함하세요. 클라이언트에서 React를 전혀 실행하지 않으려면 생략하세요.
54+
* `bootstrapModules`**(선택사항)**: `bootstrapScripts`와 같지만 대신 [`<script type="module">`](https://developer.mozilla.org/ko/docs/Web/JavaScript/Guide/Modules)를 출력합니다.
55+
* `identifierPrefix`**(선택사항)**: React가 [`useId`](/reference/react/useId)에 의해 생성된 ID에 사용하는 문자열 접두사입니다. 같은 페이지에서 여러 루트를 사용할 때 충돌을 피하는 데 유용합니다. [`hydrateRoot`](/reference/react-dom/client/hydrateRoot#parameters)에 전달된 것과 동일한 접두사여야 합니다.
56+
* `namespaceURI`**(선택사항)**: 스트림의 루트 [네임스페이스 URI](https://developer.mozilla.org/ko/docs/Web/API/Document/createElementNS#important_namespace_uris)가 포함된 문자열입니다. 기본값은 일반 HTML입니다. SVG의 경우 `'http://www.w3.org/2000/svg'`를, MathML의 경우 `'http://www.w3.org/1998/Math/MathML'`를 전달합니다.
57+
* `nonce`**(선택사항)**: [`script-src` Content-Security-Policy](https://developer.mozilla.org/ko/docs/Web/HTTP/Headers/Content-Security-Policy/script-src)에 대한 스크립트를 허용하는 [`nonce`](http://developer.mozilla.org/ko/docs/Web/HTML/Element/script#nonce) 문자열입니다.
58+
* `onAllReady`**(선택사항)**: [셸](#specifying-what-goes-into-the-shell)과 모든 추가 [콘텐츠](#streaming-more-content-as-it-loads)를 포함하여 모든 렌더링이 완료되면 호출되는 콜백입니다. [크롤러 및 정적 생성에](#waiting-for-all-content-to-load-for-crawlers-and-static-generation) `onShellReady` 대신 이 함수를 사용할 수 있습니다. 여기서 스트리밍을 시작하면 프로그레시브 로딩이 발생하지 않습니다. 스트림에는 최종 HTML이 포함됩니다.
59+
* `onError`**(선택사항)**: [복구 가능](#recovering-from-errors-outside-the-shell) 또는 [불가능](#recovering-from-errors-inside-the-shell)에 관계없이 서버 오류가 발생할 때마다 호출되는 콜백입니다. 기본적으로 `console.error`만 호출합니다. 이 함수를 재정의하여 [크래시 리포트를 기록](#logging-crashes-on-the-server)하는 경우 `console.error`를 계속 호출해야 합니다. 셸이 출력되기 전에 [상태 코드를 조정](#setting-the-status-code)하는 데 사용할 수도 있습니다.
60+
* `onShellReady`**(선택사항)**: [초기 셸](#specifying-what-goes-into-the-shell)이 렌더링된 직후에 실행되는 콜백입니다. 여기서 [상태 코드를 설정](#setting-the-status-code)하고 `pipe`를 호출하여 스트리밍을 시작할 수 있습니다. React는 HTML 로딩 폴백을 콘텐츠로 대체하는 인라인 `<script>` 태그와 함께 셸 뒤에 [추가 콘텐츠를 스트리밍](#streaming-more-content-as-it-loads)합니다.
61+
* `onShellError`**(선택사항)**: 초기 셸을 렌더링하는 데 오류가 발생하면 호출되는 콜백입니다. 오류를 인자로 받습니다. 스트림에서 아직 바이트가 전송되지 않았고, `onShellReady``onAllReady`도 호출되지 않으므로 [폴백 HTML 셸을 출력](#recovering-from-errors-inside-the-shell) 할 수 있습니다.
62+
* `progressiveChunkSize`**(선택사항)**: 청크의 바이트 수입니다. [기본 휴리스틱에 대해 자세히 알아보세요.](https://github.com/facebook/react/blob/14c2be8dac2d5482fda8a0906a31d239df8551fc/packages/react-server/src/ReactFizzServer.js#L210-L225)
6363
6464
6565
#### 반환값 {/*returns*/}

0 commit comments

Comments
 (0)