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/addTransitionType.md
+33-33Lines changed: 33 additions & 33 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,21 +5,21 @@ version: experimental
5
5
6
6
<Experimental>
7
7
8
-
**This API is experimental and is not available in a stable version of React yet.**
8
+
**이 API는 실험적이며 React 안정 버전에서는 아직 사용할 수 없습니다.**
9
9
10
-
You can try it by upgrading React packages to the most recent experimental version:
10
+
이 API를 사용하려면 React 패키지를 가장 최신의 실험적인 버전으로 업그레이드해야 합니다.
11
11
12
12
-`react@experimental`
13
13
-`react-dom@experimental`
14
14
-`eslint-plugin-react-hooks@experimental`
15
15
16
-
Experimental versions of React may contain bugs. Don't use them in production.
16
+
실험적인 버전의 React에는 버그가 있을 수 있습니다. 프로덕션 환경에서는 사용하지 마세요.
17
17
18
18
</Experimental>
19
19
20
20
<Intro>
21
21
22
-
`unstable_addTransitionType` lets you specify the cause of a transition.
22
+
`unstable_addTransitionType`을 사용하면 트랜지션이 발생한 원인을 상세히 나타낼 수 있습니다.
23
23
24
24
25
25
```js
@@ -35,30 +35,30 @@ startTransition(() => {
35
35
36
36
---
37
37
38
-
## Reference {/*reference*/}
38
+
## 레퍼런스 {/*reference*/}
39
39
40
40
### `addTransitionType` {/*addtransitiontype*/}
41
41
42
-
#### Parameters {/*parameters*/}
42
+
#### 매개변수 {/*parameters*/}
43
43
44
-
-`type`: The type of transition to add. This can be any string.
44
+
-`type`: 추가할 트랜지션의 타입입니다. 어떤 문자열이든 될 수 있습니다.
45
45
46
-
#### Returns {/*returns*/}
46
+
#### 반환값 {/*returns*/}
47
47
48
-
`startTransition` does not return anything.
48
+
`startTransition`은 아무것도 반환하지 않습니다.
49
49
50
-
#### Caveats {/*caveats*/}
50
+
#### 주의 사항 {/*caveats*/}
51
51
52
-
-If multiple transitions are combined, all Transition Types are collected. You can also add more than one type to a Transition.
53
-
-Transition Types are reset after each commit. This means a `<Suspense>` fallback will associate the types after a `startTransition`, but revealing the content does not.
52
+
-여러 트랜지션이 결합되면 모든 트랜지션 타입이 수집됩니다. 하나의 트랜지션에 두 개 이상의 타입을 추가할 수도 있습니다.
53
+
-트랜지션 타입은 커밋마다 초기화됩니다. 즉, `<Suspense>`의 Fallback은 `startTransition` 이후 타입을 연결하며, 내용이 나타날 때는 그렇지 않습니다.
54
54
55
55
---
56
56
57
-
## Usage {/*usage*/}
57
+
## 사용법 {/*usage*/}
58
58
59
-
### Adding the cause of a transition {/*adding-the-cause-of-a-transition*/}
59
+
### 트랜지션의 원인 추가하기 {/*adding-the-cause-of-a-transition*/}
60
60
61
-
Call `addTransitionType` inside of`startTransition`to indicate the cause of a transition:
61
+
트랜지션의 원인을 나타내기 위해`startTransition`내부에서 `addTransitionType`을 호출합니다
import { startTransition, unstable_addTransitionType } from 'react';
@@ -76,22 +76,22 @@ function Submit({action) {
76
76
77
77
```
78
78
79
-
When you call <CodeStepstep={1}>addTransitionType</CodeStep> inside the scope of <CodeStepstep={2}>startTransition</CodeStep>, React will associate <CodeStepstep={3}>submit-click</CodeStep> as one of the causes for the Transition.
79
+
<CodeStepstep={1}>addTransitionType</CodeStep>을 <CodeStepstep={2}>startTransition</CodeStep>의 범위 내에서 호출하면, React는 해당 트랜지션에 <CodeStepstep={3}>submit-click</CodeStep>을 원인으로 연결합니다.
80
80
81
-
Currently, Transition Types can be used to customize different animations based on what caused the Transition. You have three different ways to choose from for how to use them:
81
+
현재 트랜지션 타입은 원인에 따라 서로 다른 애니메이션을 커스터마이즈하는 데 사용할 수 있습니다. 사용할 수 있는 방식은 세 가지입니다.
82
82
83
-
-[Customize animations using browser view transition types](#customize-animations-using-browser-view-transition-types)
84
-
-[Customize animations using `View Transition`Class](#customize-animations-using-view-transition-class)
85
-
-[Customize animations using `ViewTransition` events](#customize-animations-using-viewtransition-events)
83
+
-[브라우저 View Transition 타입으로 애니메이션 커스텀하기](#customize-animations-using-browser-view-transition-types)
84
+
-[`View Transition`클래스로 애니메이션 커스텀하기](#customize-animations-using-view-transition-class)
85
+
-[`ViewTransition`이벤트로 애니메이션 커스텀하기](#customize-animations-using-viewtransition-events)
86
86
87
-
In the future, we plan to support more use cases for using the cause of a transition.
87
+
향후에는 트랜지션의 원인을 활용할 수 있는 다양한 용례를 지원할 예정입니다.
88
88
89
89
---
90
-
### Customize animations using browser view transition types {/*customize-animations-using-browser-view-transition-types*/}
90
+
### 브라우저 View Transition 타입으로 애니메이션 커스텀하기 {/*customize-animations-using-browser-view-transition-types*/}
91
91
92
-
When a [`ViewTransition`](/reference/react/ViewTransition) activates from a transition, React adds all the Transition Types as browser [view transition types](https://www.w3.org/TR/css-view-transitions-2/#active-view-transition-pseudo-examples) to the element.
92
+
트랜지션에서 [`ViewTransition`](/reference/react/ViewTransition)이 활성화되면, React는 모든 트랜지션 타입을 브라우저의 [View Transition Types](https://www.w3.org/TR/css-view-transitions-2/#active-view-transition-pseudo-examples)으로 해당 요소에 추가합니다.
93
93
94
-
This allows you to customize different animations based on CSS scopes:
94
+
이렇게 하면 CSS 범위에서 다른 애니메이션을 커스텀할 수 있습니다.
95
95
96
96
```js [11]
97
97
functionComponent() {
@@ -118,9 +118,9 @@ startTransition(() => {
118
118
119
119
---
120
120
121
-
### Customize animations using `View Transition`Class {/*customize-animations-using-view-transition-class*/}
121
+
### `View Transition`클래스로 애니메이션 커스텀하기 {/*customize-animations-using-view-transition-class*/}
122
122
123
-
You can customize animations for an activated `ViewTransition` based on type by passing an object to the View Transition Class:
123
+
활성화된 `ViewTransition`에서 타입에 따라 애니메이션을 커스터마이즈하려면, View Transition 클래스에 객체를 전달하면 됩니다.
124
124
125
125
```js
126
126
functionComponent() {
@@ -140,9 +140,9 @@ startTransition(() => {
140
140
});
141
141
```
142
142
143
-
If multiple types match, then they're joined together. If no types match then the special "default" entry is used instead. If any type has the value "none" then that wins and the ViewTransition is disabled (not assigned a name).
143
+
여러 타입이 매칭되면 값들이 결합됩니다. 매칭되는 타입이 없으면 "default" 엔트리가 사용됩니다. 어떤 타입이라도 값이 "none"이면 해당 값이 우선하며 `ViewTransition`은 비활성화됩니다. (이름이 할당되지 않습니다).
144
144
145
-
These can be combined with enter/exit/update/layout/share props to match based on kind of trigger and Transition Type.
145
+
이 방식은 enter/exit/update/layout/share Props와 결합하여 트리거 종류와 트랜지션 타입에 따라 동작을 맞출 수 있습니다.
146
146
147
147
```js
148
148
<ViewTransition enter={{
@@ -157,9 +157,9 @@ exit={{
157
157
158
158
---
159
159
160
-
### Customize animations using `ViewTransition`events {/*customize-animations-using-viewtransition-events*/}
160
+
### `ViewTransition`이벤트로 애니메이션 커스텀하기 {/*customize-animations-using-viewtransition-events*/}
161
161
162
-
You can imperatively customize animations for an activated `ViewTransition` based on type using View Transition events:
162
+
View Transition 이벤트를 활용하여 타입에 따라 활성화된 `ViewTransition`의 애니메이션을 즉시 커스터마이즈할 수 있습니다.
163
163
164
164
```
165
165
<ViewTransition onUpdate={(inst, types) => {
@@ -173,10 +173,10 @@ You can imperatively customize animations for an activated `ViewTransition` base
173
173
}}>
174
174
```
175
175
176
-
This allows you to pick different imperative Animations based on the cause.
Copy file name to clipboardExpand all lines: src/content/reference/react/apis.md
+10-6Lines changed: 10 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,19 @@ title: "내장 React API"
7
7
[Hook](/reference/react/hooks)과 [컴포넌트](/reference/react/components) 외에도 `react` 패키지는 컴포넌트를 정의하는데 유용한 몇 가지 API를 가지고 있습니다. 이 페이지는 최신 React API를 모두 나열합니다.
8
8
9
9
</Intro>
10
-
{/*React 영문 공식 문서에 반영되지 않은 내용 임의로 수정하여 반영하였습니다. `cahce` 및 `use`에 대한 내용 설명을 제외하고 수정하지 말아주세요*/}
10
+
{/*React 영문 공식 문서에 반영되지 않은 내용 임의로 수정하여 반영하였습니다. `cache` 및 `use`에 대한 내용 설명을 제외하고 수정하지 말아주세요*/}
11
11
---
12
-
*[`act`](/reference/react/act) lets you wrap renders and interactions in tests to ensure updates have processed before making assertions.
12
+
*[`act`](/reference/react/act)를 통해 테스트에서 렌더링이나 상호작용을 감싸서 관련된 업데이트가 모두 처리된 뒤에 검증합니다.
13
13
*[`cache`](/reference/react/cache)를 통해 가져온 데이터나 연산의 결과를 캐싱합니다.
14
-
*[`createContext`](/reference/react/createContext) lets you define and provide context to the child components. Used with [`useContext`.](/reference/react/useContext)
15
-
*[`lazy`](/reference/react/lazy) lets you defer loading a component's code until it's rendered for the first time.
16
-
*[`memo`](/reference/react/memo) lets your component skip re-renders with same props. Used with [`useMemo`](/reference/react/useMemo) and [`useCallback`.](/reference/react/useCallback)
17
-
*[`startTransition`](/reference/react/startTransition) lets you mark a state update as non-urgent. Similar to [`useTransition`.](/reference/react/useTransition)
14
+
*[`captureOwnerStack`](/reference/react/captureOwnerStack)을 통해 개발 환경에서 현재 Owner Stack을 읽고, 사용가능한 문자열을 반환합니다.
15
+
*[`createContext`](/reference/react/createContext)를 통해 자식 컴포넌트들에게 전달할 수 있는 컨텍스트를 정의하고 제공합니다. 보통 [`useContext`](/reference/react/useContext)와 함께 사용합니다.
16
+
*[`lazy`](/reference/react/lazy)를 통해 컴포넌트가 처음 렌더링될 때까지 해당 컴포넌트의 코드를 로딩하는 것을 지연합니다.
17
+
*[`memo`](/reference/react/memo)를 통해 동일한 Props일 경우 컴포넌트가 다시 렌더링되지 않도록 최적화합니다. 주로 [`useMemo`](/reference/react/useMemo), [`useCallback`](/reference/react/useCallback)과 함께 사용합니다.
18
+
*[`startTransition`](/reference/react/startTransition)을 통해 상태 업데이트를 "덜 긴급한 작업"으로 표시하여 UI의 반응성을 유지합니다. [`useTransition`](/reference/react/useTransition)과 유사합니다.
18
19
*[`use`](/reference/react/use)는 Promise나 Context와 같은 데이터를 참조하는 React Hook입니다.
20
+
*[`taintObjectReference`](/reference/react/experimental_taintObjectReference)를 통해 `user` 객체와 같은 특정한 객체 인스턴스를 클라이언트 컴포넌트로 전송하는 것을 방지합니다.
21
+
*[`taintUniqueValue`](/reference/react/experimental_taintUniqueValue)를 통해 패스워드, 키 또는 토큰과 같은 고유 값을 클라이언트 컴포넌트로 전송하는 것을 방지합니다.
22
+
*[`addTransitionType`](/reference/react/addTransitionType)를 통해, 트랜지션이 발생한 원인을 상세히 나타냅니다.
If no Owner Stack is available, `null` is returned (see [Troubleshooting: The Owner Stack is `null`](#the-owner-stack-is-null)).
50
+
Owner Stack을 사용할 수 없는 경우, `null`을 반환합니다. ([문제해결: Owner Stack이 `null`인 경우](#the-owner-stack-is-null))
51
51
52
-
#### Caveats {/*caveats*/}
52
+
#### 주의 사항 {/*caveats*/}
53
53
54
-
- Owner Stacks are only available in development. `captureOwnerStack` will always return `null` outside of development.
54
+
- Owner Stack은 개발 환경에서만 사용할 수 있습니다. `captureOwnerStack`은 개발 환경 밖에서는 항상 `null`을 반환합니다.
55
55
56
56
<DeepDive>
57
57
58
58
#### Owner Stack vs Component Stack {/*owner-stack-vs-component-stack*/}
59
59
60
-
The Owner Stack is different from the Component Stack available in React error handlers like [`errorInfo.componentStack` in `onUncaughtError`](/reference/react-dom/client/hydrateRoot#show-a-dialog-for-uncaught-errors).
60
+
Owner Stack은 [`onUncaughtError` 내부의 `errorInfo.componentStack`](/reference/react-dom/client/hydrateRoot#show-a-dialog-for-uncaught-errors)과 같은 React 오류 핸들러에서 사용할 수 있는 컴포넌트 Stack과 다릅니다.
Neither `App` nor the DOM components (e.g.`fieldset`) are considered Owners in this Stack since they didn't contribute to "creating" the node containing `SubComponent`. `App` and DOM components only forwarded the node. `App` just rendered the `children` node as opposed to `Component` which created a node containing `SubComponent` via `<SubComponent />`.
157
+
`App`과 DOM 컴포넌트들(예:`fieldset`)은 `SubComponent`를 포함하는 노드를 "생성하는" 데에 기여하지 않기 때문 이 스택에 포함되지 않습니다. `App`과 DOM 컴포넌트들은 노드를 전달할 뿐입니다. `App`은 `<SubComponent />`를 통해 `SubComponent`를 포함한 노드를 생성하는 `Component`와 달리 `children` 노드만 렌더링합니다.
158
158
159
-
Neither `Navigation` nor `legend` are in the stack at all since it's only a sibling to a node containing `<SubComponent />`.
159
+
`Navigation`과 `legend`는 `<SubComponent />`를 포함하는 노드의 형제 요소이기 때문에 스택에 전혀 포함되지 않습니다.
160
160
161
-
`SubComponent` is omitted because it's already part of the callstack.
161
+
`SubComponent`는 이미 호출 스택에 포함되어 있기 떄문에 Owner Stack에 나타나지 않습니다.
162
162
163
163
</DeepDive>
164
164
165
-
## Usage {/*usage*/}
165
+
## 사용법 {/*usage*/}
166
166
167
-
### Enhance a custom error overlay {/*enhance-a-custom-error-overlay*/}
@@ -183,7 +183,7 @@ console.error = function patchedConsoleError(...args) {
183
183
};
184
184
```
185
185
186
-
If you intercept <CodeStepstep={1}>`console.error`</CodeStep> calls to highlight them in an error overlay, you can call <CodeStepstep={2}>`captureOwnerStack`</CodeStep> to include the Owner Stack.
186
+
<CodeStepstep={1}>`console.error`</CodeStep> 호출을 가로채서 오류 오버레이에 표시하고 싶다면, <CodeStepstep={2}>`captureOwnerStack`</CodeStep>을 호출하여 `OwnerStack`을 포함할 수 있습니다.
187
187
188
188
<Sandpack>
189
189
@@ -347,13 +347,13 @@ export default function App() {
347
347
348
348
</Sandpack>
349
349
350
-
## Troubleshooting {/*troubleshooting*/}
350
+
## 문제 해결 {/*troubleshooting*/}
351
351
352
-
### The Owner Stack is `null` {/*the-owner-stack-is-null*/}
352
+
### Owner Stack이 `null`인 경우 {/*the-owner-stack-is-null*/}
353
353
354
-
The call of `captureOwnerStack` happened outside of a React controlled function e.g. in a `setTimeout` callback, after a `fetch` call or in a custom DOM event handler. During render, Effects, React event handlers, and React error handlers (e.g.`hydrateRoot#options.onCaughtError`) Owner Stacks should be available.
354
+
`captureOwnerStack`이 `setTimeout` 콜백과 같이 React가 제어하지 않는 함수 바깥에서 호출됐을 경우, `fetch` 호출 후, 커스텀 DOM 이벤트 핸들러 등에서는 Owner Stack이 `null`이 됩니다. 렌더링 중이나 Effect, React 이벤트 핸들러, React 오류 핸들러 (예:`hydrateRoot#options.onCaughtError`) 내에서만 생성됩니다.
355
355
356
-
In the example below, clicking the button will log an empty Owner Stack because `captureOwnerStack` was called during a custom DOM event handler. The Owner Stack must be captured earlier e.g. by moving the call of `captureOwnerStack` into the Effect body.
356
+
아래 예시에서, 버튼을 클릭하면 빈 Owner Stack이 로그로 출력됩니다. 그 이유는 `captureOwnerStack`이 커스텀 이벤트 핸들러 내에서 호출되었기 때문입니다. Owner Stack은 더 이른 시점, 예를 들어 이펙트 내부에서 `captureOwnerStack`를 호출하도록 이동시켜야 올바르게 캡처할 수 있습니다.
357
357
<Sandpack>
358
358
359
359
```js
@@ -381,9 +381,9 @@ export default function App() {
381
381
382
382
</Sandpack>
383
383
384
-
### `captureOwnerStack` is not available {/*captureownerstack-is-not-available*/}
384
+
### `captureOwnerStack`을 사용할 수 없는 경우 {/*captureownerstack-is-not-available*/}
385
385
386
-
`captureOwnerStack` is only exported in development builds. It will be`undefined` in production builds. If `captureOwnerStack` is used in files that are bundled for production and development, you should conditionally access it from a namespace import.
386
+
`captureOwnerStack`은 개발 환경 빌드에서만 Export됩니다. 프로덕션 환경 빌드에서는`undefined`입니다. `captureOwnerStack`이 개발과 프로덕션이 모두 번들링되는 파일에서 사용될 때는 네임스페이스 `import`를 사용하고 조건부로 접근해야 합니다.
387
387
388
388
```js
389
389
// Don't use named imports of `captureOwnerStack` in files that are bundled for development and production.
0 commit comments