Sass、SCSS、Less、PostCSS
GoLand は、 Sass、 Less、 SCSS コードを CSS に変換するコンパイラーと連携します。 GoLand でコンパイラーを利用するには、関連する事前定義済みテンプレートに基づいて ファイルウォッチャー として構成する必要があります。
SASS および LESS プラグインをインストールする
GoLand で SASS および LESS を使用するには、JetBrains 製の SASS および LESS プラグインをインストールしてください。
設定 | プラグイン を開きます。
マーケットプレース をクリックしてください。
検索フィールドに
SassまたはLessと入力し、 Enter を押します。プラグインをインストールするには、 インストール をクリックし、GoLand を再起動してください。
Sass/SCSS のインストール
組み込み ターミナル (Alt+F12) で次のように入力します。
npm install -g sassSass オフィシャル Web サイト(英語)の詳細を参照してください。
Less のインストール
組み込み ターミナル (Alt+F12) で次のように入力します。
npm install --global lessLess オフィシャル Web サイト(英語)の詳細を参照してください。
コードを CSS にコンパイルする
コードを自動的にコンパイルするには、コンパイラーをインストールし、ファイルへの変更を追跡してコンパイラーを実行する Sass、Less、SCSS File Watcher を構成する必要があります。
ファイルを開くと、GoLand は現在のプロジェクトで該当するファイルウォッチャーが利用可能かを確認します。 そのようなファイルウォッチャーが設定されているが無効の場合、GoLand は構成済みのファイルウォッチャーについて通知し、有効化を提案するポップアップを表示します。
現在のプロジェクトで該当するファイルウォッチャーが構成され有効化されている場合、GoLand は New Watcher ダイアログで指定されたイベントが発生すると自動的にコンパイラーを起動します。
編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスが選択されている場合、ソースウォッチに変更が加えられるとすぐに File Watcher が呼び出されます。
編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスがオフの場合、保存時(、 Ctrl+S )または GoLand からフォーカスを移動したとき(フレームの非アクティブ化時)にファイルウォッチャーが開始されます。
詳しくは File Watchers をご覧ください。
GoLand は生成した出力で別のファイルを作成します。 ファイルの名前は、ソース Sass、 Less、 SCSS ファイルの名前と拡張子 .css です。 生成したファイルの場所は、 リフレッシュする出力パス フィールドが 新しいウォッチャーのダイアログ 内で定義されます。 しかし、 プロジェクトツリー では、それらは現在ノードとして表示されているソースファイルに表示されます。
File Watcher を作成する
設定 ダイアログ(Ctrl+Alt+S )で、 ツール の File Watchers をクリックします。 開く File Watchers ページには、構成済みのファイルウォッチャーのリストが表示されます。
をクリックするか、 Alt+Insert を押します。 使用するツールに応じて、リストから Less、 Sass、 SCSS の事前定義テンプレートを選択します。
プログラム フィールドで、選択した事前定義テンプレートに応じてコンパイラーアーカイブへのパスを指定します。
Less 用の lessc 。
Sass/SCSS 用の sass 。
npm の標準インストールプロシージャに従った場合、GoLand は必要なファイルを自動で検出し、フィールドに自動入力します。 それ以外の場合は、パスを手動で入力するか、
をクリックして、表示されるダイアログでファイルの場所を選択します。
File Watchers に記載されている手順に従ってください。
サンプル: SCSS を CSS にコンパイルする
プロジェクトが次のような構造であると仮定します:

ご覧のとおり、 _grid.scss は Page.scss にインポートされます。 以下の例は、プロジェクトを手動または自動で保存するときに Page.scss が CSS にコンパイルされる方法と、 _grid.scss への変更が生成された CSS ファイルにどのように反映されるかを示しています。
SCSS タイプのファイルウォッチャーを作成します。 設定 ダイアログを開き(Ctrl+Alt+S)、 に進み、ツールバーで
をクリックして、リストから SCSS を選択します。

開いた 新しいファイルウォッチャー ダイアログでは、必須フィールドはすべてすでに入力されています。

実際、これらの設定でコンパイラーを問題なく実行できます。
grid.scss を変更してみましょう。たとえば、31 行目の
margin-left: 0;をmargin-left: 12px;に置き換えます。 この操作でファイルウォッチャーがトリガーされ、コンパイラーが Page.scss を処理します。 その結果、ファイルが 2 つ生成され、 Page.scss の下にネスト表示されます:コンパイルされた CSS コードを含む Page.css
デバッグセッション中にアプリをステップスルーできるソースマップを備えた Page.css.map 。

