Skip to content

docs: 자동 번역 업데이트 (2026-07-30) - #426

Open
github-actions[bot] wants to merge 1 commit into
master-kofrom
auto-translate-github-20260730003743
Open

docs: 자동 번역 업데이트 (2026-07-30)#426
github-actions[bot] wants to merge 1 commit into
master-kofrom
auto-translate-github-20260730003743

Conversation

@github-actions

Copy link
Copy Markdown

자동 번역 (GitHub Models API)

번역 상세 내역

🆕 ./content/docs/useformstate/formstatesubscribe.mdx — 신규 번역
🔄 ./content/docs/usecontroller/controller.mdx — diff 기반 변경점 반영 (1줄)
🔄 ./content/docs/useform.mdx — diff 기반 변경점 반영 (36줄)
🔄 ./content/docs/useform/clearerrors.mdx — diff 기반 변경점 반영 (2줄)
🔄 ./content/docs/useform/handlesubmit.mdx — diff 기반 변경점 반영 (0줄)
🔄 ./content/docs/useform/register.mdx — diff 기반 변경점 반영 (14줄)
🔄 ./content/docs/useform/reset.mdx — diff 기반 변경점 반영 (2줄)
🔄 ./content/docs/useform/seterror.mdx — diff 기반 변경점 반영 (4줄)
🔄 ./content/docs/useform/setvalue.mdx — diff 기반 변경점 반영 (0줄)
🔄 ./content/docs/useform/subscribe.mdx — diff 기반 변경점 반영 (1줄)
🔄 ./content/docs/useformstate.mdx — diff 기반 변경점 반영 (5줄)
🔄 ./content/docs/usewatch.mdx — diff 기반 변경점 반영 (9줄)

사용 모델

  • openai/gpt-4o-mini via GitHub Models API

참고

  • 번역 규칙: AGENTS.md, .claude/skills/translate.md
  • 이 PR은 자동 생성되었습니다. 리뷰 후 머지해주세요.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

번역 리뷰 (GitHub Models)

요약 (파일별)

  • src/content/docs/usecontroller/controller.mdx: 'exact' 속성을 추가하였습니다.
  • src/content/docs/useform.mdx: 변경된 내용에서 자연스러운 한국어 번역이 이루어졌다.
  • src/content/docs/useform/clearerrors.mdx: 메서드 설명에서 용어 일관성을 유지하며 표현이 더 자연스럽게 개선됨.
  • src/content/docs/useform/handlesubmit.mdx: 비동기 제출에 대한 설명을 포함한 텍스트 삭제.
  • src/content/docs/useform/register.mdx: 변경 사항에서 기술적인 용어와 자연스러운 표현이 개선되었습니다.
  • src/content/docs/useform/reset.mdx: reset 설명과 관련된 내용을 더 명확하게 다듬었으며, 추천사항을 추가하여 완성도를 높였습니다.
  • src/content/docs/useform/seterror.mdx: 변경된 라인이 일부 번역 규칙을 준수하지 않으며, 개선이 필요하다.
  • src/content/docs/useform/setvalue.mdx: 존재하지 않는 필드에 대한 설명이 삭제되었고, 리렌더링 조건에 대한 내용이 제거되었습니다.
  • src/content/docs/useform/subscribe.mdx: formstate의 대문자 사용 및 '변경 사항'으로의 교체가 적절하게 반영되었다.
  • src/content/docs/useformstate.mdx: 'FormStateSubscribe'의 한국어 번역이 추가되었습니다.
  • src/content/docs/useformstate/formstatesubscribe.mdx: '업데이트를'을 '업데이트에'로 변경하여 자연스러운 문장 흐름을 개선하였습니다.
  • src/content/docs/usewatch.mdx: 변경 내용이 기술적 정밀성을 유지하면서도 자연스러운 한국어로 표현되어 있다.

openai/gpt-4o-mini via GitHub Models | 파일 12개 | 인라인 코멘트 32개 | 스킵 0개

| `shouldUnregister` | <TypeText>boolean = false`</TypeText> | | 입력 값은 언마운트 후에 등록이 해제(unregistered)되며, 기본값도 제거됩니다.<br/><br/>**참고:** 이 prop은 `useFieldArray`와 함께 사용하지 않아야 합니다. 입력 값이 언마운트/리마운트 및 재정렬된 후에 `unregister`함수가 호출되기 때문입니다. |
| `disabled` | <TypeText>boolean = false`</TypeText> | | `disabled` prop은 `field` prop에서 반환됩니다. 제어 입력 필드는 비활성화되며, 그 값은 제출 데이터에서 제외됩니다. |
| `defaultValue` | <TypeText>unknown</TypeText> | | **중요:** `useForm`의 `defaultValues` 또는 `defaultValue`에 `undefined`를 적용할 수 없습니다. <ul><li>필드 레벨에서 `defaultValue`를 설정하거나 `useForm`의 `defaultValues`를 사용해야 합니다. <code>useForm</code>에서 <code>defaultValues</code>를 사용한 경우, 이 prop은 생략하세요.</li><li>폼이 기본값으로 `reset`을 호출할 예정이라면, `useForm`에 `defaultValues`를 제공해야 합니다.</li><li>`undefined`를 사용하여 `onChange`를 호출하는 것은 유효하지 않습니다. 대신 `null` 또는 빈 문자열을 기본값/초기화된 값으로 사용해야 합니다.</li></ul> |
| `exact` | <TypeText>boolean = false</TypeText> | | 이 속성(prop)은 인풋 이름 구독에 대해 정확한 일치를 가능하게 하며, 기본값은 true입니다.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 이 속성(prop)은 인풋 이름 구독에 대해 정확한 일치를 가능하게 하며, 기본값은 true입니다.이 속성(prop)은 인풋 이름 구독에 대해 정확한 일치를 가능하게 하며, 기본값은 true입니다.
평가: 'exact'에 대한 설명이 명확하고 일관된 용어를 사용하고 있어 좋습니다.

