RubyMine 2026.1 Help

React(リアクト)​

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

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

始める前に

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

  2. 設定 | プラグイン ページ、タブ インストール済み で、 JavaScript および TypeScriptJavaScript デバッガー の必要なプラグインが有効化されていることを確認してください。 詳細は、 プラグインの管理を参照してください。

  3. React および Vite プラグインを 設定 | プラグイン ページの Marketplace タブで、 JetBrains Marketplace からプラグインをインストールする の説明に従ってインストールします。

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

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

  1. ウェルカム 画面で 新規プロジェクト をクリックするか、メインメニューから ファイル | 新規 | プロジェクト を選択します。 新規 プロジェクト ダイアログが開きます。

  2. 左側のペインで、 React(リアクト)​ を選択します。

  3. 右側のペインで:

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

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

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

      • デフォルトの npx create-vite を受け入れると、開発環境が Vite を使用するように事前に構成されます。

      • npx create-react-アプリ を選択すると、webpack、Babel、ESLint を使用するための開発環境が事前に設定されます。

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

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

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

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

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

空の RubyMine プロジェクトを作成する

  1. ウェルカム 画面で 新規プロジェクト をクリックするか、メインメニューから ファイル | 新規 | プロジェクト を選択します。 新規 プロジェクト ダイアログが開きます。

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

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

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

  2. 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install --save react react-dom

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

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

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

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

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

  1. ウェルカム 画面で リポジトリのクローン をクリックします。

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

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

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

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

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

    アプリケーションを開いて依存関係をダウンロードする

    npmYarn 1 、または Yarn 2 を使用できます。詳細は npm と Yarn を参照してください。

  • または、エディターの package.json のコンテキストメニュー、または プロジェクト ツールウィンドウ (Alt+1) で 'npm install' の実行 または 実行 'yarn install' を選択します。

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

RubyMine の外部で作成され、インポートされたプロジェクトを開くと、RubyMine はこのプロジェクトの馴染みのないソースコードの処理方法を決定できるダイアログを表示します。

次のいずれかのオプションを選択してください:

  • セーフモードでプレビュー :この場合、RubyMine はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。

    RubyMine はエディター領域上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックするといつでもプロジェクトをロードできます。

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

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

詳細は プロジェクトのセキュリティ をご覧ください。

コード補完

RubyMine は、JavaScript コード内の React API および JSX にコード補完を提供します。 コード補完は、React メソッド、React 固有の属性、HTML タグとコンポーネント名、 React イベント(英語) 、コンポーネントプロパティなどに対して機能します。 React オフィシャル Web サイト(英語)から詳細を参照してください。

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

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

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

補完ポップアップ

JSX タグでは、RubyMine は React 固有の属性 (例: className または classID )、および 非 DOM 属性 (例: キー または ref )に対してコーディング支援を行います。 さらに、自動補完は、プロジェクトの CSS ファイルで定義されているクラスの名前に対しても機能します。

CSS クラス名の完成

onClickonChange などのすべての React イベント(英語)は、中括弧   ={} または引用符 "" とともに自動的に補完することもできます。

Complete React events

デフォルトでは、波括弧が挿入されます。 RubyMine で常に引用符を追加するか、 TypeScript 定義ファイル (d.ts) の型に基づいて引用符と中かっこのどちらを使用するか選択できます。 デフォルト設定を変更するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 エディター | コードスタイル | HTML に移動して、 JSX 属性の追加 リストから該当するオプションを選択します。

JSX 属性の追加

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

波括弧内の JavaScript 式の完成

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

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

HTML タグとコンポーネント名の補完

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

ES6 構文でインポートされたコンポーネントの補完

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

RubyMine は、 propTypes で定義されたコンポーネントプロパティに対してコード補完を行い、素早く定義へジャンプまたはプレビューできるようにします:

Completion for component properties

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

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

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

  • 未解決の参照にキャレットを置き、 Alt+Enter を押して、リストから <unresolved reference> 状態を < functional component name> コンポーネントで作成する を選択します。

props を追加

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

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

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

  • 未解決の参照にキャレットを置き、 Alt+Enter を押して、リストから <未解決の reference> プロパティを <コンポーネント名> コンポーネントで作成する を選択します。

    props を追加