デフォルト設定でコンパイラーを正常に実行できますが、ファイルウォッチャーの動作をカスタマイズする方法を確認するために、それらを詳しく見てみましょう。
FileWatcher をトリガーするアクションを変更する
プロジェクトが手動( または Ctrl+S )または自動で保存されるとすぐに、File Watcher が起動し、トランスパイラーを起動します。
通常、GoLand からフォーカスを外すと (フレームの非アクティブ化時)、コードは自動的に保存されます。 File Watchers では、File Watcher のスコープからファイルを編集するときにも自動保存が実行されます。 その結果、入力中は常にトランスパイラが実行され、パフォーマンスの問題が発生する可能性があります。 この問題を解決するには、編集したファイルの自動保存を抑制します。
Ctrl+Alt+S を押して設定を開き、 を選択します。 必要な File Watcher(この例では SCSS )を選択し、ツールバーの をクリックします。 ファイルウォッチャーを編集 ダイアログで、 拡張オプション 領域を展開し、 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスをオフにします。

デフォルトでは、ファイルウォッチャーはスコープ内のファイルが GoLand の外部で編集された場合でも起動します。 この動作を無効にして、内部で編集するときにのみファイルをトランスパイルするには、 外部の変更でウォッチャーをトリガーする チェックボックスをオフにします。

スコープを変更する
デフォルトでは、GoLand はプロジェクト全体にある .scss 拡張機能を持つすべてのファイルの変更を監視します。 これは今回の例に適しています。 ただし、たとえば未コミットの変更だけを処理するようにスコープを変更できます。 大規模なプロジェクトでは、これにより時間を節約できます。
Ctrl+Alt+S を押して設定を開き、 を選択します。 必要な File Watcher(この例では SCSS )を選択し、ツールバーの をクリックします。 ファイルウォッチャーを編集 ダイアログで、リストから該当するスコープを選択します。 詳しくは スコープとファイルの色 を参照してください。

カスタム出力場所
デフォルトでは、生成された .css および .css.map ファイルは元のファイルと同じフォルダーに保存され、 プロジェクト ツールウィンドウ (Alt+1) では元のファイルの子ファイルとして表示されます。 このデフォルトの動作を変更して、生成されたすべての .css および .css.map ファイルを別のフォルダーに保存することもできます。
簡単なケースから始めましょう。 プロジェクトルートに custom_output.scss ファイルがあるとします。

custom_output.scss を編集しましょう。たとえば、6 行目の fill-opacity: abs(50); を fill-opacity: abs(60); に置き換えます。 デフォルトの File Watcher 構成では、生成されたファイル custom_output.css および custom_output.css.map はプロジェクトルートに保存され、 custom_output.scss の子として表示されます。

すべての出力を別のフォルダー(たとえば、 css )に保存すると便利です。 css フォルダーを出力場所として使用してカスタム SCSS_custom_output ファイルウォッチャーを作成しましょう。
Ctrl+Alt+S を押して設定を開き、 を選択します。 そして、 上記の手順に従ってSCSS File Watcher を作成します。
デフォルト設定を次のように更新します:
引数 フィールドに入力します:
$FileName$:$ProjectFileDir$/css/$FileNameWithoutExtension$.cssリフレッシュする出力パス フィールドに入力します:
$ProjectFileDir$/css/$FileNameWithoutExtension$.css:$ProjectFileDir$/css/$FileNameWithoutExtension$.css.map

新しいファイルウォッチャーを保存し、有効化されていることを確認します。

ここで、たとえば custom_output.scss を編集し、6 行目の fill-opacity: abs(50); を fill-opacity: abs(60); に置き換えると、GoLand は css フォルダーを作成し、生成した custom_output.css ファイルと custom_output.css.map ファイルをその中に保存します。

カスタム出力場所: 元のフォルダー構造を保持する
次に、 .scss ファイルがフォルダー構造に格納されている例を考えてみましょう。例えば:

デフォルトの File Watcher では、生成されたファイルは元の .scss ファイルの隣に保存されます。

上記のようにカスタム File Watcher を使用すると、生成されたすべてのファイルが同じ css フォルダーに保存されます。

GoLand でフォルダー構造を保持するには、別のカスタムファイルウォッチャーを作成しましょう。
Ctrl+Alt+S を押して設定を開き、 を選択します。 そして、 上記の手順に従ってSCSS File Watcher を作成します。
デフォルト設定を次のように更新します:
引数 フィールドに入力します:
$FileName$:$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.cssリフレッシュする出力パス フィールドに入力します:
$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css:$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css.map

