# React

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> 必須プラグイン  ：
>
>
>
> `React` 、  `Vite`  - これらのプラグインは CLion にバンドルされており、デフォルトで有効化されています。
>
>
>
> `JavaScript Debugger`  - このプラグインは CLion にバンドルされており、デフォルトで有効化されています。

React  は、カプセル化されたコンポーネントから複雑なインタラクティブユーザーインターフェースを構築するための JavaScript ライブラリです。 [React オフィシャル Web サイト(英語)](https://facebook.github.io/react/)からライブラリの詳細を参照してください。

CLion は React と連携し、アプリケーションの構成、編集、リントする、実行、デバッグ、保守を支援します。

## 始める前に

Procedure:

1. お使いのコンピューターに [Node.js(英語)](http://nodejs.org/) がインストールされていることを確認してください。

2. JavaScript と TypeScript  および  JavaScript デバッガー  の必須プラグインが   設定 | プラグイン   ページで有効化されていることを確認します。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

3. React  および  Vite  プラグインを   設定 | プラグイン   ページに、 [JetBrains Marketplace からプラグインをインストールする](managing-plugins.html#install_plugin_from_repo)で説明されているとおりにインストールします。

## 新しい React アプリケーションを作成する

> **Note:**
> 新しい React シングルページアプリケーションを開始する推奨方法は、 [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite) パッケージで、CLion が [npx](https://www.npmjs.com/package/npx) を使ってダウンロードと実行を行います。 その結果、開発環境は Vite・React・TypeScript 用に事前設定されます。詳細は [Vite 公式サイト](https://blog.logrocket.com/build-react-typescript-app-vite/#benefits-using-react-vite) をご覧ください。

### React アプリケーションを生成する

Procedure:

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

2. 左側のペインで、   React   を選択します。

3. 右側のペイン：

1.

プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。

2.

ノードランタイム   フィールドで使用する Node.js ランタイムを指定します。 リストから設定済みのランタイムを選択するか、   追加   を選択して新しいランタイムを設定してください。

3.

React CLI   リストから、使用するジェネレーターを選択してください。

* デフォルトの `[npx create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite)` を受け入れると、開発環境が Vite を使用するように事前に構成されます。

* `[npx create-react-アプリ](https://github.com/facebook/create-react-app)` を選択すると、webpack、Babel、ESLint を使用するための開発環境が事前に設定されます。

* 以前にダウンロードしたカスタムジェネレーターを使用するには、 選択 をクリックし、開いたダイアログでジェネレーターへのパスを指定します。

![React pp を作成 - ジェネレーターを選択](https://resources.jetbrains.com/help/img/idea/2026.3/react_create_project_select_generator.png)

4.

オプション:

JSX の代わりに TSX を使用するには、   TypeScript プロジェクトの作成   チェックボックスを選択します。 CLion はアプリケーション用の  `.tsx`  ファイルと  `tsconfig.json`  構成ファイルを生成する。

4. 作成   をクリックすると、CLion は必要な構成ファイルをすべて含む  React  専用プロジェクトを生成し、必要な依存関係をダウンロードします。 CLion は、  npm start  と  JavaScript デバッグ  の構成も作成し、アプリケーションの実行やデバッグ用のデフォルト設定を提供します。

> **Tip:**
> または、組み込みの   ターミナルエミュレータ   を開き、  `npm create vite@latest`  と入力してアプリケーションを作成し、ウィザードの質問に答えて、 [Vite オフィシャル Web サイト(英語)](https://blog.logrocket.com/build-react-typescript-app-vite/#creating-vite-project)から詳細を学習します。

### 空の CLion プロジェクトに React をインストールする

この場合、以下の [React アプリケーションの構築](#react_compiling_application)の説明に従ってビルドパイプラインを自分で設定する必要があります。 [React オフィシャル Web サイト(英語)](https://react.dev/)からプロジェクトに React を追加する方法の詳細を参照してください。

Procedure: 空の CLion プロジェクトを作成する

1. ようこそ   画面で   新規プロジェクト   をクリックするか、メインメニューから  `ファイル | 新規 プロジェクト`  を選択します。 [新規 プロジェクト ダイアログ](null)が開きます。

2. 左側のペインで、   空の プロジェクト   を選択します。 右側のウィンドウで、アプリケーションフォルダーを指定し、   作成   をクリックします。

Procedure: 空のプロジェクトに React をインストールする

1. React  を使用する空のプロジェクトを開きます。

2. コマンドライン シェルまたは組み込みの   ターミナルエミュレータ  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、次を入力します：

`npm install --save react react-dom`

## 既存の React アプリケーションから始める

既存の React アプリケーションの開発を続けるには、CLion で開いて必要な依存関係をダウンロードします。

Procedure: すでにマシン上にあるアプリケーションソースを開く

* ようこそ   画面で   オープン   をクリックするか、メインメニューから  `ファイル | オープン`  を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。

Procedure: バージョン管理からアプリケーションのソースをチェックアウト

1. ようこそ   画面で   リポジトリのクローン   をクリックします。

あるいは、メインメニューから  `ファイル | 新規 | バージョン管理からプロジェクト…`  、  `Git | クローン…`  、  `VCS | バージョン管理から取得`  を選択します。

メインメニューの   Git   の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例:   Mercurial   または   Perforce  。

2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 [プロジェクトのチェックアウト (クローン)](manage-projects-hosted-on-github.html#clone-from-GitHub) を参照してください。

Procedure: 依存関係をダウンロードする

* ポップアップで   'npm install' の実行   または   'yarn install' の実行   をクリックします。

![アプリケーションを開いて依存関係をダウンロードする](https://resources.jetbrains.com/help/img/idea/2026.3/ws_npm_yarn_package_run_npm_install.png)

[npm](https://docs.npmjs.com/)、 [Yarn 1](https://classic.yarnpkg.com/lang/en/)、または [Yarn 2](https://yarnpkg.com/) を使用できます。詳細は [npm と Yarn](installing-and-removing-external-software-using-node-package-manager.html) をご確認ください。

* または、エディターの  `パッケージ.json​​`  のコンテキストメニュー、または   プロジェクト   ツールウィンドウ ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ) で   'npm install' の実行   または   'yarn install' の実行   を選択します。

### プロジェクトのセキュリティ

CLion の外部で作成され、そこにインポートされたプロジェクトを開くと、CLion は、未知のソースコードを含むこのプロジェクトの処理方法を選択できるダイアログを表示します。

次のいずれかのオプションを選択します：

* セーフモードでプレビュー : この場合、CLion はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。 CLion はエディター領域の上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックすることで、いつでもプロジェクトをロードできます。

* プロジェクトを信頼 : この場合、CLion はプロジェクトを開いてロードします。 これは、プロジェクトが初期化され、プラグインが解決され、依存関係が追加され、すべての CLion 機能が利用可能になることを意味します。

* 開かない : この場合、CLion はプロジェクトを開きません。

詳細については、 [プロジェクトのセキュリティ](project-security.html) を参照してください。

> **Tip:**
> ようこそ画面や  `ファイル｜新規｜プロジェクト`  で作成されたプロジェクトは、自動的に信頼済みと見なされます。

## コード補完

CLion は React API や JavaScript コード中の [JSX](https://reactjs.org/docs/introducing-jsx.html) のコード補完を提供します。 コード補完は、React メソッド、React 固有の属性、HTML タグとコンポーネント名、 [React イベント(英語)](https://facebook.github.io/react/docs/events.html#supported-events)、コンポーネントプロパティなどに対して機能します。 [React オフィシャル Web サイト(英語)](https://facebook.github.io/react/docs/dom-elements.html)から詳細を参照してください。

React メソッドのコード補完と React 固有の属性を取得するには、プロジェクトのどこかに  `react.js`  ライブラリファイルが必要です。 通常、ライブラリはすでに  `node_modules`  フォルダーにあります。

### 完全な React メソッド、属性、イベント

デフォルトでは、入力時にコード補完ポップアップが自動的に表示されます。 例：

![補完ポップアップ](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_completion_methods_and_attributes.png)

JSX タグでは、CLion が  `className`  や  `classID`  などの [React 固有の属性](https://facebook.github.io/react/docs/dom-elements.html)、および  `key`  や  `ref`  などの [非 DOM 属性](https://facebook.github.io/react/docs/dom-elements.html) へのコーディング支援を提供します。 さらに、自動補完は、プロジェクトの CSS ファイルで定義されているクラスの名前に対しても機能します。

![CSS クラス名の完成](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_classname.png)

`onClick`  や  `onChange`  などのすべての [React イベント(英語)](https://facebook.github.io/react/docs/events.html#supported-events)は、中括弧    `={}`  または引用符  `""`  とともに自動的に補完することもできます。

![Complete React events](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_events.animated.gif)

デフォルトでは、波括弧が挿入されます。 CLion で常に引用符を追加することや、 [TypeScript 定義ファイル (d.ts)](https://github.com/DefinitelyTyped/DefinitelyTyped) の型に基づいて引用符か中括弧を選択することができます。 デフォルト設定を変更するには、   設定   ダイアログ ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ) を開き、  `エディター｜コードスタイル｜HTML`  に移動して、   JSX 属性を追加する   リストから該当するオプションを選択します。

![JSX 属性を追加する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_add_braces.png)

また、波括弧内の JavaScript 式の補完も可能です。 これは、定義したすべてのメソッドと関数に適用されます。

![波括弧内の JavaScript 式の完成](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_javascript_expression.png)

### 完全な HTML タグとコンポーネント名

CLion は、JavaScript のメソッド内や他のコンポーネント内で定義した HTML タグやコンポーネント名に対してコード補完を提供します。

![HTML タグとコンポーネント名の補完](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_component_completion.png)

補完は、ES6 スタイルの構文でインポートされたコンポーネントにも対応しています。

![ES6 構文でインポートされたコンポーネントの補完](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_imported_component_completion.png)

### 完全なコンポーネントプロパティ

CLion は、  `propTypes`  を使用して定義されたコンポーネントプロパティに対してコード補完を提供し、それらの定義へのジャンプやプレビューをすばやく行えます。

![Completion for component properties](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_component_properties.animated.gif)

コンポーネント名を自動補完すると、CLion は必要なすべてのプロパティを自動的に追加します。 必要なプロパティが一部コンポーネントで不足している場合、CLion が警告します。

## 機能コンポーネントに状態を追加する

CLion は、特定の場所で未解決の参照を定義することで、関数型 React コンポーネントに  `[useState](https://react.dev/reference/react/useState)`  フックを追加するクイックフィックスを提案します。 CLion は  `useState`  フック用の  `import`  ステートメントを自動で挿入します。 状態タイプは、参照が定義されている場所から推測されます。

> **Note:**
> * この機能は、 `.tsx` ファイル内の機能的な React コンポーネント本体内でのみ使用できます。
>
> * この機能はクラスベースのコンポーネントでは使用できません。

Procedure:

* 未解決の参照にキャレットを置き、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押して、リストから   <未解決の reference> 状態を < 機能コンポーネント名> コンポーネントに作成する   を選択します。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_state.mp4)

## props を追加

CLion は、特定の場所に未解決の参照を定義することで、React コンポーネントへ新しいプロパティを追加するクイックフィックスを提案します。

CLion は、追加されたプロパティを持つコンポーネントのコードを生成します。 プロパティの型は、対応する参照が定義されている場所から推論されます。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_props.mp4)

クイックフィックスはクラスベースのコンポーネントにも適用できます。 この場合、新しいプロパティが挿入された後、未解決の参照は  `this.props.${reference_name}`  に置き換えられます。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_props_class.mp4)

> **Note:**
> この機能は  `.tsx`  ファイルでのみ使用できます。

Procedure:

* 未解決の参照にキャレットを置き、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) を押して、リストから   <コンポーネント名> コンポーネントに <未解決の reference> プロパティを作成する   を選択します。

![props を追加](https://resources.jetbrains.com/help/img/idea/2026.3/react_add_props_steps.png)

## HTML 属性を JSX に転送する

クラス属性または on 系のイベントハンドラを含む HTML コードをコピーして JSX に貼り付けると、CLion はこれらの属性を React 固有のものに自動的に置き換えます（  `className` 、  `onClick` 、  `onChange` など）。

![Transfer HTML to JSX](https://resources.jetbrains.com/help/img/idea/2026.3/ws_paste_from_html_to_jsx.animated.gif)

これは TSX でも機能します：

![Transfer HTML to TSX](https://resources.jetbrains.com/help/img/idea/2026.3/ws_paste_from_html_to_tsx.animated.gif)

単一タグを含む HTML コードをコピーして JSX に貼り付けると、CLion がそれぞれの単一タグの末尾にスラッシュ  `/`  を自動で追加します。

![Transfer HTML to JSX: close single tags](https://resources.jetbrains.com/help/img/idea/2026.3/ws_paste_from_html_to_jsx_close_tags.animated.gif)

HTML コードをそのまま JSX または TSX にコピーするには、  そのまま貼り付け  `Ctrl+Alt+Shift+V` (Windows), `⌘ ⌥ ⇧ V` (macOS), `⌘ ⌥ ⇧ V` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ V` (macOS System Shortcuts), `Ctrl+Alt+Shift+V` (XWin), `Ctrl+Alt+Shift+V` (GNOME), `Ctrl+Alt+Shift+V` (KDE), `Ctrl+Alt+Shift+V` (Emacs), `Ctrl+V` (Sublime Text), `⌘ V` (Sublime Text (macOS)), `⌘ ⌥ ⇧ V` (Xcode), `Ctrl+Alt+Shift+V` (Visual Studio), `⌘ ⌥ ⇧ V` (Visual Studio (macOS)), `Ctrl+Alt+Shift+V` (ReSharper), `⌘ ⌥ ⇧ V` (ReSharper (macOS)), `Ctrl+Alt+Shift+V` (QtCreator), `⌘ ⌥ ⇧ V` (QtCreator (macOS)), `Ctrl+Alt+Shift+V` (NetBeans), `Ctrl+Alt+Shift+V` (Eclipse), `⌘ ⌥ ⇧ V` (Eclipse (macOS)) を使用するか、   設定   ダイアログ ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ) を開いて  `エディター | 一般 | スマートキー | JavaScript`  の設定ページに移動し、   JSX ファイルにコードを貼り付ける際に HTML の単一タグを閉じる   と   JSX ファイルに貼り付けるときに HTML 属性名を変換する   のチェックボックスをオフにします。

## React コードスニペット

CLion には、 [React フック](https://react.dev/reference/react) など、React アプリでよく使われるさまざまなステートメントやコードブロックに展開される 50 個以上のコードスニペット集が付属しています。 以下の例は、  rcjc  省略形を使用して、新しい React コンポーネントを定義するクラスを作成する方法を示しています。

![Live template for a React component](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_live_template.animated.gif)

### スニペットから React コード構成を作成する

Procedure:

* 必要な省略形をエディターに入力し、 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `⇥` (Xcode), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (ReSharper), `⇥` (ReSharper (macOS)), `Tab` (QtCreator), `⇥` (QtCreator (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS)) を押します。

* `Ctrl+J` (Windows), `⌘ J` (macOS), `⌘ J` (IntelliJ IDEA Classic (macOS)), `⌘ J` (macOS System Shortcuts), `Ctrl+J` (XWin), `Ctrl+J` (GNOME), `Ctrl+J` (KDE), `Ctrl+J` (Emacs), `Ctrl+J` (Sublime Text), `Ctrl+J` (Sublime Text (macOS)), `⌘ J` (Xcode), `Ctrl+K, X` (Visual Studio), `⌘ E, L` (Visual Studio (macOS)), `Ctrl+J` (ReSharper), `⌘ J` (ReSharper (macOS)), `Ctrl+J` (QtCreator), `Ctrl+J` (QtCreator (macOS)), `Ctrl+J` (NetBeans), `Ctrl+Alt+Shift+J` (Eclipse), `Ctrl+J` (Eclipse (macOS)) を押して、関連するスニペットを選択します。 検索を絞り込むには、略語の入力を開始してから、 [補完リスト](auto-completing-code.html)から選択します。

詳細は [ライブテンプレート](using-live-templates.html)を参照してください。

### 使用可能なすべての React スニペットのリストを表示する

Procedure:

* 設定   ダイアログ ( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ) で、   エディター   の   ライブテンプレート   をクリックし、   React   ノードまたは   React フック   ノードを展開します。

![ライブテンプレート: React および React hooks](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_code_snippets.png)

## React ディレクティブ

CLion は、ファイルの先頭および関数内で次の [React ディレクティブ](https://react.dev/reference/react-compiler/directives)を認識し、ハイライトします：

* [クライアントを使用する (英語)](https://react.dev/reference/rsc/use-client)

* [サーバーを使用 (英語)](https://react.dev/reference/rsc/use-server)

* [メモを使用する (英語)](https://react.dev/reference/react-compiler/directives/use-memo)

* [メモを使わない (英語)](https://react.dev/reference/react-compiler/directives/use-no-memo)

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/react_directives_highlight.mp4)

## JSX の Emmet

CLion では、HTML だけでなく JSX コードでも特有の React 対応を活かして [Emmet](https://docs.emmet.io/cheat-sheet/) を使えます。 たとえば、略語  div.my-class  は JSX では  `<div className=”my-class"></div>`  に展開されますが、HTML のように  `<div class=”my-class"></div>`  にはなりません。

![Expand Emmet template in React](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_emmet.animated.gif)

## React アプリケーションを移動する

[基本的なナビゲーション](navigating-through-the-source-code.html)に加えて、CLion は React 固有のコード要素間も移動できます。

Procedure:

* 波括弧  `{}`  内のメソッドまたは JavaScript 式の宣言に移動するには、メソッドまたは式を選択して `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) を押します。

コンポーネントの宣言に移動するには、コンポーネント名を選択して `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `⌘ Click` (Xcode), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (ReSharper), `⌘ B` (ReSharper (macOS)), `F2` (QtCreator), `F2` (QtCreator (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS)) を押します。

* コンポーネント定義を表示するには、 `Ctrl+Shift+I` (Windows), `⌥ Space` (macOS), `⌘ ⇧ I` (IntelliJ IDEA Classic (macOS)), `⌘ Y` (macOS System Shortcuts), `Ctrl+Shift+I` (XWin), `Ctrl+Shift+I` (GNOME), `Ctrl+Shift+I` (KDE), `Ctrl+Shift+I` (Emacs), `Ctrl+Shift+I` (Sublime Text), `⌥ Space` (Sublime Text (macOS)), `⌃ F1` (Xcode), `Alt+F12` (Visual Studio), `⌥ Space` (Visual Studio (macOS)), `Ctrl+Shift+I` (ReSharper), `⌥ Space` (ReSharper (macOS)), `Ctrl+Shift+I` (QtCreator), `Ctrl+Shift+I` (QtCreator (macOS)), `Ctrl+Shift+I` (NetBeans), `Ctrl+Shift+I` (Eclipse), `⌥ Space` (Eclipse (macOS)) を押します。 詳細については、 [定義と型定義](viewing-definition.html)を参照してください。

![ポップアップでコンポーネントのクイック定義を表示する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_quick_definition.png)

* コンポーネントの簡単なドキュメントを表示するには、 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS)) を押します。 詳細については、 [JavaScript ドキュメントの検索](viewing-javascript-reference.html)を参照してください。

![React コンポーネントのクイックドキュメントポップアップ](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_quick_doc.png)

* CLion では、 [エディターのパンくずリスト](using-code-editor.html#breadcrumbs)やエディターのガターにあるタグツリーのカラフルなハイライト表示により、JSX タグ間を容易に移動できます。

![React アプリケーションでの JSX タグのハイライトとパンくずリスト](https://resources.jetbrains.com/help/img/idea/2026.3/ws_react_jsx_tree_highlighting.png)

### 構造ビューで移動する

構造   ツールウィンドウと   構造   ポップアップにより、React コード構造をより明確に把握できるようになり、ナビゲーションが容易になり、React コンポーネントと関連要素の理解が深まります。

構造   ツールウィンドウには、次の React 固有のノードが表示されます。

* 名前付きの JSX および TSX タグ。

* React コンポーネント ノードは React コンポーネント宣言を表示します。 [React コンポーネントの定義(英語)](https://react.dev/learn/your-first-component)に一致するクラスまたは関数ごとに個別のノードが作成されます。 ![構造ビュー - コンポーネントノード](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_component.png)

* React フック ノードは React フック宣言を表します。 React コンポーネント内の [フックのルール(英語)](https://react.dev/warnings/invalid-hook-call-warning)に一致する関数呼び出しごとに個別のノードが作成されます。 各ノードにはフックの名前とそのジェネリクス型が表示されます。 フックによって初期化された変数は、そのノードに子として表示されます。 ![構造ビュー - フックノード](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_hooks.png) `[variableName, setVariableName]` 形式で 2 つの変数を返すフックの場合、変数名はフック名の横に灰色で表示されます。 ![構造ビュー - setVariable によるフック](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_hooks_setVariable.png)

* 条件付き ノードは、条件に応じてレンダリングされる JSX タグノードを表します。 JSX を含まない条件は表示されません。 ![構造ビュー - 条件ノード](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_conditional.png)

* 属性 ノードは、他のコンポーネント props 内の JSX を表します。 JSX を含まない属性は表示されません。 ![構造ビュー - 属性ノード](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_attribute.png)

* 配列 ノードは JSX を含む配列を表します。 ![構造ビュー - 配列ノード](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_array.png)

* 変数 ノードは JSX を含む変数を表します。

* マップ ノードは、JSX コンテンツ内の配列マップを表します。 ![構造ビュー - マップノード](https://resources.jetbrains.com/help/img/idea/2026.3/react_navigation_structure_view_map.png)

Procedure:

* 構造   ツールウィンドウを開くには、 `Alt+7` (Windows), `⌘ 7` (macOS), `⌘ 7` (IntelliJ IDEA Classic (macOS)), `⌘ 7` (macOS System Shortcuts), `Alt+7` (XWin), `Alt+7` (GNOME), `Alt+7` (KDE), `Alt+7` (Emacs), `Alt+7` (Sublime Text), `⌘ 7` (Sublime Text (macOS)), `⌘ 3` (Xcode), `Ctrl+Alt+F` (Visual Studio), `⌃ ⌥ F` (Visual Studio (macOS)), `Ctrl+F11` (ReSharper), `⌃ F11` (ReSharper (macOS)), `Alt+7` (QtCreator), `⌘ 7` (QtCreator (macOS)), `Ctrl+7` (NetBeans), `Alt+7` (Eclipse), `⌘ 7` (Eclipse (macOS)) を押すか、メインメニューの  `表示 | ツールウィンドウ | 構造`  に移動します。

* 構造   ポップアップを開くには、 `Ctrl+F12` (Windows), `⌘ F12` (macOS), `⌘ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ 7` (macOS System Shortcuts), `Ctrl+F12` (XWin), `Ctrl+F12` (GNOME), `Ctrl+0` (KDE), `Ctrl+F12` (Emacs), `Ctrl+R` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `⌃ 6` (Xcode), `Alt+\` (Visual Studio), `⌥ \` (Visual Studio (macOS)), `Ctrl+F12` (ReSharper), `⌘ F12` (ReSharper (macOS)), `Ctrl+F12` (QtCreator), `⌘ F12` (QtCreator (macOS)), `Ctrl+F12` (NetBeans), `Ctrl+F3` (Eclipse), `⌘ O` (Eclipse (macOS)) を押すか、メインメニューの  `移動 | ファイル構造`  に移動します。

* 構造   ツールウィンドウと   構造   ポップアップは、アクティブなエディタータブ内のファイルと同期しています。 構造ビュー内を移動すると、ファイル内の対応するコード要素がハイライト表示されます。 また、ソースコード内の項目の名前を変更すると、対応するノードもそれに応じて更新されます。

構造ビュー内の項目からソースコードに移動するには、 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押します。

[ソースコードナビゲーション: ファイル構造](null)の詳細を参照してください。

## React アプリケーションをリントする

JavaScript や HTML 用のすべての CLion 組み込み [コードインスペクション](code-inspection.html)は JSX コードにも対応しています。 CLion は、未使用の変数や関数、終了タグ欠落、ステートメント不足などの際に警告します。

![React アプリケーションの JavaSxript インスペクション](https://resources.jetbrains.com/help/img/idea/2026.3/無効化と抑止](disabling-and-enabling-inspections.html)と [インスペクション重大度](configuring-inspection-severities.html)を参照してください。

### ESLint

組み込みコードインスペクションだけでなく、CLion は JSX コード用の [ESLint](http://eslint.org/) などのリンターとも連携します。 ESLint は、プラグインで拡張できる幅広い lint ルールをもたらします。 CLion は、入力中に ESLint から報告された警告とエラーをエディター内に表示します。 ESLint を使用すると、 [JavaScript 標準スタイル(英語)](https://standardjs.com/)を使用したり、 [TypeScript コードをリント](linting-typescript.html#ws_eslint_linting_typescript_files_with_eslint_intro)したりすることもできます。

詳細については、 [ESLint](eslint.html)を参照してください。

ESLint に React JSX 構文を正しく理解させるには、 [eslint-plugin-react](https://www.npmjs.com/package/eslint-plugin-react) プラグインが必要です。 このプラグインにより、たとえば React コンポーネントの表示名前が設定されていない場合や、危険な JSX プロパティが使用されている場合などに警告が表示されます。

![React を使用した ESLint: エラーと警告がハイライトされ、問題の説明がツールチップに表示されます。](https://resources.jetbrains.com/help/img/idea/2026.3/ws_eslint_react.png)

> **Tip:**
> [create-react-app でアプリケーションを作成している](#creating_react_app_with_generators)場合、開発環境はすでに ESLint を使用するように事前設定されています。

Procedure: React プロジェクトで ESLint をインストールして構成する

1. 組み込み   ターミナルエミュレータ   （  `表示 | ツールウィンドウ | ターミナル`  ）で、次のように入力します。

```
npm install --save-dev eslint
npm install --save-dev eslint-plugin-react

```

2. プロジェクトに [ESLint 構成ファイル](eslint.html#ws_eslint_configuration_file_format)を追加します。

3. 設定   ダイアログ（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）で、   言語 & フレームワーク | JavaScript | コード品質ツール | ESLint   に移動し、   自動 ESLint 構成   を選択します。 CLion はプロジェクトの  `node_modules`  フォルダーで ESLint を自動検出し、  `.eslintrc.*`  ファイルや  `パッケージ.json​​`  の  `eslintConfig`  プロパティからデフォルト構成を利用します。

または、   手動 ESLint 構成   を選択して、カスタム ESLint パッケージと構成を使用します。

詳細は [CLion での ESLint の有効化と構成](eslint.html#ws_js_eslint_activate) を参照してください。

Procedure: .eslintrc 構造体の例 (react プラグイン付き ESLint 1.x)

1. `ecmaFeatures`  オブジェクトに、  `"jsx" = true`  を追加します。 ここでは、ES6 クラスやモジュールなど、使用したい追加の言語機能を指定することもできます。

2. `plugins`  オブジェクトに、  `react`  を追加します。

3. `rules`  オブジェクトでは、有効にする [ESLint ビルトインルール(英語)](http://eslint.org/docs/rules/)と、 [react プラグイン経由で利用できるルール(英語)](https://github.com/yannickcr/eslint-plugin-react#list-of-supported-rules)をリストできます。

```JSON
{
  "parser": "babel-eslint",
  "env": {
    "browser": true,
    "es6": true,
    "jest": true
  },

  "rules": {
    "arrow-parens": ["error", "as-needed", {
      "requireForBlockBody": true
    }],
    "react/jsx-props-no-spreading": "off",
    "react/jsx-sort-props": ["error", {
      "reservedFirst": ["key"]
    }],
    "react/require-default-props": "off",
    "react/sort-prop-types": "error",
    "react/state-in-constructor": ["error", "never"],
    "semi-spacing": "warn"
  },
  "overrides": [
    {
      "files": [
        "sample/**",
        "test/**"
      ],
      "rules": {
        "import/no-unresolved": "off"
      }
    }
  ]
}                
```

[ESLint 公式 Web サイト(英語)](http://eslint.org/docs/2.0.0/user-guide/configuring.html#specifying-parser-options)から ESLint および  `react`  プラグイン構成の詳細を学びましょう。

## React アプリケーションを構築する

[既存の CLion プロジェクトに React をインストールした](#install_react_in_empty_project)場合、ビルドプロセスの設定が必要です。 [React オフィシャル Web サイト(英語)](https://react.dev/)から React アプリケーションのビルドパイプラインを構成するさまざまな方法について説明します。

> **Tip:**
> [create-vite でアプリケーションを作成している](#creating_react_app_with_generators)場合、開発環境はすでに Webpack と Babel を使用するように事前設定されています。

## プロジェクト内で複数のフレームワークを使用する

場合によっては、単一の React プロジェクト内で他のフレームワークを使う必要があることもあります。

各ファイルでコンテキスト認識コーディング支援を受けるには、構成ファイル  `.ws-context`  を作成し、各ファイルまたはフォルダーで使用するフレームワークを指定します。 このファイルの設定は、デフォルトの構成を上書きします。

Procedure:

1. プロジェクトルートで、コンテキストメニューから   新規 | ファイル   を選択し、ファイル名として  `.ws-context`  を指定します。

2. `.ws-context`  では、次の 2 種類のプロパティを使用します。

* コンテキスト値文字列を持つ `<context-name>`

* コンテキスト詳細オブジェクトを持つ GLOB パターン

3. 次のコンテキスト値を使用します：

* `framework` : `vue` 、 `angular` 、 `react` 、 `svelte` 、 `astro`

* `angular-template-syntax` : `V_2` , `V_17`

* `nextjs-project` : `nextjs`

* `astro-project` : `astro`

* `vue-store` : `vuex` , `pinia`

* `vue-class-component-library` : `vue-class-component` 、 `vue -property-decorator` 、 `vue-facing-decorator`

* `jsdoc-dialect` : `jsdoc-typescript` , `jsdoc-closure`

4. 簡単にするためにパスのネストを使用します。

* GLOB パスの最後のセグメントはファイル名パターンであり、 `*` ワイルドカードのみがサポートされます。

* 最後のセグメントが `**` の場合、ネストされたすべてのディレクトリとファイルと一致します。

* 最上位レベルのコンテキストプロパティには `/**` パターンが必要です。

5. 複数のパターンが同じファイル名に一致する場合、曖昧さを解消するために次のルールが使用されます：

* `**` セグメントを除いて、パスセグメント数が最大となるパターンを選択します。

* 純粋なファイル名パターン、つまり `**` または `/` で終わらないものを選択してください。

* 最初に定義されたパターンを選択します。

### サンプル

さまざまなフォルダーで使用されている多数のフレームワークを含むプロジェクトがあるとします。

![異なるフレームワークを持つプロジェクト](https://resources.jetbrains.com/help/img/idea/2026.3/several_frameworks_context_project_structure.png)

プロジェクト内の各ファイルに対してコンテキスト認識型の支援を受けるには、次のコードを  `.ws-context`  に追加します。

```JSON
{
  "framework": "vue",
  "angular-template-syntax": "V_2",
  "src/**/app/**": {
    "framework": null,
    "app.component.html" : {
      "framework": "angular",
      "angular-template-syntax": "V_17"
    }
  },
  "src/**/p*-editor/*.html" : {
    "framework" : "angular"
  }
}
        
```

## See also

### 言語・フレームワーク別ガイドライン

[JavaScript](javascript-specific-guidelines.html) [JavaScript ライブラリを構成する](configuring-javascript-libraries.html) [TypeScript](typescript-support.html)

### リファレンス

[JavaScript](settings-languages-javascript.html)

### 外部リンク

[Working with React in WebStorm: Coding Assistance](http://blog.jetbrains.com/webstorm/2015/10/working-with-reactjs-in-webstorm-coding-assistance/)

