WebStorm 2026.1 ヘルプ

React

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

WebStorm は、React と統合され、lint の設定、編集、実行、デバッグ、アプリケーションの保守を支援します。

始める前に

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

  2. ReactJavaScript DebuggerVite に必要なプラグインが設定 | プラグインページのインストール済みタブで有効になっていることを確認します。詳細については、プラグインのマッピングを参照してください。

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

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

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

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

  3. 右側のペインで:

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

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

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

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

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

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

      Create React pp - select a generator
    4. オプション:

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

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

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

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

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

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

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

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

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

  2. 埋め込まれたターミナルAlt+F12)で、次のように入力します。

    npm install --save react react-dom

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

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

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

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

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

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

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

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

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

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

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

    Open an application and download the dependencies

    npm(英語)Yarn 1(英語)、または Yarn 2(英語) を使用できます。詳細については、npm および Yarn を参照してください。

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

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

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

Untrusted project warning

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

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

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

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

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

プロジェクトのセキュリティの詳細を参照してください。

コード補完

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

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

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

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

Completion popup

JSX タグでは、WebStorm は classNameclassID などの React 固有の属性(英語)、および keyref などの非 DOM 属性(英語)のコーディング支援を提供します。さらに、自動補完は、プロジェクトの CSS ファイルで定義されているクラスの名前に対しても機能します。

Completion for CSS class names

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

Complete React events

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

Add for JSX attributes

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

Completing JavaScript expressions inside curly braces

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

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

Completion for HTML tags and component names

補完は、ES6 形式の構文を持つインポートされたコンポーネントに対しても機能します。

Completion for imported components with ES6 syntax

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

WebStorm は、propTypes を使用して定義されたコンポーネントプロパティに対してコード補完を提供し、それらの定義を迅速に移動またはプレビューできるように解決します。

Completion for component properties

コンポーネントの名前を自動補完すると、WebStorm は必要なすべてのプロパティを自動的に追加します。必要なプロパティの一部がコンポーネントの使用に欠落している場合、WebStorm はそのことについて警告します。

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

WebStorm は、特定の場所に未解決の参照を定義することで、機能的な React コンポーネントに useState(英語) フックを追加する簡易的な解決策を提案します。WebStorm は、useState フック用の import ステートメントを自動的に挿入します。状態タイプは、参照が定義されている場所から推測されます。

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

props を追加

WebStorm は、特定の場所で未解決の参照を定義することにより、React コンポーネントに新しいプロパティを追加する簡単な修正を提案しています。

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

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

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

    Add props

HTML 属性を JSX に転送する

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

Transfer HTML to JSX

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

Transfer HTML to TSX

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

Transfer HTML to JSX: close single tags

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

React コードスニペット

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

Live template for a React component

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

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

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

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

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

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

    Live templates: React and React hooks

React ディレクティブ

WebStorm は、ファイルの先頭および関数内の次の React ディレクティブ(英語)を認識してハイライトします。

JSX の Emmet

WebStorm では、HTML だけでなく、特別な React twists を利用して JSX コードでも Emmet(英語) を使用できます。例: 略語 div.my-class は JSX では <div className=” my-class"></div> に展開されますが、HTML のように <div class=” my-class"></div> には展開されません。

Expand Emmet template in React

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

基本的なナビゲーションに加えて、WebStorm は React 固有のコード要素間を移動できます。

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

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

  • コンポーネント定義を表示するには、Ctrl+Shift+I を押します。定義と型定義の詳細を参照してください。

    View quick definition of a component in a popup
  • コンポーネントの簡単なドキュメントを表示するには、Ctrl+Q を押します。JavaScript ドキュメントの検索の詳細を参照してください。

    Quick documentation popup for React component
  • WebStorm を使用すると、エディターのパンくずリストと、エディターのガターにあるタグツリーのカラフルなハイライト表示を使用して、JSX タグ間を簡単に移動できます。

    Highlighting and breadcrumbs for JSX tags in a React application

構造ビューで移動する

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

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

  • 名前が付いた JSX および TSX タグ。

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

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

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

    Structure view - hook nodes

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

    Structure view - hooks with setVariable
  • 条件付きノードは、条件に応じてレンダリングされる JSX タグノードを表します。JSX を含まない条件は表示されません。

    Structure view - conditional nodes
  • 属性ノードは、他のコンポーネント props 内の JSX を表します。JSX を含まない属性は表示されません。

    Structure view - attribute nodes
  • 配列ノードは JSX を含む配列を表します。

    Structure view - array nodes
  • 変数ノードは JSX を含む変数を表します。

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

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

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

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

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

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

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

JavaScript および HTML 用のすべての WebStorm 組み込みコードインスペクションは、JSX コードでも機能します。WebStorm は、未使用の変数や関数、終了タグの欠落、ステートメントの欠落などの場合に警告を発します。