新しいファイルウォッチャーを保存し、有効化されていることを確認します。

ここで、 custom_output_body.scss 、 custom_output_header.scss 、または custom_output_footer.scss を編集すると、GoLand は styles_structured の構造を保持したサブフォルダー構成で css フォルダーを作成します。

サンプル: Less を CSS にコンパイルする
プロジェクトが次のような構造であると仮定します:

以下の例は、プロジェクトを手動または自動で保存するときに my-styles.less が CSS にコンパイルされる方法と、 my-styles.less への変更が生成された CSS ファイルにどのように反映されるかを示しています。
Less タイプのファイルウォッチャーを作成します。 設定 ダイアログを開き(Ctrl+Alt+S)、 に進み、ツールバーで
をクリックして、リストから Less を選択します。

または、エディタータブの上部にある LESS を CSS にコンパイルするためにファイルウォッチャーを有効化しますか? ペインで、 .less ファイルを含む はい をクリックします。

開いた 新しいファイルウォッチャー ダイアログでは、必須フィールドはすべてすでに入力されています。

実際、これらの設定でコンパイラーを問題なく実行できます。
my-styles.less を編集してみましょう。たとえば、1 行目の
@色の値を変更します。 この操作でファイルウォッチャーがトリガーされます。 その結果、ファイルが 2 つ生成され、 my-styles.less の下にネスト表示されます:コンパイルされた CSS コードを含む my-styles.css
デバッグセッション中にアプリをステップスルーできるソースマップを備えた my-styles.css.map 。

デフォルト設定でコンパイラーを正常に実行できますが、ファイルウォッチャーの動作をカスタマイズする方法を確認するために、それらを詳しく見てみましょう。
FileWatcher をトリガーするアクションを変更する
プロジェクトが手動( または Ctrl+S )または自動で保存されるとすぐに、File Watcher が起動し、トランスパイラーを起動します。
通常、GoLand からフォーカスを外すと (フレームの非アクティブ化時)、コードは自動的に保存されます。 File Watchers では、File Watcher のスコープからファイルを編集するときにも自動保存が実行されます。 その結果、入力中は常にトランスパイラが実行され、パフォーマンスの問題が発生する可能性があります。 この問題を解決するには、編集したファイルの自動保存を抑制します。
Ctrl+Alt+S を押して設定を開き、 を選択します。 必要な File Watcher(この例では Less )を選択し、ツールバーの をクリックします。 ファイルウォッチャーを編集 ダイアログで、 拡張オプション 領域を展開し、 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスをオフにします。

スコープを変更する
デフォルトでは、GoLand はプロジェクト全体にある .scss 拡張機能を持つすべてのファイルの変更を監視します。 これは今回の例に適しています。 ただし、たとえば未コミットの変更だけを処理するようにスコープを変更できます。 大規模なプロジェクトでは、これにより時間を節約できます。
Ctrl+Alt+S を押して設定を開き、 を選択します。 必要な File Watcher(この例では Less )を選択し、ツールバーの をクリックします。 ファイルウォッチャーを編集 ダイアログで、リストから該当するスコープを選択します。 詳しくは スコープとファイルの色 を参照してください。

カスタム出力場所
デフォルトでは、生成された .css および .css.map ファイルは元のファイルと同じフォルダーに保存され、 プロジェクト ツールウィンドウ (Alt+1) では元のファイルの子ファイルとして表示されます。 このデフォルトの動作を変更して、生成されたすべての .css および .css.map ファイルを別のフォルダーに保存することもできます。
簡単なケースから始めましょう。 プロジェクトルートに custom_output.less ファイルがあるとします。

たとえば、 custom_output.less を編集して、1 行目の @色 の値を変更します。 デフォルトの File Watcher 構成では、生成されたファイル custom_output.css および custom_output.css.map はプロジェクトルートに保存され、 custom_output.less の子として表示されます。

すべての出力を別のフォルダー(たとえば、 css )に保存すると便利です。 css フォルダーを出力場所として使用してカスタム Less_custom_output ファイルウォッチャーを作成しましょう。
Ctrl+Alt+S を押して設定を開き、 を選択します。 そして、 上記の手順に従ってLess と File Watcher を作成します。
デフォルト設定を次のように更新します:
引数 フィールドに入力します:
$FileName$ $ProjectFileDir$/css/$FileNameWithoutExtension$.css --source-mapリフレッシュする出力パス フィールドに入力します:
$ProjectFileDir$/css/$FileNameWithoutExtension$.css $ProjectFileDir$/css/$FileNameWithoutExtension$.css.map

