HTML ファイルの操作
PyCharm は、構文とエラーのハイライト、コードスタイルに合わせたフォーマット、構造検証、コード補完、コードエディター内の 専用プレビュータブでのオンザフライプレビューなど、HTML を強力にサポートします。
HTML 仕様は、 言語 & フレームワーク | スキーマと DTD 設定ページ Ctrl+Alt+S のデフォルトの HTML 言語レベル設定で構成できます。 デフォルトでは、W3C の仕様 HTML 5.0 が想定されます。
HTML ファイルを作成する
に移動し、リストから HTML ファイル を選択します。
表示されるダイアログで、拡張子を付けずに新しいファイルの名前を入力します。 新しいファイル名の前にディレクトリ構造全体を入力できます。 ネストされたディレクトリがまだ存在しない場合は、作成されます。
PyCharm は、 HTML ファイルテンプレート に基づいてスタブファイルを作成し、エディターで開きます。
HTML ファイルで参照を作成する
<script>、 <link> 、または <img> タグ内でファイルへのパスを入力し始めると、. PyCharm によってパスの補完が提案されます。
または、 Project ツールウィンドウ (Alt+1) で、参照したい JavaScript、CSS、イメージファイルを選択し、HTML ファイルにドラッグします。 PyCharm は、 <head> 内に <script>、 <link>、 <img> タグを生成します。 <img> タグの場合、PyCharm は width および height 属性も生成します。
コードフラグメントをタグでラップする
ラップするコードフラグメントを選択して Ctrl+Alt+T を押すか、メインメニューから を選択します。
リストから タグで囲む を選択します。 PyCharm は、選択範囲を括弧のペア（
<>および</>）で囲みます。左括弧
<>の内側にタグを入力します。 PyCharm は、終了括弧</>のタグを自動的に入力します。
詳細は コードの生成 をご覧ください。
ドキュメントの検索
ほとんどの HTML タグや属性について、PyCharm は対応する MDN 記事から概要を表示できます。 この概要は ドキュメント ポップアップに表示され、タグや属性の廃止予定ステータスや様々なブラウザーとの互換性情報も示されます。
タグまたは属性がすべてのバージョンのブラウザーで利用可能な場合、PyCharm は互換性に関する情報を表示しません。
それ以外の場合、 ドキュメント ポップアップにタグまたは属性をサポートするブラウザーとそのバージョンも一覧表示されます。
タグまたは属性が廃止予定の場合、ポップアップでこのステータスも通知されます。
タグまたは属性のドキュメントを表示する
タグまたは属性にキャレットを置き、 Ctrl+Q を押すか、メインメニューから を選択します。
タグや属性の上にマウスを重ねると、PyCharm はその参照をすぐに ドキュメント ポップアップで表示します。
この動作をオフにすることも、ポップアップの表示を速くまたは遅くするように設定することもできます。以下の ドキュメントポップ上への動作の構成を参照してください。
ドキュメントのポップアップの動作を設定する
コードシンボルにマウスを重ねたときにドキュメントの自動表示をオフにするには、ポップアップで
をクリックし、 マウス移動時に表示する オプションを無効化します。ドキュメント ポップ上へを速くまたは遅く表示するには、 設定 ダイアログ（Ctrl+Alt+S ）を開き、 に移動してから、 ドキュメントのポップアップを表示する チェックボックスを選択して遅延時間を指定します。
ブラウザーでタグと属性の MDN ドキュメントを開く
ドキュメント ポップアップ Ctrl+Q で、下部のリンクをクリックしてください。
Shift+F1 を押すか、メインメニューから を選択します。
HTML ファイルのプレビュー出力
HTML コードの出力は、組み込みの PyCharm プレビューで開くことも、外部の任意のブラウザーで開くこともできます。
デフォルトでは、HTML ファイルをブラウザーまたは組み込みプレビューで開いた後、この HTML ファイル（またはリンクされた JavaScript やスタイルシートファイル）が手動または自動で保存されるたびに、PyCharm が自動的にページを再読み込みします。詳細は 変更の保存と復元 を参照してください。
入力時にページを再読み込みするようデフォルトの動作を変更して、HTML や関連ファイルの変更がブラウザーまたは組み込みプレビューにすぐに表示されるようにすることができます。 下記の 自動再読み込みの設定を参照してください。
PyCharm 組み込みプレビュー
PyCharm の組み込みプレビューにより、ブラウザーに切り替えてページをリフレッシュする必要がなくなるため、作業が速くなります。 プレビューは別のエディタータブで開かれ、再読み込みの動作に応じて、入力時または変更の保存時に自動的に再読み込みされます。
PyCharm 組み込みプレビューを開く
メインメニューで、 に移動し、リストから
を選択します。または、コードの上にマウスを移動してブラウザーアイコンのポップ上へを表示し、
をクリックします。
ブラウザーで HTML ファイルをプレビューする
HTML コードが本番環境で正しくレンダリングされることを確認するには、特定のブラウザーで HTML ファイルをプレビューしてください。
組み込みの PyCharm Web サーバーを使用している場合、 再ロードの動作に応じて、変更を保存したり入力すると、ページが自動的に再ロードされます。
に移動し、リストから目的のブラウザーを選択します。
デフォルトの PyCharm ブラウザーを開くには、 デフォルト を選択します。
または、コードの上にカーソルを置くとブラウザーアイコンのポップアップが表示され、目的のブラウザーを示すアイコンをクリックします。
ブラウザーが 1 つしかない場合は、 Alt+F2 を押してください。
ポップアップでブラウザーアイコンを設定する
設定 ダイアログ（Ctrl+Alt+S ）を開き、 に進みます。
一部のアイコンを非表示にするには、不要なブラウザーの アクティブ チェックボックスをオフにします。
ポップアップ全体を非表示にするには、 HTML ファイル用 チェックボックスをオフにします。
自動再ロードを構成する
デフォルトでは、HTML ファイルをブラウザーまたは組み込みプレビューで開いた後、この HTML ファイル（またはリンクされた JavaScript やスタイルシートファイル）が手動または自動で保存されるたびに、PyCharm が自動的にページを再読み込みします。詳細は 変更の保存と復元 を参照してください。
ページの再ロードをトリガーするファイルを保存すると、PyCharm は 了解 ツールチップを表示します。
入力時にページを再読み込みするようデフォルトの動作を変更して、HTML や関連ファイルの変更がブラウザーまたは組み込みプレビューにすぐに表示されるようにすることができます。
ツール | ウェブブラウザーとプレビュー 設定ページ Ctrl+Alt+S に移動します。 または、 Got it! ツールチップで 構成 をクリックします。
再ロードの動作 領域で、 ブラウザーでページを再ロード および 組み込みプレビューでページを再ロード リストから、Web ブラウザーおよび組み込みプレビューでページの自動再ロードをトリガーするアクションを選択します。 デフォルトでは、 保存時 が選択されています。
対応する HTML ファイルまたはリンクされたファイルを更新するときにページを再ロードするには、 変更時 を選択します。
自動アップロードを抑制するには、 無効 を選択してください。
エディターで Web ページの HTML ソースコードを表示する
Ctrl+Shift+A を押し、リストから URL からソースコードを開く… を選択します。
表示される URL を開く ダイアログで、Web ページの URL アドレスを入力するか、リストから以前に開いた URL を選択します。
埋め込まれたイメージを表示する
PyCharm は、HTML ファイルに埋め込まれた画像を表示するいくつかの方法を提供します。 ソースへのナビゲーションを使用するか、 外部のグラフィカルエディターでイメージを開くか、 オンザフライでイメージをプレビューするを使用できます。
PyCharm でイメージを表示する
Project ツールウィンドウで、イメージファイルを見つけて選択します。
あるいは、エディター内のイメージへの参照にキャレットを置き、 Ctrl+B を押します。
別のタブではなくポップ上へでイメージをプレビューするには、そのイメージへの参照を選択して Ctrl+Shift+I を押します。
外部エディターでイメージを表示する
Project ツールウィンドウで、イメージファイルを右クリックし、 を選択します。
あるいは、 Ctrl+Alt+F4 を押します。
PyCharm は、OS でデフォルトで使用されているエディターで画像を開きます。 IDE がファイルを開く 別のイメージエディターを設定できます。
デフォルトの外部エディターを変更する
エディターでイメージを右クリックし、コンテキストメニューから Edit Path to External Editor… を選択します。
Ctrl+Shift+A を押して
Edit Path to External Editorと入力することもできます。Path to External Editor ダイアログで、画像を開きたいアプリケーションのパスを指定し、 保存 をクリックします。
インクルードファイルを抽出する
HTML コードの断片を別のインクルードファイルに抽出できます。 <script> タグ内の JavaScript コードブロック全体も同様に抽出できます。 PyCharm はまた、選択したフラグメントの複製の代わりに参照を追加することを提案します。
エディターで、抽出するコードブロックを選択し、メインメニューまたは選択したコンテキストメニューから を選択します。
表示される インクルードファイルの抽出ダイアログで、拡張子を付けずにインクルードファイルの名前とそれを格納するディレクトリを指定します。 事前定義されたディレクトリをそのまま使用するか、別のディレクトリを選択することができます。
準備ができたら OK をクリックします。 PyCharm は、選択したソースコードをターゲットディレクトリ内の指定ファイルに抽出し、ソースファイルに対応するリファレンスを生成します。
構文ハイライトを構成する
好みや作業習慣に合わせて HTML 構文ハイライトを設定できます。
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。
配色を選択するか、デフォルトから継承されたハイライト設定を受け入れるか、 色とフォント の説明に従ってカスタマイズできます。
カスタム HTML タグを構成する
PyCharm はすべての標準 HTML タグを認識し、マークアップ内の未知のタグを報告します。 カスタム HTML タグに依存するフレームワークを使用する場合、それらのタグも未知のものとして報告されるため、その場合は誤検知になります。
単一の HTML タグを既知のカスタムタグのリストに追加するには、ハイライトされたタグにキャレットを置き、 Alt+Enter を押して カスタム HTML タグに [tag] を追加 を選択します。
複数のカスタム HTML タグを構成するには、 設定 ダイアログ (Ctrl+Alt+S) の ページに移動し、 インスペクションを見つけて、右側のインスペクションオプションでカスタム HTML タグのリストを構成します。
HTML でのクラウド補完と行全体補完
PyCharm は HTML コードで クラウド補完と Full Line 補完を提供します。
行全体コード補完機能は、ローカルで実行されるディープラーニングモデルを使用して、コード行全体を提案します。 PyCharm ではすぐに利用でき、追加のライセンスは必要ありません。
HTML で行全体コード補完を有効にする
Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | インライン補完 を選択します。
Enable local Full Line completion suggestions チェックボックスを選択し、 HTML ファイルの操作 チェックボックスが選択されていることを確認します。
AI Assistant を活用したクラウド補完は、プロジェクトのコンテキストに基づいて、単一行、コードブロック、関数全体さえリアルタイムで自動補完できます。
Cloud Completion は、コンテキストを考慮して構文的に許容可能なソリューションを提案し、さまざまな コードインスペクション を事前に実行してエラーとなるバリエーションを排除します。
HTML でクラウド補完を有効にする
Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | インライン補完 を選択します。
Enable cloud completion suggestions チェックボックスを選択し、 HTML ファイルの操作 チェックボックスが選択されていることを確認します。
