Skip to content

Commit 5fc7562

Browse files
authored
docs: update server-actions.md (#1075)
1 parent d7e9ab8 commit 5fc7562

File tree

1 file changed

+29
-30
lines changed

1 file changed

+29
-30
lines changed

src/content/reference/rsc/server-actions.md

+29-30
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,33 @@
11
---
2-
title: Server Actions
2+
title: 서버 액션
33
canary: true
44
---
55

66
<Intro>
77

8-
Server Actions를 사용하면 클라이언트 컴포넌트가 서버에서 실행되는 비동기 함수를 호출할 수 있습니다.
8+
서버 액션(Server Action)을 사용하면 클라이언트 컴포넌트가 서버에서 실행되는 비동기 함수를 호출할 수 있습니다.
99

1010
</Intro>
1111

1212
<InlineToc />
1313

1414
<Note>
1515

16-
#### Server Actions에 대한 지원은 어떻게 구축하나요? {/*how-do-i-build-support-for-server-actions*/}
16+
#### 서버 액션을 지원하려면 어떻게 해야 하나요? {/*how-do-i-build-support-for-server-actions*/}
1717

18-
React 19의 Server Actions는 안정적이고 주요 버전 간에 중단되지 않지만, React 서버 컴포넌트 bundler 또는 프레임워크에서 Server Actions를 구현하는 데 사용되는 API는 semver를 따르지 않으며 React 19.x의 마이너 버전에서는 중단될 수 있습니다.
18+
React 19의 서버 액션은 안정적이며 메이저(Major) 버전 간에는 변경되지 않습니다. 그러나 React 서버 컴포넌트 번들러나 프레임워크에서 서버 액션을 구현하는 데 사용되는 기본 API는 시맨틱 버전(semver)을 따르지 않으며 React 19.x의 마이너(Minor) 버전 간에 변경될 수 있습니다.
1919

20-
Server Actions를 bundler 또는 프레임워크로 지원하려면, 특정 React 버전에 고정하거나 카나리(Canary) 릴리즈를 사용하는 것이 좋습니다. 향후 Server Actions를 구현하는 데 사용되는 API를 안정화하기 위해 bundler 및 프레임워크와 계속 협력할 예정입니다.
20+
서버 액션을 번들러나 프레임워크로 지원하려면, 특정 React 버전에 고정하거나 Canary 릴리즈를 사용하는 것을 권장합니다. 향후 서버 액션을 구현하는 데 사용되는 API를 안정화하기 위해 번들러 및 프레임워크와 계속 협력할 것입니다.
2121

2222
</Note>
2323

24-
Server Action이 `"use server"` 지시어로 정의되면, 프레임워크는 자동으로 서버 함수에 대한 참조를 생성하고 해당 참조를 클라이언트 컴포넌트에 전달합니다. 클라이언트에서 해당 함수가 호출되면, React는 서버에 함수를 실행하라는 요청을 보내고 결과를 반환합니다.
24+
서버 액션이 `"use server"` 지시어로 정의되면, 프레임워크는 자동으로 서버 함수에 대한 참조를 생성하고 해당 참조를 클라이언트 컴포넌트에 전달합니다. 클라이언트에서 해당 함수가 호출되면, React는 서버에 함수를 실행하라는 요청(Request)을 보내고 결과를 반환합니다.
2525

26-
Server Actions는 서버 컴포넌트에서 생성하여 클라이언트 컴포넌트 props로 전달하거나 클라이언트 컴포넌트에서 가져와서 사용할 있습니다.
26+
서버 액션은 서버 컴포넌트에서 생성하여 클라이언트 컴포넌트에 props로 전달할 수 있으며, 클라이언트 컴포넌트에서 가져와서 사용할 수도 있습니다.
2727

28-
### 서버 컴포넌트에서 Server Action 만들기 {/*creating-a-server-action-from-a-server-component*/}
28+
### 서버 컴포넌트에서 서버 액션 만들기 {/*creating-a-server-action-from-a-server-component*/}
2929

30-
서버 컴포넌트는 `"use server"` 지시어로 Server Actions를 정의할 수 있습니다.
30+
서버 컴포넌트는 `"use server"` 지시어로 서버 액션을 정의할 수 있습니다.
3131

3232
```js [[2, 7, "'use server'"], [1, 5, "createNoteAction"], [1, 12, "createNoteAction"]]
3333
// Server Component
@@ -45,7 +45,7 @@ function EmptyNote () {
4545
}
4646
```
4747

48-
React가 `EmptyNote` 서버 컴포넌트를 렌더링할 때, `createNoteAction` 함수에 대한 참조를 생성하고, 그 참조를 `Button` 클라이언트 컴포넌트에 전달합니다. 버튼이 클릭 되면, React는 제공된 참조로 `createNoteAction` 함수를 실행하라는 요청을 서버로 보냅니다.
48+
React가 `EmptyNote` 서버 컴포넌트를 렌더링할 때, `createNoteAction` 함수에 대한 참조를 생성하고, 그 참조를 `Button` 클라이언트 컴포넌트에 전달합니다. 버튼을 클릭하면, React는 제공된 참조를 통해 `createNoteAction` 함수를 실행하도록 서버에 요청(Request)을 보냅니다.
4949

5050
```js {5}
5151
"use client";
@@ -59,10 +59,9 @@ export default function Button({onClick}) {
5959

6060
자세한 내용은 [`"use server"`](/reference/rsc/use-server) 문서를 참조하세요.
6161

62+
### 클라이언트 컴포넌트에서 서버 액션 가져오기 {/*importing-server-actions-from-client-components*/}
6263

63-
### 클라이언트 컴포넌트에서 Server Actions 가져오기 {/*importing-server-actions-from-client-components*/}
64-
65-
클라이언트 컴포넌트는 `"use server"` 지시어를 사용하는 파일에서 Server Actions를 가져올 수 있습니다.
64+
클라이언트 컴포넌트는 `"use server"` 지시어를 사용하는 파일에서 서버 액션을 가져올 수 있습니다.
6665

6766
```js [[1, 3, "createNoteAction"]]
6867
"use server";
@@ -73,7 +72,7 @@ export async function createNoteAction() {
7372

7473
```
7574

76-
bundler가 `EmptyNote` 클라이언트 컴포넌트를 빌드할 때, bundle에서 `createNoteAction` 함수에 대한 참조를 생성합니다. 버튼이 클릭 되면, React는 제공된 참조를 사용해 `createNoteAction` 함수를 실행하도록 서버에 요청을 보냅니다.
75+
번들러가 `EmptyNote` 클라이언트 컴포넌트를 빌드할 때, 번들에서 `createNoteAction` 함수에 대한 참조를 생성합니다. 버튼을 클릭하면, React는 제공된 참조를 통해 `createNoteAction` 함수를 실행하도록 서버에 요청(Request)을 보냅니다.
7776

7877
```js [[1, 2, "createNoteAction"], [1, 5, "createNoteAction"], [1, 7, "createNoteAction"]]
7978
"use client";
@@ -88,9 +87,9 @@ function EmptyNote() {
8887

8988
자세한 내용은 [`"use server"`](/reference/rsc/use-server) 문서를 참조하세요.
9089

91-
### 액션으로 Server Actions 구성하기 {/*composing-server-actions-with-actions*/}
90+
### 액션으로 서버 액션 구성하기 {/*composing-server-actions-with-actions*/}
9291

93-
Server Actions는 클라이언트의 액션과 함께 구성할 수 있습니다.
92+
서버 액션은 클라이언트의 액션(Action)과 함께 구성할 수 있습니다.
9493

9594
```js [[1, 3, "updateName"]]
9695
"use server";
@@ -134,15 +133,15 @@ function UpdateName() {
134133
}
135134
```
136135

137-
이렇게 하면 클라이언트의 액션으로 래핑하여 Server Action의 `isPending` 상태에 액세스할 수 있습니다.
136+
이렇게 하면 클라이언트의 액션으로 래핑하여 서버 액션의 `isPending` 상태에 접근할 수 있습니다.
138137

139-
자세한 내용은 [`<form>` 외부에서 Server Action 호출하기](/reference/rsc/use-server#calling-a-server-action-outside-of-form) 문서를 참조하세요.
138+
자세한 내용은 [`<form>` 외부에서 서버 액션 호출하기](/reference/rsc/use-server#calling-a-server-action-outside-of-form) 문서를 참조하세요.
140139

141-
### Server Actions를 사용한 폼 액션 {/*form-actions-with-server-actions*/}
140+
### 서버 액션을 사용한 폼 액션 {/*form-actions-with-server-actions*/}
142141

143-
Server Actions는 React 19의 새로운 폼 기능과 함께 작동합니다.
142+
서버 액션은 React 19의 새로운 폼(Form) 기능과 함께 동작합니다.
144143

145-
Server Action을 폼에 전달하여 폼을 서버에 자동으로 제출할 수 있습니다.
144+
서버 액션을 폼에 전달하여 폼을 서버에 자동으로 제출할 수 있습니다.
146145

147146

148147
```js [[1, 3, "updateName"], [1, 7, "updateName"]]
@@ -159,13 +158,13 @@ function UpdateName() {
159158
}
160159
```
161160

162-
폼 제출이 성공하면, React는 자동으로 폼을 재설정합니다. 보류 상태, 마지막 응답에 액세스하거나 점진적인 향상을 지원하기 위해 `useActionState`를 추가할 수 있습니다.
161+
폼 제출이 성공하면, React는 자동으로 폼을 재설정합니다. `useActionState`를 추가하여 대기(Pending) 상태 혹은 마지막 응답(Response)에 접근하거나, 점진적 향상을 지원할 수 있습니다.
163162

164-
자세한 내용은 [Server Actions 형식](/reference/rsc/use-server#server-actions-in-forms) 문서를 참조하세요.
163+
자세한 내용은 [서버 액션 형식](/reference/rsc/use-server#server-actions-in-forms) 문서를 참조하세요.
165164

166-
### `useActionState`를 사용한 Server Actions {/*server-actions-with-use-action-state*/}
165+
### `useActionState`를 사용한 서버 액션 {/*server-actions-with-use-action-state*/}
167166

168-
액션 보류 상태와 마지막으로 반환된 응답에 액세스하기만 하면 되는 일반적인 경우에는 `useActionState`를 사용하여 Server Actions를 구성할 수 있습니다.
167+
액션 대기(Pending) 상태와 마지막으로 반환된 응답(Response)에 접근하는 일반적인 경우에는 `useActionState`를 사용하여 서버 액션을 구성할 수 있습니다.
169168

170169
```js [[1, 3, "updateName"], [1, 6, "updateName"], [2, 6, "submitAction"], [2, 9, "submitAction"]]
171170
"use client";
@@ -184,13 +183,13 @@ function UpdateName() {
184183
}
185184
```
186185

187-
Server Actions와 함께 `useActionState`를 사용하는 경우, React는 hydration이 완료되기 전에 입력된 폼 제출 또한 자동으로 재생합니다. 즉, 사용자는 앱이 hydration 되기 전에도 앱과 상호작용을 할 수 있습니다.
186+
서버 액션과 함께 `useActionState`를 사용하는 경우, React는 Hydration이 완료되기 전에 입력된 폼 제출을 자동으로 다시 실행합니다. 즉, 사용자는 앱이 Hydration 되기 전에도 앱과 상호작용을 할 수 있습니다.
188187

189-
자세한 내용은 [`useActionState`](/reference/react-dom/hooks/useFormState) 문서를 참조하세요.
188+
자세한 내용은 [`useActionState`](/reference/react/useActionState) 문서를 참조하세요.
190189

191190
### `useActionState`를 통한 점진적 향상 {/*progressive-enhancement-with-useactionstate*/}
192191

193-
Server Actions는 `useActionState`의 세 번째 인수를 통해 점진적 향상도 지원합니다.
192+
서버 액션은 `useActionState`의 세 번째 인수를 통한 점진적 향상도 지원합니다.
194193

195194
```js [[1, 3, "updateName"], [1, 6, "updateName"], [2, 6, "/name/update"], [3, 6, "submitAction"], [3, 9, "submitAction"]]
196195
"use client";
@@ -208,6 +207,6 @@ function UpdateName() {
208207
}
209208
```
210209

211-
<CodeStep step={2}>permalink</CodeStep>가 `useActionState`에 제공될 때, 자바스크립트 bundle이 로드되기 전에 폼이 제출되면 React는 제공된 URL로 리디렉션합니다.
210+
<CodeStep step={2}>permalink</CodeStep>가 `useActionState`에 제공될 때, 자바스크립트 번들이 로드되기 전에 폼이 제출되면 React는 제공된 URL로 리디렉션합니다.
212211

213-
자세한 내용은 [`useActionState`](/reference/react-dom/hooks/useFormState) 문서를 참조하세요.
212+
자세한 내용은 [`useActionState`](/reference/react/useActionState) 문서를 참조하세요.

0 commit comments

Comments
 (0)