新しいファイルウォッチャーを保存し、有効化されていることを確認します。

ここで、たとえば custom_output.less を編集して 1 行目の @色 の値を変更すると、GoLand は css フォルダーを作成し、生成した custom_output.css と custom_output.css.map ファイルをその中に格納します。

カスタム出力場所: 元のフォルダー構造を保持する
次に、 .less ファイルがフォルダー構造に格納されている例を考えてみましょう。例えば:

デフォルトの File Watcher では、生成されたファイルは元の .less ファイルの隣に保存されます。

上記のようにカスタム File Watcher を使用すると、生成されたすべてのファイルが同じ css フォルダーに保存されます。

GoLand でフォルダー構造を保持するには、別のカスタムファイルウォッチャーを作成しましょう。
Ctrl+Alt+S を押して設定を開き、 を選択します。 そして、 上記の手順に従ってLess と File Watcher を作成します。
デフォルト設定を次のように更新します:
引数 フィールドに入力します:
$FileName$ $ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css --source-mapリフレッシュする出力パス フィールドに入力します:
$ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css $ProjectFileDir$/css/$FileDirRelativeToProjectRoot$/$FileNameWithoutExtension$.css.map

新しいファイルウォッチャーを保存し、有効化されていることを確認します。

ここで、 custom_output_body.less 、 custom_output_header.less 、または custom_output_footer.less を編集すると、GoLand は styles_structured の構造を保持したサブフォルダー構成で css フォルダーを作成します。

構文ハイライトの構成
Less/Sass/SCSS/PostCSS 対応の構文ハイライトは、お好みに合わせて設定できます。
設定 ダイアログ(Ctrl+Alt+S )で に移動します。
カラースキームを選択するか、デフォルトから継承されたハイライト設定を受け入れるか、 色とフォント で説明されているようにカスタマイズします。
Sass および SCSS セレクター一式
GoLand は Sass および SCSS のセレクターの補完を提供します(ネストされたセレクターや アンパサンド(&)で作成されたセレクターを含む)。
クラウド補完と行全体補完
GoLand は、Sass/SCSS、Less、PostCSS コードで クラウド補完 および 行全体補完を提供します。
行全体コード補完機能は、ローカルで実行されるディープラーニングモデルを用いて、コード行全体を提案します。 GoLand ですぐに利用でき、追加のライセンスは必要ありません。
行全体コード補完を有効にする
Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | インライン補完 を選択します。
ローカルの Full Line 補完候補を有効化する チェックボックスを選択し、 CSS のような チェックボックスが選択されていることを確認します。

AI Assistant を搭載したクラウド補完では、プロジェクトのコンテキストに基づいて、行、コードブロック、関数全体までリアルタイムで補完可能です。
Cloud Completion は、コンテキストを考慮して構文的に許容可能な解決策を提案し、様々な コードインスペクションを事前に実行して、エラーとなるバリエーションを排除します。
クラウド補完を有効にする
Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | インライン補完 を選択します。
クラウド補完候補を有効化する チェックボックスを選択し、 HTML チェックボックスが選択されていることを確認します。

検索とナビゲーション
ドキュメントの検索
プロパティや疑似要素については、GoLand は対応する MDN 記事から概要を表示できます。 この概要は ドキュメント ポップアップに表示され、プロパティとその値の簡単な説明と、対応する Web プラットフォームのベースラインステータス(英語)が表示されます。



セレクターについては、GoLand もその 詳細度を表示します。

プロパティのドキュメントを表示
プロパティにキャレットを置き、 Ctrl+Q を押すか、メインメニューから を選択します。
プロパティの上にマウスを重ねると、GoLand が直ちに ドキュメント ポップアップでリファレンスを表示します。
この動作をオフにすることも、ポップアップの表示を速くまたは遅くするように設定することもできます。以下の ドキュメントポップ上への動作の構成を参照してください。
ドキュメントポップアップの動作を設定する
コードシンボルの上にマウスを重ねたときにドキュメントが自動表示されるのを無効化するには、ポップアップで
をクリックし、 マウス移動で表示する オプションをオフにしてください。
ドキュメント ポップアップを速くまたは遅く表示するには、 設定 ダイアログ(Ctrl+Alt+S )を開き、 に移動してから、 ドキュメントのポップアップを表示する チェックボックスを選択して遅延時間を指定します。
ブラウザーで MDN ドキュメントを開く
ドキュメント ポップアップ Ctrl+Q で、下部にあるリンクをクリックします。
Shift+F1 を押すか、メインメニューから を選択します。
リファクタリング
GoLand を使うと、スタイルシート内の式を変数に変換し、 .css ファイルでは var(--var-name) 構文、 .scss および .sass ファイルでは $ 構文で変数を導入できます。
変数の導入
エディターで、変数に変換する式にキャレットを置き、 Ctrl+Alt+V を押すか、コンテキストメニューまたはメインメニューから を選択します。
選択した式が複数出現する場合は、 複数の出現箇所が見つかりました リストから この出現箇所だけを置換 または 出現箇所をすべて置換 を選択してください。
.scss および .sass の場合、変数の グローバルスコープまたは ローカルスコープを選択します。
赤い枠の付いたフィールドで、提案された変数名をそのまま使用するか、カスタム名を指定します。 準備ができたら Enter を押します。
GoLand を使うと、CSS、SCSS、Sass、Less ファイルの既存の宣言から新しいルールセットを作成し、リファクタリングやインテンションアクションでルールセット全体をファイル間で移動することも可能です。
ルールセットを導入する
導入する宣言を選択します。 宣言が 1 つだけ必要な場合は、宣言の中にキャレットを置くだけです。
Alt+Enter を押し、リストから ルールセットの導入 を選択します。
GoLand は同じセレクターの新しいルールセットを作成し、選択した宣言をその中に移動します。 選択範囲にコメント、ネストしたセレクタなどが含まれている場合、それらも新しいルールセットに移動されます。
ルールセットを他のファイルに移動する
ルールセット内の移動する任意の場所にキャレットを置き、 F6 を押します。
表示されたダイアログで、ルールセットを移動するファイルを指定します。 指定したファイルが存在しない場合、GoLand はその作成を提案します。
デフォルトでは、GoLand はルールセットが移動されたファイルを自動的に開きます。 この動作を変更するには、 エディターで開く チェックボックスをオフにします。
コピー、 移動、 名前変更などの一般的なリファクタリングも利用できます。
ブラウザーとの互換性を確認する
ドキュメントポップアップで検索するだけでなく、その場で特定のブラウザーとの互換性についてスタイルシートのプロパティを確認できます。 このインスペクションは MDN ブラウザー互換性データ(英語)に基づいており、対象のブラウザーのいずれかでプロパティがサポートされていない場合は常に警告を表示します。

互換性チェックをオンにする
設定 ダイアログ(Ctrl+Alt+S )で に移動します。
CSS ノードを展開して プロパティは選択されたブラウザーと互換性がありません を選択します。 オプション エリアで、ターゲットにするブラウザーとその最小バージョンを選択します。
オプション 領域で、プロパティの可用性を確認するブラウザーを選択します。 選択したブラウザーのターゲットバージョンを指定します。

色の管理
GoLand は CSS カラー管理をサポートしており、 コード補完、 クイックドキュメント参照、 カラープレビュー などが利用できます。 絶対色、相対色、混合色に対するコーディング支援が提供されます。

色を指定する
色の変更
ガター内のカラーアイコンをクリックし、ポップアップで目的の色を選択します。

または、キャレットを色のプロパティに置き、 Alt+Enter を押して、リストから 色の変更 を選択し、ポップアップで目的の色を選択します。

カラープレビューを切り替える
GoLand は絶対色、相対色、混合色のプレビューを表示します。

デフォルトでは、GoLand はカラープレビューをガター内にアイコンとして表示します。 背景にカラープレビューを表示するには、 設定 ダイアログ(Ctrl+Alt+S )を開き、 に移動して CSS 色プレビューを背景として表示 チェックボックスをオンにします。

カラープレビューガターアイコンを復元するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 に移動して、 共通 領域の 色プレビュー チェックボックスを選択します。

タグに適用されたスタイルを表示する
HTML および XHTML ファイルでは、GoLand は任意のタグに適用されているすべてのスタイルを表示できます。
タグのコンテキストメニューから を選択します。
GoLand は CSS スタイル ツールウィンドウを 2 つのペインで開き、左側のペインにタグのスタイル、右側のペインにその定義を表示します。 タグごとに、GoLand は別タブで開きます。
ツールウィンドウからソースコード内のタグやプロパティ定義にナビゲートできます。
タグに移動するには、左側のペインのツールバーの
をクリックします。
プロパティの定義に移動するには、左側のペインでそれを選択し、右側のペインのツールバーの
をクリックします。