JavaSxript inspections in React application

いくつかのインスペクションのために WebStorm はクイックフィックスを提供します。たとえば、欠落しているメソッドを追加することを提案します。クイックフィックスポップアップを表示するには、Alt+Enter を押します。

インスペクションのリストをカスタマイズするには、設定ダイアログ (Ctrl+Alt+S) を開き、エディター | メニューに移動します。インスペクションを無効にし、重大度レベルを表示したくない、変更したくないインスペクションを無効にします。詳細については、インスペクションの無効化と有効化およびインスペクションの重大度を変更するを参照してください。

ESLint

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

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

ESLint に React JSX 構文を正しく理解させるには、eslint-plugin-react(英語) が必要です。このプラグインでは、表示名が React コンポーネントに設定されていない場合や、危険な JSX プロパティが使用されている場合など、警告が表示されます。

ESLint with React: errors and warnings are highlighted, the description of a problem is shown in a tooltip.

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

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

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

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

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

    詳細は WebStorm での ESLint のアクティブ化と構成を参照してください。

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

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

  2. plugins オブジェクトに、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 アプリケーションを構築する

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

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

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

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

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

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

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

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

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

    • framework : vueangularreactsvelteastro

    • angular-template-syntax : V_2 , V_17

    • nextjs-project : nextjs

    • astro-project : astro

    • vue-store : vuex , pinia

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

    • jsdoc-dialect : jsdoc-typescript , jsdoc-closure

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

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

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

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

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

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

    • 純粋なファイル名パターンであるパターンを選択します。つまり、** または / で終わらないパターンを選択します。

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

サンプル

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

A project with different frameworks

プロジェクト内の各ファイルに対してコンテキスト認識型の支援を受けるには、次のコードを .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 年 3 月 12 日

関連ページ:

プラグインのインストール

プラグインは WebStorm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。デフォルトでは、WebStorm には多数のプラグインがバンドルされています。バンドルされたプラグインを無効にするこ...

新規プロジェクトの作成ダイアログ

このダイアログを使用して、空のプロジェクトを作成したり、アプリケーション開発用のフレームワーク固有のプロジェクトスタブを生成したりします。ダイアログの左側のペインには、スタブを生成できるプロジェクトタイプのリストが表示されます。利用可能なプロジェクトタイプのセットは、インストールされてアクティブ化されているプラグインによって異なります。右側のペインの内容は、選択したプロジェクトの種類によって異なります。ロケーションフィールドはすべてのプロジェクトタイプに共通です。空のプロジェクト内容のないプロジ...

GitHub でホストされているプロジェクトを管理する

プロジェクトをチェックアウトする (クローン):WebStorm から直接貢献したいリポジトリのクローンを作成し、それに基づいて新しいプロジェクトを作成できます。メインメニューで、に移動します。Git メニューが使用できない場合は、を選択します。バージョン管理から取得ダイアログで、左側の GitHub を選択します。次のいずれかを実行して、GitHub にログインします。トークンがある場合は、トークンを使用するをクリックし、トークンをトークンフィールドに貼り付けて、ログインをクリックします。それ以外の...

npm、pnpm、Yarn

WebStorm は npm、pnpm、Yarn、Yarn 2、Yarn 3、Bun と統合されているため、組み込みのターミナル内で IDE 内から再利用可能なコードのパッケージをインストール、検索、更新、削除できます。WebStorm では、npm、Yarn、pnpm スクリプトを実行およびデバッグすることもできます。WebStorm は、package.json ファイルを解析してスクリプトの定義を認識し、スクリプトをツリービューに表示して、ツリー内のスクリプトと package.json ファイル内...

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

潜在的なセキュリティリスクを防ぐために、WebStorm では、プロジェクトのソースが不明な場合にプロジェクトをどのように操作するかを決定できます。WebStorm では、実行されるタスク、File Watchers、または webpack 構成について警告し、信頼できるソースを構成できます。不明なソースからプロジェクトを開く:WebStorm の外部で作成され、そこにインポートされたプロジェクトを開くと、WebStorm は、未知ソースコードを使用してこのプロジェクトを処理する方法を決定でき...

プロジェクトを作成

WebStorm では、空のプロジェクトを作成したり、プロジェクトとしてフォルダーを開いたり、VCS からソースをチェックアウトしたり、プロジェクトを作成することができます。また、フレームワークテンプレートを使用してプロジェクトを生成することもできます。そのため、新しいアプリケーションは、必要なすべてのパッケージと構成ですでにブートストラップされています。WebStorm はまたあらゆるプロジェクトの設定、ファイルおよびホールダーを保存し、新しいプロジェクトを作成するときテンプレートとして使用す...