WebStorm 2025.3 ヘルプ

言語と参照のインジェクション

言語インジェクションを使用すると、ファイルのメイン言語とは異なるプログラミング言語のコードを操作できます。

WebStorm は、HTML、CSS、XML、JSON、RegExp、文字列とテンプレートリテラル内、XML に似た言語のタグと属性内の他のコードフラグメントを編集するための包括的な言語支援を提供します。

IDE は、言語インジェクションに加えて、文字列リテラルをクラスやファイルなどの他のエンティティへの参照として扱う参照インジェクションもサポートしています。

言語インジェクションを追加する

一時的な言語インジェクションを追加する

  1. 言語を挿入する文字列またはテンプレートのリテラル、タグ、属性内にキャレットを配置し、Alt+Enter を押します(またはインテンションアクションアイコン intention action icon を使用します)。

  2. 言語または参照の挿入を選択し、インジェクションする言語を選択します。

    Inject HTML temporarily

永続的な言語インジェクションを追加する

言語インジェクションコメント (アノテーション) を使用して、インジェクションされた言語の永続的なフラグメントを追加します。

  • 言語をインジェクションするとき、WebStorm はアノテーションを加えることを提案します。提案を受け入れるには Alt+Enter を押します。

  • ターゲット文字列リテラルの前に空白行を追加し、次のコメントを入力します。

    language=<language_ID>

    コメントについては、インジェクションしたい言語の構文を使用してください。言語 ID は一般的に直感的です。たとえば、SQL、RegExp、XML、HTML などです。

    設定で言語 ID を確認することもできます。Ctrl+Alt+S を押して設定を開き、エディター | 言語インジェクションを選択します。言語のインジェクションルールをダブルクリックすると、言語 ID が ID フィールドに指定されます。

  • (オプション) コメントに接頭辞または接尾辞を含めます。

    // language=<language_ID> prefix=<prefix> suffix=<suffix>

    これは次の場合に必要です:

    • 文字列は不完全 / 部分的な SQL 文です

    • 文字列は、サポートされている呼び出し(select /where) など)で直接使用されていません。

挿入された言語フラグメントを編集する

WebStorm を使用すると、挿入された言語フラグメントを専用のエディターで編集できます。

フラグメントエディターを開く

  1. 挿入されたコード部分内にキャレットを置き、Alt+Enter を押します (またはインテンションアクションアイコン intention action icon を使用します)。

  2. <言語 ID> フラグメントの編集を選択します。

    WebStorm は、インジェクションされた言語でコードを編集するための専用エディターセクションを開きます。このエディターは、コード補完、インスペクション、インテンションアクション、コードスタイルアクションを含む完全なコーディング支援機能を提供します。

参照を挿入する

参照インジェクションは、文字列リテラルをファイルなどの他のエンティティへのリンクとして解釈します。

例: resources/config.json はファイルへの参照として扱うことができます。

一時的な参照インジェクションを追加する

  1. Place the caret inside the string or template literal in which you want to inject a reference and press Alt+Enter (or use the intention action icon intention action icon).

  2. 言語または参照の挿入を選択し、オプションを選択します。例:

    • ファイル参照 : 指定されたファイルへの参照を追加します。

    インストールしたプラグインによっては、他の参照オプションが利用できる場合があります。

永続的な参照インジェクションを追加する

コメントを使用して永続的な参照インジェクションを追加します。

  • ターゲット文字列リテラルの前に空白行を追加し、必要な値を含む // language= コメントを入力します。

    • // language=file-reference はファイルへの参照を追加します。

インジェクションをキャンセルする

  • コードフラグメントにキャレットを置き、Alt+Enter を押して、リストから言語または参照の挿入解除を選択します。

    Cancel language injection
  • あるいは、インジェクションコメントを削除するだけです。

インテンションアクションバルブアイコンを無効にする

エディターでインテンションアクションアイコン Intention action icon を非表示にするには、次の手順を実行します。

  1. Ctrl+Alt+S を押して設定を開き、エディター | 一般 | 外観を選択します。

  2. インテンションバルブを表示するチェックボックスをクリアします。

  3. 変更を適用し、ダイアログを閉じます。

自動インジェクションのルールを構成する

WebStorm には、IDE がコード内の特定の場所に言語を自動的に挿入するための事前定義されたルールのセットがあります。

エディター | 言語インジェクション設定ページ Ctrl+Alt+S で言語インジェクションルールを設定できます。

Language injection settings

定義済みのすべてのインジェクションルールはビルトインスコープ用に設定されています。言い換えれば、それらはグローバルです(したがってすべての WebStorm プロジェクトで利用可能です)。カスタムルールは IDE または 1 つのプロジェクトに対してのみ設定できます。カスタムインジェクションの範囲を変更するには、the Move to Project/IDE scope button を使用してください。

VCS を介してカスタムルールを共有するには、ツールバーの対応するオプションを使用して、カスタムルールをプロジェクトスコープに移動します。そうすることで、バージョン管理下に置くことができるカスタムルールを使用して IntelliLang.xml という名前の新しいファイルを .idea ディレクトリに作成します。

VCS を使用しない場合は、ルールを XML ファイルにエクスポートして(ツールバーの Export をクリック)、別のプロジェクトにインポートすることで、ルールを共有できます。

カスタムインジェクションルールを設定するには、the Add button をクリックして新しいルールを追加するか、あらかじめ定義されたルールをコピーして設定を変更します。

2025 年 11 月 26 日

関連ページ:

メソッドパラメーター情報の表示

パラメーターヒントは、メソッドおよび関数の呼び出しのパラメーターの名前を示します。パラメーターヒントは、関数呼び出しのパラメーターの横にエディター内に表示されるため、コードが読みやすくなります。エディターでパラメーターヒントをオフにして、を押すとポップアップで表示することができます。WebStorm は、補完リストのパラメーターヒントも表示し、その後、選択した関数のパラメーターヒントを含むツールチップを表示します。エディターでパラメーターヒントを表示する:デフォルトでは、リテラルまたは関数式

自然言語

WebStorm は、正しいプログラミング言語構文だけでなく、適切な文法、スペル、スタイルの点でも、コードベースにエラーがなく一貫性があることを保証できます。プロジェクトの README.md などの一般的なテキストファイルに加えて、識別子と変数の名前、文字列リテラルの内容、コメント、コミットメッセージなど、ソースファイル内の自然言語の一貫性と正確性をチェックします。自然言語プラグインを有効にするこの機能は、デフォルトで WebStorm にバンドルされて有効になっている自然言語プラグインに依存して...