HTML 属性を JSX に転送する

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

Transfer HTML to JSX

これは TSX にも対応しています:

Transfer HTML to TSX

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

Transfer HTML to JSX: close single tags

HTML コードをそのまま JSX または TSX にコピーするには、 そのまま貼り付け Ctrl+Alt+Shift+V を使用するか、 設定 ダイアログ (Ctrl+Alt+S) を開いて エディター | 一般 | スマートキー | JavaScript の設定ページに移動し、 JSX ファイルにコードを貼り付けた際に HTML 単一タグを閉じるJSX ファイルに貼り付けるときに HTML 属性名を変換する のチェックボックスをオフにします。

React コードスニペット

RubyMine には、 React Hooks など React アプリケーションでよく使用されるさまざまなステートメントやコードブロックに展開する 50 を超えるコードスニペットが用意されています。 以下の例は、 rcjc 省略形を使用して、新しい React コンポーネントを定義するクラスを作成する方法を示しています。

Live template for a React component

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

  • 必要な省略形をエディターに入力し、 Tab を押します。

  • Ctrl+J を押して、関連するスニペットを選択します。 検索を絞り込むには、略語の入力を開始してから、 補完リストから選択します。

詳細は ライブテンプレートを参照してください。

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

  • 設定 ダイアログ (Ctrl+Alt+S) で、 エディターライブテンプレート をクリックし、 React(リアクト)​ ノードまたは React フック ノードを展開します。

    ライブテンプレート: React および React hooks

React ディレクティブ

RubyMine は、ファイルの先頭および関数内で次の React ディレクティブを認識し、ハイライトする:

JSX の Emmet

RubyMine では、HTML だけでなく JSX コードでも特有の React 向け拡張を活かして Emmet を利用できます。 例: 略語 div.my-class は JSX では <div className=”my-class"></div> に展開されますが、HTML のように <div class=”my-class"></div> には展開されません。

Expand Emmet template in React

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

基本ナビゲーション以外にも、RubyMine では React 固有のコード要素間も移動できます。

  • 波括弧 {} 内のメソッドまたは JavaScript 式の宣言に移動するには、メソッドまたは式を選択して Ctrl+B を押します。

    コンポーネントの宣言に移動するには、コンポーネント名を選択して Ctrl+B を押します。

  • コンポーネント定義を表示するには、 Ctrl+Shift+I を押します。

    ポップアップでコンポーネントのクイック定義を表示する
  • コンポーネントの簡単なドキュメントを表示するには、 Ctrl+Q を押します。 詳細は JavaScript ドキュメントの検索 をご覧ください。

    React コンポーネントのクイックドキュメントポップアップ
  • RubyMine では エディターパンくずリストや、ガターでのタグツリーの色分けハイライト表示により、JSX タグ間を容易にナビゲートできます。

    React アプリケーションでの JSX タグのハイライトとパンくずリスト

構造ビューで移動する

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

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

  • 名前付き JSX および TSX タグ

  • React コンポーネント ノードは React コンポーネント宣言を表示します。 React コンポーネントの定義(英語)に一致するクラスまたは関数ごとに個別のノードが作成されます。

    構造ビュー - コンポーネントノード
  • React フック ノードは React フック宣言を表します。 React コンポーネント内の フックのルール(英語)に一致する関数呼び出しごとに個別のノードが作成されます。 各ノードにはフックの名前とそのジェネリクス型が表示されます

    フックによって初期化された変数は、そのノードに子として表示されます。

    構造ビュー - フックノード

    [variableName, setVariableName] 形式で 2 つの変数を返すフックの場合、変数名はフック名の横に灰色で表示されます。

    構造ビュー - setVariable によるフック
  • 条件付き ノードは、条件に応じてレンダリングされる JSX タグノードを表します。 JSX を含まない条件は表示されません。

    構造ビュー - 条件付きノード
  • 属性 ノードは、他のコンポーネント props 内の JSX を表します。 JSX を含まない属性は表示されません。

    構造ビュー - 属性ノード
  • 配列 ノードは JSX を含む配列を表します。

    構造ビュー - 配列ノード
  • 変数 ノードは JSX を含む変数を表します。

  • マップ ノードは、JSX コンテンツ内の配列マップを表します。

    構造ビュー - マップノード
  • 構造 ツールウィンドウを開くには、 Alt+7 を押すか、メインメニューの 表示 | ツールウィンドウ | 構造 に移動します。

  • 構造 ポップアップを開くには、 Ctrl+F12 を押すか、メインメニューの 移動 | ファイル構造 に移動します。

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

    構造ビュー内の項目からソースコードに移動するには、 F4 を押します。

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

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

