Repository navigation
New Translation Progress Checklist #452
Description
ページを翻訳したい方へ:
重複作業を防ぐため、まずはここでどのページを翻訳するか宣言してください。宣言なしで翻訳が行われて他の人の作業と被ってしまった場合、原則として(PRを先に作った人ではなく)ここで最初に宣言があった人を優先します。ただし宣言が行われて 1 週間以上 PR が作成されないなどの場合は適宜対応します。
スタイルガイドおよび単語リストをチェックして、翻訳が一貫した方法で書かれていることを確認してください。
New Articles
Progress : (🏃 進行中の作業; 👀 レビュー中)
Main Content
To do before releasing as an "official" translation. Please translate these pages first.
Note that each section has an index page, which needs to be translated too.
Learn React
-
Quick Start (@smikitky Translate "Quick Start" (index) #559)
- Tutorial: Tic Tac Toe (@smikitky Translate "Tutorial: Tic-tac-toe" #562)
- Thinking in React (@smikitky Translate "Thinking in React" #560)
-
Installation (@smikitky, Translate articles under 'install' section #555)
- Start a New React Project (@smikitky, Translate articles under 'install' section #555)
- Add React to an Existing Project (@smikitky, Translate articles under 'install' section #555)
- Editor Setup (@smikitky, Translate articles under 'install' section #555)
- Using TypeScript (@smikitky, Translate "Using TypeScript" #659)
- React Developer Tools (@smikitky, Translate articles under 'install' section #555)
-
Describing the UI (@smikitky Translate "Describing the UI" chapter #556)
- Your First Component (@smikitky, Translate two pages and some MDX tags #451)
- Importing and Exporting Components (@smikitky, Translate two pages and some MDX tags #451)
- Writing Markup with JSX (@smikitky Translate two articles (JSX and curly braces) #459)
- JavaScript in JSX with Curly Braces (@smikitky Translate two articles (JSX and curly braces) #459)
- Passing Props to a Component (@smikitky Translate "Passing props to a component" #461)
- Conditional Rendering (@smikitky Translate "Describing the UI" chapter #556)
- Rendering Lists (@smikitky Translate "Describing the UI" chapter #556)
- Keeping Components Pure (@smikitky Translate "Describing the UI" chapter #556)
- Understanding Your UI as a Tree (@smikitky, Sync with react.dev @ a0cacd7d #706)
-
Adding Interactivity (@pasteisdenata, adding-interactivity 翻訳済み #491)
- Responding to Events (@smikitky, Translate first 3 articles under "Adding Interactivity" #567)
- State: A Component's Memory (@smikitky, Translate first 3 articles under "Adding Interactivity" #567)
- Render and Commit (@smikitky, Translate first 3 articles under "Adding Interactivity" #567)
- State as a Snapshot (@smikitky, Translate two articles under "Adding Interactivity" #569)
- Queueing a Series of State Updates (@smikitky, Translate two articles under "Adding Interactivity" #569)
- Updating Objects in State (@smikitky, Translate last 2 articles under "Adding interactivity" #574)
- Updating Arrays in State (@smikitky, Translate last 2 articles under "Adding interactivity" #574)
-
Managing State (@smikitky, Translate "Managing State" and unify styles of chapter top pages #610)
- Reacting to Input with State (@youliangdao, Reacting to input with state翻訳 #571)
- Choosing the State Structure (@smikitky, Translate "Choosing the State Structure" #588)
- Sharing State Between Components (@smikitky, Translate "Sharing State Between Components" #582)
- Preserving and Resetting State (@smikitky, Translate "Preserving and Resetting State" #583)
- Extracting State Logic into a Reducer (@smikitky, Translate "Extracting State Logic into a Reducer" #584)
- Passing Data Deeply with Context (@smikitky, Translate "Passing Data Deeply with Context" #586)
- Scaling Up with Reducer and Context (@smikitky, Translate "Scaling Up with Reducer and Context" #587)
-
Escape Hatches (@smikitky, Translate "Escape Hatches" #620)
- Referencing Values with Refs (@smikitky, Translate "Referencing Values with Refs" #590)
- Manipulating the DOM with Refs (@smikitky, Translate "Manipulating the DOM with Refs" #589)
- Synchronizing with Effects (@smikitky, Translate "Synchronizing with Effects" #594)
- You Might Not Need an Effect (@smikitky, Translate "You might not need an effect" #604)
- Lifecycle of Reactive Effects (@yuta-ike, Translate "Lifecycle of Reactive Effects" #601)
- Separating Events from Effects (@kotaesaki, Translate "Separating Events from Effects" #609)
- Removing Effect Dependencies (@smikitky, Translate "Removing Effect Dependencies" #611)
- Reusing Logic with Custom Hooks (@smikitky, Translate "Reusing Logic with Custom Hooks" #605)
API Reference
-
react: Hooks (@Hayao0819, Translate "Hooks" index page #618)-
use(@smikitky, Translate "use" Hook reference #687) -
useCallback(@seckie, Translate "useCallback" hook reference #591) -
useContext(@jp-knj, Translate useContext reference #621) -
useDebugValue(@seckie, Translate useDebugValue hook reference #573) -
useDeferredValue(@smikitky, Translate "useDeferredValue" reference #622) -
useEffect(@smikitky, Translate useEffect hook reference #568) -
useId(@sbasken, Translate useId reference #608) -
useImperativeHandle(@sbasken, Translate useImperativeHandle reference #614) -
useInsertionEffect(@smikitky, Translate "useInsertionEffect" #625) -
useLayoutEffect(@smikitky, Translate "useLayoutEffect" #624) -
useMemo(@yuta-ike, Translate "useMemo" #643) -
useOptimistic(@smikitky, Translate "useOptimistic" #717) -
useReducer(@locol23, Translate "useReducer" #641) -
useRef(@yuta-ike, Translate "useRef" reference #613) -
useState(@yuta-ike, Translate "useState" #595) -
useSyncExternalStore(@jp-knj, Translate useExternalStore reference #619) -
useTransition(@smikitky, Translate "useTransition" & "startTransition" #623)
-
-
react: Components (@smikitky, Translate React built-in components index #686)-
<Fragment> (<>)(@jp-knj, Translate "<Fragment>" #626) -
<Profiler>(@smikitky, Translate "<Profiler>" #629) -
<StrictMode>(@smikitky, Translate "<StrictMode>" #630) -
<Suspense>(@smikitky, Translate "<Suspense>" #628)
-
-
react: APIs (@natsuokawai, Translate built-in React APIs #636)-
cache(@locol23, Translate "cache" #696) -
createContext(@natsuokawai, Translate createContext #638) -
forwardRef(@smikitky, Translate "forwardRef" #631) -
lazy(@smikitky, Translate "lazy" #633) -
memo(@smikitky, Translate "memo" and unify expressions in Deep Dive #702) -
startTransition(@smikitky, Translate "useTransition" & "startTransition" #623)
-
-
react: Directives (@smikitky, Translate 3 articles on RSC directives #635)-
'use client'(@smikitky, Translate 3 articles on RSC directives #635) -
'use server'(@smikitky, Translate 3 articles on RSC directives #635)
-
-
react-dom: Components (@smikitky, Translate "React DOM Components" index #682)- Common (e.g.
<div>) (@smikitky, Translate "Common Components (e.g., <div>)" #637) -
<input>(@sbasken, Translate "<input>" #646) -
<form>(@smikitky, Translate "<form>" reference #715) -
<option>(@smikitky, Translate "<option>" #678) -
<progress>(@natsuokawai, Translate "<progress>" component #640) -
<select>(@ainoshment, Translate "<select>" component #644) -
<textarea>(@smikitky, Translate "<textarea>" reference #649)
- Common (e.g.
-
react-dom: Hooks (@smikitky, Translate "Built-in React DOM Hooks" #723)-
useFormState(@smikitky, Translate "useFormState" #722) -
useFormStatus(@smikitky, Translate "useFormStatus" #721)
-
-
react-dom: APIs (@smikitky, Transalte "React DOM APIs" index #681)-
createPortal(@smikitky, Translate "createPortal" #647) -
flushSync(@smikitky, Translate "flushSync" reference #650) -
findDOMNode(@jp-knj, Translate "findDOMNode" #670) -
hydrate(@riku929hr, Translate "hydrate" #653) -
render(@smikitky, Translate "render" #663) -
unmountComponentAtNode(@smikitky, Translate "unmountComponentAtNode" #660)
-
-
react-dom/client: Client APIs (@smikitky, Translate react-dom client API index #662)-
createRoot(@smikitky, Translate createRoot #661) -
hydrateRoot(@smikitky, Translate "hydrateRoot" #669)
-
-
react-dom/server: Server APIs (@smikitky, Translate react-dom server API index #656)-
renderToNodeStream(@smikitky, Translate four reactdom/server render methods #655) -
renderToPipeableStream(@smikitky, Translate "renderTo{Readable|Pipable}Stream" #654) -
renderToReadableStream(@smikitky, Translate "renderTo{Readable|Pipable}Stream" #654) -
renderToStaticMarkup(@smikitky, Translate four reactdom/server render methods #655) -
renderToStaticNodeStream(@smikitky, Translate four reactdom/server render methods #655) -
renderToString(@smikitky, Translate four reactdom/server render methods #655)
-
Navigation and UI
We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.
- Homepage (currently in
HomeContent.js) (@smikitky, Translate HomeContent #570) - Sidebars (currently in
src/sidebar*.json) (@smikitky, Finish sidebar translations #658) - Top-level navigation (currently in
TopNav.tsx) (やらない)
When You're Ready...
After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.
Secondary Content
These API pages should ideally be translated too, but they're less urgent and can be done after the others:
- Legacy React APIs (@smikitky, Translate legacy API index #693)
-
Children(@smikitky, Translate "Children" methods #684) -
cloneElement(@smikitky, Translate "cloneElement" #685) -
Component(@smikitky, Translate (legacy, class) "Component" #677) -
createElement(@smikitky, Translate "createElement" #688) -
createFactory(@smikitky, Translate "createFactory" #690) -
createRef(@smikitky, Translate "createRef" #689) -
isValidElement(@smikitky, Translate "isValidElement" #691) -
PureComponent(@smikitky, Translate "PureComponent" #692)
-
Optional Content
These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:
- Community (@smikitky, Translate "Community" #668)
- Blog
- Warnings
Activity
no-yan commentedon Dec 1, 2021
進捗管理用のissueが閉じられていたので、新規issueを開きました。気軽に閉じてください。
この形式でやる場合の懸念点として、Statusの更新が面倒になる可能性があります。どれが更新かわかるようにupstream側で配慮があればよいですが、そうでない場合は頑張って40近いリストから差分を見つける必要がありそうです。
smikitky commentedon Dec 1, 2021
既にちょっと手を付けてはいるのですが、まだブランチプレビューがセットアップされておらず、textlint も動いておらず、本家の方でも認識していなかった細々とした問題が見つかったり…という状況ですので、ひとまずワークフローを確立するのが先決という状況です。
これで大丈夫そうというところで以前のように翻訳者を募集することになると思いますので、しばらくお待ちください。
[-][Beta] Translating New React Docs[/-][+][Beta] Translation progress checklist[/+]pasteisdenata commentedon Mar 24, 2022
こんにちは。技術翻訳をしている者です。オープンソースのプロジェクトに関わった経験はないのですが、是非お手伝いしたく、よろしくお願いします。既にフォークは作成済みです。どのセクションの翻訳から開始すればよいですか。
no-yan commentedon Mar 28, 2022
(メンテナの方々からお返事がないようなので)
ありがとうございます!技術翻訳をされている方ということで心強いです。
"Escape Hatches" 以外のまだ訳されていないセクションを自由に訳していただければと思います。
用語が合っているか既存の訳と照らし合わせたいようなら "Installation" から、そうでなければ "Adding Interactivity", "Managing State", "Quick Start" のいずれかを選んで頂くと良いと思います!
上のチェックリストも更新しておきます。
no-yan commentedon Mar 28, 2022
場合によっては、React 18用の大規模なドキュメント更新がこちらより優先されるかもしれません。
以下のドラフトがマージされて以降になりますが、そちらもご助力いただければ!
reactjs/react.dev#4499
smikitky commentedon Mar 31, 2022
@pasteisdenata @no-yan すみません気付いていませんでした…。
React 18 用の大規模マージについては認識はしています。これはむしろ私(メンテナ)の方でやります(影響範囲大きそうすぎるので逆に自分で確認しながら進めたい)。
ベータドキュメントについても、現時点ではワークフローの準備が整っていないため大々的に進めていない状態です。ただ上記に書いてある技術的問題は概ね解決しそうですので、これから改めて進めていきたいと思っています。ひとまず上記でチェックのついていないものならどれからやっていただいても大丈夫ですが、重複作業を防ぐため、このページで着手するという宣言だけしてください。
なお、本家の方でも新ドキュメントの作業が結構遅れておりこんなことを言われている状況です。恐らく React 18 のリリースも終わったので進み始めるだろうとは思っているのですが、いろいろ流動的なところがある点についてはご了承ください。
pasteisdenata commentedon Apr 4, 2022
@smikitky @no-yan レスポンスが遅れてしまい申し訳ありません。では、Adding Interactivity から開始しますね。取り急ぎ。
pasteisdenata commentedon Apr 17, 2022
@smikitky Responding to Events の翻訳を始めます。
gaearon commentedon Apr 20, 2023
Hi folks,
Just a heads-up that we've done our best to bring
mainandlegacybranches up-to-date with upstream. This brings you to the latest visual design and sets up all the redirects. We don't anticipate more changes necessary onlegacy. Formain, there's a few things you need to be aware of:Thank you so much for your cooperation!
gaearon commentedon Apr 20, 2023
With
legacy, there's some inconsistencies with how the red banners are displayed/translated. Sorry about that. We've added them manually where they were missing, but they might need a manual pass to make it nicer.[-][Beta] Translation progress checklist[/-][+]New Translation Progress Checklist[/+]gaearon commentedon Apr 25, 2023
I've updated the task list to match our main template.
42 remaining items
locol23 commentedon Sep 27, 2023
@smikitky
react: APIsのcacheの翻訳を行っても良いでしょうか?smikitky commentedon Oct 16, 2023
現状の全記事の翻訳 (experimental なのを除く) が終了したので close します! ありがとうございました!
smikitky commentedon Oct 16, 2023
これを close すると https://translations.react.dev/ がうまく動いていないっぽいのでとりあえず reopen します…なぜ…
sbasken commentedon Oct 16, 2023
@smikitky こちらこそ参加させていただきありがとうございました!勉強になりました😃 膨大な量の翻訳、確認作業お疲れ様でした🎉
smikitky commentedon Oct 25, 2023
新しい翻訳が追加されるたびに reopen するのもアレなのでこちらは当面 open にしておきます。
ちなみに translations.react.dev はブラウザから GitHub に以下のような GraphQL クエリを発行してその結果を解析することで動作していました。なのでこれを close してしまうと進行状況が不明になってしまうということのようです。なんという力業…。
GraphQL クエリ
mda38 commentedon Mar 26, 2025
@smikitky

ロゴ横のバージョンを押下して遷移することができるページ (https://ja.react.dev/versions) の翻訳がされていないようです。
対応漏れでしたら、翻訳をしていただけますと幸いです。
smikitky commentedon Apr 16, 2025
@islaree 確かに漏れていましたので #834 で対応します。ありがとうございました。
kenji-arata commentedon Oct 17, 2025
@smikitky
本活動に興味を持ったので、ぜひお手伝いさせていただきたく思っています!
react-compiler周り(
src/content/learn/react-compiler/配下)の翻訳を対応してもよろしいでしょうか?もし他に優先して対応した方が良さそうな箇所ありましたらご教示いただきたいです 🙏
r-kojima commentedon Oct 21, 2025
@smikitky
初めまして。ドキュメントを読んでいたところ、
flushSyncのドキュメント に一部翻訳もれを見つけました。こちらの翻訳を対応してもよろしいでしょうか?細かくて申し訳ありませんが、よろしくお願いします。
smikitky commentedon Oct 21, 2025
@r-kojima 気付いていませんでした、ありがとうございます!
#873 で対応します。
次回からは普通に新しく Issue を立てていただいて OK です。
kenji-arata commentedon Oct 26, 2025
react-compilerのreference記事のconfigrationページの翻訳作業を行います。
具体的なpathで言うと、以下になります。
/reference/react-compiler/configuration/reference/react-compiler/compilationMode/reference/react-compiler/gating/reference/react-compiler/logger/reference/react-compiler/panicThreshold/reference/react-compiler/targetSSakutaro commentedon Dec 5, 2025
英語版ブログ記事:Critical Security Vulnerability in React Server Components
こちらの翻訳作業を行います。