Skip to content

docs(rolldown): update plugin-react-oxc mention #2107

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 7, 2025
Merged

docs(rolldown): update plugin-react-oxc mention #2107

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions guide/rolldown.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -145,11 +145,17 @@ Rolldown と Oxc のおかげで、エイリアスや resolve プラグインな

これらをテストするには、Vite の設定で `experimental.enableNativePlugin` オプションを `true` に設定できます。

### `@vitejs/plugin-react-oxc`
### Oxc の React refresh transform を活用

`@vitejs/plugin-react` または `@vitejs/plugin-react-swc` を使用している場合、React の高速リフレッシュに Babel や SWC の代わりに Oxc を使用する `@vitejs/plugin-react-oxc` プラグインに切り替えることができます。これはドロップイン置換として設計されており、ビルドパフォーマンスを向上させ、`rolldown-vite` の基盤となるアーキテクチャと連携します。
`@vitejs/plugin-react` v5.0.0+ では、Oxc の React refresh transform を使用します。Babel プラグイン（React コンパイラーを含む）を一切使用していない場合、完全な変換は Oxc によって実行されるため、`@vitejs/plugin-react` を更新するだけでビルドパフォーマンスが向上します。

Babel または SWC プラグイン（React コンパイラーを含む）を使用していない場合、または SWC オプションを変更していない場合にのみ、`@vitejs/plugin-react-oxc` に切り替えられることに注意してください。
SWC プラグインとカスタム SWC オプションなしで `@vitejs/plugin-react-swc` を使用している場合は、`@vitejs/plugin-react` プラグインに切り替えて Oxc を利用できます。

::: details `@vitejs/plugin-react-oxc` プラグインは非推奨に

以前は、Oxc の React refresh transform を利用するために `@vitejs/plugin-react-oxc` の使用を推奨していました。しかし、`rolldown-vite` への切り替えを容易にするため、実装を `@vitejs/plugin-react` に統合しました。`@vitejs/plugin-react-oxc` は非推奨となり、今後は更新されません。

:::

### `withFilter` ラッパー

Expand Down