RubyMine の JavaScript・HTML 用のすべての組み込み コードインスペクションは JSX コードでも動作します。 RubyMine は、未使用の変数や関数、終了タグの漏れ、ステートメント抜けなども警告します。

React アプリケーションの JavaSxript インスペクション

一部のインスペクションでは RubyMine がクイックフィックスも提供し、たとえば不足しているメソッドの追加を提案します。 クイックフィックスのポップアップを表示するには Alt+Enter を押してください。

インスペクションの一覧をカスタマイズするには、 設定 ダイアログ(Ctrl+Alt+S )を開き、Editor|Inspections へ進み、不要なインスペクションを無効化するか、重要度レベルを変更してください。 詳しくは、 インスペクションの無効化と有効化インスペクションの重大度を変更する を参照してください。

ESLint

組み込みインスペクションの他に、RubyMine は ESLint などの JSX コード用リンターとも統合します。 ESLint は、プラグインで拡張できる幅広い lint ルールをもたらします。 RubyMine は、入力中に ESLint から報告された警告やエラーをエディターに表示します。 ESLint を使用すると、 JavaScript 標準スタイル(英語)を使用したり、 TypeScript コードをリントしたりすることもできます。

詳細については、 ESLint を参照してください。

ESLint で React JSX 構文を正しく扱うには、 eslint-plugin-react プラグインが必要です。 このプラグインにより、たとえば React コンポーネントの表示名前が設定されていない場合や、危険な JSX プロパティが使用されている場合などに警告が表示されます。

React を使用した ESLint: エラーと警告がハイライトされ、問題の説明がツールチップに表示されます。

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

  1. 組み込み ターミナル表示 | ツール Windows | ターミナル )で、次のように入力します。

    npm install --save-dev eslint npm install --save-dev eslint-plugin-react
  2. プロジェクトに ESLint 構成ファイルを追加します。

  3. 設定 ダイアログ(Ctrl+Alt+S )で、 言語 & フレームワーク | JavaScript | コード品質ツール | ESLint に移動し、 自動 ESLint 構成 を選択します。 RubyMine はプロジェクトの node_modules フォルダー内の ESLint を自動で検出し、 .eslintrc.* ファイルや package.json eslintConfig プロパティからデフォルト構成を利用します。

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

    詳細は RubyMine での ESLint 有効化と構成を参照してください。

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

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

  2. プラグイン オブジェクトに、 react を追加します。

  3. rules オブジェクトでは、有効にする ESLint ビルトインルール(英語)と、 react プラグイン経由で利用できるルール(英語)をリストできます。

    { "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 サイト(英語)から ESLint および react プラグイン構成の詳細を学びましょう。

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

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

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

場合によっては、1 つの React プロジェクト内で他のフレームワークを使用する必要がある場合があります。

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

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

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

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

    • コンテキスト詳細オブジェクト付きの GLOB パターン

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

    • フレームワーク: vueangularreactsvelteastro

    • angular-template-syntax: V_2V_17

    • nextjs-project: nextjs

    • astro-project: astro

    • vue-store: vuexpinia

    • vue-class-component-library: vue-class-componentvue -property-decoratorvue-facing-decorator

    • jsdoc-dialect: jsdoc-typescriptjsdoc-closure

  4. 単純化のためにパスのネストを利用します。

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

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

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

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

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

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

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

サンプル

複数のフォルダーで多くのフレームワークを利用しているプロジェクトを想定します。

異なるフレームワークを持つプロジェクト

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

{ "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" } }
2026 年 6 月 2 日