| [criteriaMode](#criteriaMode) | 모든 유효성 검사 에러를 한 번에 노출하거나 하나씩 노출. |
| [shouldFocusError](#shouldFocusError) | 내장된 포커스 관리를 활성화하거나 비활성화. |
| [delayError](#delayError) | 에러가 즉시 나타나는 것을 지연. |
| [validate](#validate) | 폼 수준 검증은 내장 검증 메서드로 제한됩니다. |

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 폼 수준 검증은 내장 검증 메서드로 제한됩니다.폼 수준 검증은 내장 검증 메서드로 제한됩니다.
평가: 자연스러운 번역이며 의미가 잘 전달된다.

| [validate](#validate) | 폼 수준 검증은 내장 검증 메서드로 제한됩니다. |
| [shouldUseNativeValidation](#shouldUseNativeValidation) | 브라우저 내장 폼 제약 조건 API 사용. |
| [shouldUnregister](#shouldUnregister) | 언마운트 후 입력의 등록 취소(unregister)를 활성화하거나 비활성화. |
| [progressive](/docs/useform/form) | `Form` 컴포넌트를 사용할 때 네이티브 폼 제출을 위한 점진적 향상을 활성화합니다. |

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 네이티브 폼 제출을 위한 점진적 향상을 활성화합니다.네이티브 폼 제출을 위한 점진적 향상을 활성화합니다.
평가: 기술적인 정확성이 유지되고 있다.


---

이 예제는 React 애플리케이션에서 **폼 수준 검증**을 수행하기 위해 **새로운 `validate` API**와 `useForm`을 결합하여 사용하는 방법을 보여줍니다.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 폼 수준 검증을 수행하기 위해 새로운 API와 useForm을 결합하여 사용하는 방법입니다.폼 수준 검증을 수행하기 위해 새로운 validateAPI와useForm을 결합하여 사용하는 방법을 보여줍니다.
평가: 의미가 명확해졌으며 정보가 잘 전달된다.

return {
type: "formError",
message: "어딘가에 문제가 있습니다.",
}

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 어딘가에 문제가 있습니다.어딘가에 문제가 있습니다.
평가: 자연스러운 번역이며 한국어 문법에 어울린다.

| Name | Type | Description |
| ---------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `control` | <TypeText>Object</TypeText> | `useForm`에서 제공하는 [`control`](/docs/useform/control) 객체입니다. `FormProvider`를 사용하는 경우에 선택 사항입니다. |
| `name` | <TypeText>string \| string[] </TypeText> | 단일 인풋 이름, 인풋 이름의 배열 또는 모든 인풋의 폼 상태 업데이트에 구독하도록 제공합니다. |

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 이름 배열을 제공하거나이름의 배열 또는
평가: 더 자연스럽고 간결한 표현으로 개선되었습니다.

| `name` | <TypeText>string \| string[] </TypeText> | 단일 인풋 이름, 인풋 이름의 배열 또는 모든 인풋의 폼 상태 업데이트에 구독하도록 제공합니다. |
| `disabled` | <TypeText>boolean = false</TypeText> | 구독을 비활성화하는 옵션입니다. |
| `exact` | <TypeText>boolean = false</TypeText> | 이 속성은 인풋 이름 구독에 대해 정확한 일치를 활성화합니다. |
| `render` | <TypeText>Function</TypeText> | 지정된 폼 필드의 폼 상태에 구독하고 폼 상태가 변경될 때마다 자식 함수를 리렌더링합니다. 이를 통해 상태를 수동으로 연결하지 않고도 JSX에서 선언적으로 폼 상태를 사용할 수 있습니다. |

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 상태를 구독하고,상태에 구독하고
평가: 더 명확한 표현으로 변경되어 문맥상 더 이해하기 쉬워졌습니다.

<input {...register("foo", { min: 3 })} />
<input {...register("bar")} />
{/* `foo`의 폼 상태가 변경될 때만 리렌더링 */}
{/* `foo`의 폼 상태가 변경될 때만 리렌더링됩니다. */}

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: 리렌더링-리렌더링됩니다.
평가: 문장 구조가 개선되어 자연스러운 한국어 문장으로 변환되었습니다.

sidebar: apiLinks
---

<SelectNav

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: {-{}-}{+<SelectNav+}
평가: SelectNav의 경우 번역할 필요가 없으며, 영어 표현을 그대로 유지하여 기술적 정밀성을 유지했다.

},
]}
/>
## \</> `useWatch:` <TypeText>`({ control?: Control, name?: string, defaultValue?: unknown, disabled?: boolean }) => object`</TypeText>

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

변경: {-useWatch:-}{+useWatch:+}
평가: 함수명은 원래의 기술적 표현을 유지해야 하므로 영어를 그대로 사용한 것이 맞다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants