React
React は、カプセル化されたコンポーネントから複雑なインタラクティブユーザーインターフェースを構築するための JavaScript ライブラリです。React オフィシャル Web サイト(英語)からライブラリの詳細を参照してください。
PhpStorm は、React と統合され、lint の設定、編集、実行、デバッグ、アプリケーションの保守を支援します。
始める前に
お使いのコンピューターに Node.js(英語) がインストールされていることを確認してください。
設定 | プラグインページのインストール済みタブで、JavaScript and TypeScript および JavaScript Debugger に必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、React および Vite プラグインを設定 | プラグインページのマーケットプレースタブにインストールします。
新しい React アプリケーションを作成する
React アプリケーションを生成する
ウェルカム画面で新規プロジェクトをクリックするか、メインメニューからを選択します。新規プロジェクトダイアログが開きます。
左側のペインで、React を選択します。
右側のペインで:
プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。
ノードランタイムフィールドで使用する Node.js ランタイムを指定します。リストから設定済みのランタイムを選択するか、追加を選択して新しいランタイムを設定してください。
React CLI リストから、使用するジェネレーターを選択してください。
デフォルトの
npx create-vite(英語)を受け入れると、開発環境が Vite を使用するように事前に構成されます。npx create-react-app(英語)を選択すると、webpack、Babel、ESLint を使用するための開発環境が事前に設定されます。以前にダウンロードしたカスタムジェネレーターを使用するには、選択をクリックし、開いたダイアログでジェネレーターへのパスを指定します。

オプション:
JSX の代わりに TSX を使用するには、TypeScript プロジェクトの作成チェックボックスを選択します。PhpStorm は、アプリケーション用の .tsx ファイルと tsconfig.json 構成ファイルを生成します。
作成をクリックすると、PhpStorm は必要な設定ファイルをすべて含んだ React -specific プロジェクトを生成し、必要な依存関係をダウンロードします。また、PhpStorm は npm start と、アプリケーションの実行またはデバッグ用のデフォルト設定を含む JavaScript デバッグ構成ファイルを作成します。
空の PhpStorm プロジェクトに React をインストールする
この場合、以下の React アプリケーションの構築の説明に従ってビルドパイプラインを自分で設定する必要があります。React オフィシャル Web サイト(英語)からプロジェクトに React を追加する方法の詳細を参照してください。
空の PhpStorm プロジェクトを作成する
ウェルカム画面で新規プロジェクトをクリックするか、メインメニューからを選択します。新規プロジェクトダイアログが開きます。
左側のペインで、PHP 空プロジェクトを選択します。右側のウィンドウで、アプリケーションフォルダーを指定し、作成をクリックします。
空のプロジェクトに React をインストールする
React を使用する空のプロジェクトを開きます。
埋め込まれたターミナル(Alt+F12)で、次のように入力します。
npm install --save react react-dom
既存の React アプリケーションから始める
既存の React アプリケーションの開発を継続するには、PhpStorm で開き、必要な依存関係をダウンロードします。
すでにマシン上にあるアプリケーションソースを開く
ウェルカム画面でオープンをクリックするか、メインメニューからを選択します。開いたダイアログで、ソースが保存されているフォルダーを選択します。
バージョン管理からアプリケーションのソースをチェックアウト
ウェルカム画面でリポジトリのクローンをクリックします。
あるいは、メインメニューから、、を選択します。
メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。例: Mercurial または Perforce。
表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。詳細については、プロジェクトをチェックアウトする (クローン) を参照してください。
依存関係をダウンロードする
ポップアップで 'npm install' の実行または実行 'yarn install' をクリックします。

npm(英語)、Yarn 1(英語)、または Yarn 2(英語) を使用できます。詳細については、npm および Yarn を参照してください。
または、エディターの package.json のコンテキストメニュー、またはプロジェクトツールウィンドウ (Alt+1) で 'npm install' の実行または実行 'yarn install' を選択します。
プロジェクトのセキュリティ
PhpStorm の外部で作成され、そこにインポートされたプロジェクトを開くと、PhpStorm は、未知ソースコードを使用してこのプロジェクトを処理する方法を決定できるダイアログを表示します。
次のいずれかのオプションを選択します。
セーフモードでプレビュー : この場合、PhpStorm はプロジェクトをプレビューモードで開きます。これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。
PhpStorm はエディター領域の上部に通知を表示し、プロジェクトを信頼する…リンクをクリックして、いつでもプロジェクトをロードできます。
プロジェクトを信頼 : この場合、PhpStorm はプロジェクトを開いてロードします。これは、プロジェクトが初期化され、プロジェクトのプラグインが解決され、依存関係が追加され、すべての PhpStorm 機能が使用可能になることを意味します。
開かない : この場合、PhpStorm はプロジェクトを開きません。
プロジェクトのセキュリティの詳細を参照してください。
コード補完
PhpStorm は、React API にコード補完を提供し、JavaScript コードに JSX(英語) を提供します。コード補完は、React メソッド、React 固有の属性、HTML タグとコンポーネント名、React イベント(英語)、コンポーネントプロパティなどに対して機能します。React オフィシャル Web サイト(英語)から詳細を参照してください。
React メソッドのコード補完と React 固有の属性を取得するには、プロジェクトのどこかに react.js ライブラリファイルが必要です。通常、ライブラリはすでに node_modules フォルダーにあります。
完全な React メソッド、属性、イベント
デフォルトでは、入力時にコード補完ポップアップが自動的に表示されます。例:

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

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

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

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

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

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

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

コンポーネントの名前を自動補完すると、PhpStorm は必要なすべてのプロパティを自動的に追加します。必要なプロパティの一部がコンポーネントの使用に欠落している場合、PhpStorm はそのことについて警告します。
機能コンポーネントに状態を追加する
PhpStorm は、特定の場所に未解決の参照を定義することで、機能的な React コンポーネントに useState(英語) フックを追加する簡易的な解決策を提案します。PhpStorm は、useState フック用の import ステートメントを自動的に挿入します。状態タイプは、参照が定義されている場所から推測されます。
未解決の参照にキャレットを置き、Alt+Enter を押して、リストから <機能コンポーネント名> コンポーネントに <未解決の reference> 状態を作成するを選択します。
props を追加
PhpStorm は、特定の場所で未解決の参照を定義することにより、React コンポーネントに新しいプロパティを追加する簡単な修正を提案しています。
PhpStorm は、追加されたプロパティを含むコンポーネントのコードを生成します。プロパティの型は、対応する参照が定義されている場所から推論されます。
クイックフィックスはクラスベースのコンポーネントにも適用できます。この場合、新しいプロパティが挿入された後、未解決の参照は this.props.${reference_name} に置き換えられます。
未解決の参照にキャレットを置き、Alt+Enter を押して、リストから <コンポーネント name> コンポーネントに <未解決の reference> プロパティを作成するを選択します。

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

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

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

HTML コードをそのまま JSX または TSX にコピーするには、そのまま貼り付け Ctrl+Alt+Shift+V を使用するか、設定ダイアログ (Ctrl+Alt+S) を開いて の設定ページに移動し、JSX ファイルに貼り付ける場合に HTML を変換 (属性の変換、単一のタグを閉じる) と JSX ファイルに貼り付けるときに HTML 属性名を変換するのチェックボックスをオフにします。
React コードスニペット
PhpStorm には、React フック(英語)などの React アプリでよく使用されるさまざまなステートメントやコードブロックに展開される 50 を超えるコードスニペットのコレクションが付属しています。以下の例は、rcjc 省略形を使用して、新しい React コンポーネントを定義するクラスを作成する方法を示しています。

スニペットから React コード構成を作成する
必要な省略形をエディターに入力し、Tab を押します。
Ctrl+J を押して、関連するスニペットを選択します。検索を絞り込むには、略語の入力を開始してから、補完リストから選択します。
詳細は、ライブテンプレートを参照してください。
使用可能なすべての React スニペットのリストを表示する
設定ダイアログ (Ctrl+Alt+S) で、エディターのライブテンプレートをクリックし、React ノードまたは React hooks ノードを展開します。

React ディレクティブ
PhpStorm は、ファイルの先頭および関数内の次の React ディレクティブ(英語)を認識してハイライトします。
JSX の Emmet
PhpStorm では、HTML だけでなく、特別な React twists を利用して JSX コードでも Emmet(英語) を使用できます。例: 略語 div.my-class は JSX では <div className=” my-class"></div> に展開されますが、HTML のように <div class=” my-class"></div> には展開されません。

React アプリケーションを移動する
基本的なナビゲーションに加えて、PhpStorm は React 固有のコード要素間を移動できます。
構造ビューで移動する
構造ツールウィンドウと構造ポップアップにより、React コード構造をより明確に把握できるようになり、ナビゲーションが容易になり、React コンポーネントと関連要素の理解が深まります。
構造ツールウィンドウには、次の React 固有のノードが表示されます。
React アプリケーションをリントする
JavaScript および HTML 用のすべての PhpStorm 組み込みコードインスペクションは、JSX コードでも機能します。PhpStorm は、未使用の変数や関数、終了タグの欠落、ステートメントの欠落などの場合に警告を発します。

いくつかのインスペクションのために PhpStorm はクイックフィックスを提供します。たとえば、欠落しているメソッドを追加することを提案します。クイックフィックスポップアップを表示するには、Alt+Enter を押します。
インスペクションのリストをカスタマイズするには、設定ダイアログ (Ctrl+Alt+S) を開き、エディター | メニューに移動します。インスペクションを無効にし、重大度レベルを表示したくない、変更したくないインスペクションを無効にします。詳細については、インスペクションの無効化と有効化およびインスペクションの重大度を変更するを参照してください。
ESLint
組み込みコードインスペクションを提供するだけでなく、PhpStorm は、JSX コード用の ESLint(英語) などのリンターとも統合します。ESLint は、プラグインで拡張できる幅広い lint ルールをもたらします。PhpStorm は、入力時に ESLint によって報告された警告とエラーをエディターに表示します。ESLint を使用すると、JavaScript 標準スタイル(英語)を使用したり、TypeScript コードをリントしたりすることもできます。
詳細は、ESLint を参照してください。
ESLint に React JSX 構文を正しく理解させるには、eslint-plugin-react(英語) が必要です。このプラグインでは、表示名が React コンポーネントに設定されていない場合や、危険な JSX プロパティが使用されている場合など、警告が表示されます。

React プロジェクトに ESLint をインストールして構成する
組み込みターミナル()で、次のように入力します。
npm install --save-dev eslint npm install --save-dev eslint-plugin-reactプロジェクトに ESLint 構成ファイルを追加します。
設定ダイアログ (Ctrl+Alt+S) で、言語 & フレームワーク | JavaScript | コード品質ツール | ESLint に移動し、自動 ESLint 構成を選択します。PhpStorm は、プロジェクト node_modules フォルダー内の ESLint を自動的に見つけて、.eslintrc.* ファイルまたは package.json の
eslintConfigプロパティからのデフォルト構成を使用します。または、手動 ESLint 構成を選択して、カスタム ESLint パッケージと構成を使用します。
詳細は PhpStorm での ESLint のアクティブ化と構成を参照してください。
.eslintrc 構造体の例 (react プラグイン付き ESLint 1.x)
ecmaFeaturesオブジェクトに"jsx" = trueを追加します。ここでは、ES6 クラスやモジュールなど、使用したい追加の言語機能を指定することもできます。pluginsオブジェクトに、reactを追加します。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 アプリケーションを構築する
既存の PhpStorm プロジェクトに React をインストールした場合は、ビルドプロセスを設定する必要があります。React オフィシャル Web サイト(英語)から React アプリケーションのビルドパイプラインを構成するさまざまな方法について説明します。
プロジェクト内で複数のフレームワークを使用する
場合によっては、1 つの React プロジェクト内で他のフレームワークを使用する必要があることがあります。
各ファイルでコンテキスト認識コーディング支援を受けるには、構成ファイル .ws-context を作成し、各ファイルまたはフォルダーで使用するフレームワークを指定します。このファイルの設定は、デフォルトの構成を上書きします。
プロジェクトルートで、コンテキストメニューから新規 | ファイルを選択し、ファイル名として
.ws-contextを指定します。.ws-contextでは、次の 2 種類のプロパティを使用します。コンテキスト値文字列を持つ
<context-name>コンテキスト詳細オブジェクトを持つ GLOB パターン
次のコンテキスト値を使用します。
framework:vue、angular、react、svelte、astroangular-template-syntax:V_2,V_17nextjs-project:nextjsastro-project:astrovue-store:vuex,piniavue-class-component-library:vue-class-component、vue -property-decorator、vue-facing-decoratorjsdoc-dialect:jsdoc-typescript,jsdoc-closure
簡単にするためにパスのネストを使用します。
GLOB パスの最後のセグメントはファイル名パターンであり、
*ワイルドカードのみがサポートされます。最後のセグメントが
**の場合、ネストされたすべてのディレクトリとファイルと一致します。最上位レベルのコンテキストプロパティには
/**パターンが必要です。
複数のパターンが同じファイル名に一致する場合、曖昧さを解消するために次のルールが使用されます。
**セグメントを除いて、パスセグメント数が最大となるパターンを選択します。純粋なファイル名パターンであるパターンを選択します。つまり、
**または/で終わらないパターンを選択します。最初に定義されたパターンを選択します。
サンプル
さまざまなフォルダーで使用されている多数のフレームワークを含むプロジェクトがあるとします。

プロジェクト内の各ファイルに対してコンテキスト認識型の支援を受けるには、次のコードを .ws-context に追加します。
関連ページ:
プラグインのインストール
プラグインは PhpStorm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケッ...
GitHub でホストされているプロジェクトを管理する
プロジェクトをチェックアウトする (クローン):PhpStorm から直接貢献したいリポジトリのクローンを作成し、それに基づいて新しいプロジェクトを作成できます。メインメニューで、に移動します。Git メニューが使用できない場合は、を選択します。バージョン管理から取得ダイアログで、左側の GitHub を選択します。次のいずれかを実行して、GitHub にログインします。トークンがある場合は、トークンを使用するをクリックし、トークンをトークンフィールドに貼り付けて、ログインをクリックします。それ以外の...
npm、pnpm、Yarn
PhpStorm は npm、pnpm、Yarn、Yarn 2、Yarn 3、Bun と統合されているため、組み込みのターミナル内で IDE 内から再利用可能なコードのパッケージをインストール、検索、更新、削除できます。PhpStorm では、npm、Yarn、pnpm スクリプトを実行およびデバッグすることもできます。PhpStorm は、package.json ファイルを解析してスクリプトの定義を認識し、スクリプトをツリービューに表示して、ツリー内のスクリプトと package.json ファイル内...
プロジェクトのセキュリティ
潜在的なセキュリティリスクを防ぐために、PhpStorm では、プロジェクトのソースがわからない場合に、プロジェクトの操作方法を決定できます。PhpStorm は、実行されるタスクまたは構成について警告し、信頼できるソースを構成できるようにします。不明なソースからプロジェクトを開く:プロジェクトを開くと、PhpStorm を使用すると、未知ソースコードを含むプロジェクトの処理方法をすぐに決定できます。プロジェクトを初めて開くたびに、IDE にプロジェクトを信頼ダイアログが表示されます。これは、...
コード補完
基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を補完するのに役立ちます。PhpStorm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します。候補にはライブテンプレートも含まれます。補完機能は英語以外のキーボードレイアウトでも利用できます。基本補完を呼び出すデフォルトでは、PhpStorm は入力時に自動的にコード補完ポップアップを表示します。あるいは、を押すか、メインメニューからを選択することもできます。2 回目にコード補完を呼び出すと、アク...
ライブテンプレート
ライブテンプレートを使用して、ループ、条件、宣言、print ステートメントなどの一般的な構造をコードに挿入します。コードスニペットを展開するには、対応するテンプレートの省略形を入力してを押します。を押し続けると、テンプレート内の 1 つの変数から次の変数に移動します。を押して、前の変数に移動します。ライブテンプレートの種類:次のタイプのライブテンプレートが区別されます。シンプルなテンプレートには固定プレーンテキストのみが含まれています。シンプルなテンプレートを展開すると、テキストが自動









