ノードをコメントアウトする

どうやって使うのですか

MPS 内のルート以外の任意のノードを選択し、Ctrl+/ を押すと、そのノードがコメントアウトされます。いくつか例を見てみましょう。

選択したノードまたはカーソルを合わせたノードはコメントアウトされます。1 行全体を占めるのか、それとも数行行を占めるのか、式のような階層構造で深くネストされているのかに関係なく、すべての単一の非ルートノードをコメントアウトできます。

ノードをコメントアウトすると、モデル内のその場所から物理的に削除されます。コメントアウトされたノードが要求された子リンクを占有していた場合、ユーザーが新しい子の値を入力できるように空のセルが提供されます。

たとえば、BaseLanguage では、Java パーサーでは不可能なことが可能になります。IfStatement の条件をコメントアウトすることができます。

メソッドパラメーター:

または変数型

別の例を挙げると、エディター定義言語では、エディターセルをコメントアウトすることができます。

スマートコメントアウト

コメントおよびコメント解除アクションは、どのノードをコメント / コメント解除するかを決定するために、それらにある程度のインテリジェンスを持ちます。

• ノードまたはノードのセットが選択されている場合、このノードはコメントアウトまたはコメント解除されます。

• ノードが選択されていない場合、エディターは現在の「行」をコメントアウトまたはコメント解除しようとします - これを達成するために、キャレットのノードで検索を開始してメンバーに近いキャレットのノードの祖先を識別します。この垂直コレクションのうちコメントアウトされている / コメントされていないもの

モデルではどのように機能しますか

ノードがコメントアウトされると、BaseCommentAttribute と呼ばれる特別な子属性の子として配置されます (ラップされます)。次に、この属性のインスタンスが、コメントアウトされたノードの以前の親のコメントアウトされたノードのリンクにアタッチされます。ChildAttribute は LinkAttribute の概念と同じですが、ChildAttribute は集約リンクにアタッチされます。そのため、コメントアウトされたノードは通常の子として保存されず、子ロールの通常のクエリには表示されません。また、node.children 操作はコメントアウトされたノードを無視します。コメントから子を収集するには、node.childrenAndChildAttributes<role> を使用します。node.descendants 操作は現在、コメントアウトされたノードを返しますが、MPS の将来のバージョンで node.children 操作と一貫性を持たせるために変更される可能性があります。

MPS エディターはコメントを認識しており、このロールではコメントアウトされたノードだけでなく子ノードも描画します。

コメント付きノードの照会

smodel 言語には、コメント化されたノードを照会するオプションがあります。任意の属性に機能する同じ構文を使用しますが、コメント属性では包含リンクによるパラメーター化が許可されます。例: ノードに、commands という名前の子コレクションがある場合、commands の子のいずれかがコメントアウトされているかどうかを照会すると、次のようになります。

カスタム

デフォルトでは、コメントされたノードはすべて /* */ で囲まれて描画されます。コンセプトのカスタムコメントエディターを定義することで、コメントアウトされたノードの外観を上書きできます。ヒントコメントを使用して通常のエディターを定義するだけです。

ユーザーがコメント付きコードを視覚的に区別しやすいように、エディターのスタイルを変更する必要があります。

灰色と斜体スタイルを使用する定義済みのコメントスタイルを再利用することも、コメントアウトされたノードに独自のスタイルを作成することもできます。

注 : コメント付きノードの子は通常のエディターで描画する必要があるため、子セル内のコメントヒントを削除する必要があります。

より簡単なカスタマイズ

次に適用可能なエディターセルを使用すると、コメントアウトされたノードの外観をより便利にカスタマイズできます。カスタマイズされた単一のコメントエディターを使用して、階層内の複数の概念に対処できます。

次の適用可能なエディターセルは、コメントヒントを削除し、コンセプトの元のエディター (IfStatement) を見つけるための要求をリダイレクトするだけです。これにより、エディター定義を繰り返す必要がなくなります。共通のスーパーコンセプトのコメントヒントにバインドされた単一のエディターを定義すると、タスクをさらに簡素化できます。これにより、すべてのサブコンセプトがカスタマイズされたコメントエディターを取得します。

コードからのノードのコメントアウト / コメント解除

jetbrains.mps.editor.runtime の CommentUtil クラスを使用すると、アクション、インテンション、キーマップなどのコードからノードをコメントアウトしたり、コメント解除したりできます。これにより、コメントアウトされたノードの動作をさらにカスタマイズするオプションが提供されます。

CellAction_CommentOrUncomment とその継承クラスは同じパッケージに含まれています。これらを使用すると、ノードをコメントアウトして選択状態を復元したり、現在コメントアウトされているノードのコメントを解除したりできます。

コメントエディターのアクション

コメント / コメント解除アクションに対する応答も、ノードレベルでカスタマイズできます。セルのアクションマップで COMMENT アクションのハンドラーを設定できます。

例: ユーザーがロボットの Kaja While ステートメントで条件をコメントアウトできないようにする場合は、上記のアクションマップを条件を表す While エディターのセルにアタッチします。 :

COMMENT アクションはカスタマイズされているため、指示されていることを行います。

アクションは条件ノードが選択されている場合にのみ機能します。

ノードをパラメーターとして CellAction_CommentOrUncommentNode を作成すると、ノードは While ステートメントとなり、アクションは While ステートメントを処理します。

1）コメントがない場合、アクションはコメントアウトします。

2）コメントアウトされている場合、アクションはコメント解除します。

条件のコメントは無効になります。

MPS による移行

MPS は、IOldCommentAnnotation と IOldCommentContainer を使用して、古いカスタムコメントを表す概念を指定すれば、移行を作成できます。過去にはカスタムコメントを作成する一般的な方法が 2 つあったため、インターフェースも 2 つあります。

• IOldCommentAnnotation - コメントアウトされたノードにアノテーションを付ける属性が使用されていた場合、ノードがコメントアウトされていることを示す NodeAttribute によって実装されるべきです。

• IOldCommentContainer- コメント化されたノードが SingleLineComment などの専用の概念で表されている場合、これらの専用の概念はこの概念インターフェースでマークする必要があります

これらのマーカー概念インターフェースは jetbrains.mps.lang.core から提供されるため、これらを使用するには、この言語を拡張する必要があります。アノテーションを付けた後は、これらの概念のノードには汎用コメントアウト機能は適用されず、従来のカスタムコメントアウト機能が優先されます。

さらに、古いコメントアウトの概念には、古いコメントコンテナーは移行されるべきですまたは古いコメントアノテーションは移行する必要がありますという警告が報告されます。これらの警告に対する迅速な修正により、古いカスタムコメントアウトスキームを一般的なスキームに簡単に変換するために必要な移行が作成されます。クイックフィックスを起動し、生成された移行を確認してからプロジェクトを移行するだけです。

完全に手動の移行

移行は完全に手動で作成できます。通常、移行で行う必要があるのは、古いカスタム方法でコメントアウトされているすべてのノードを見つけ、コメントを解除し、各ノードで CommentUtil.comment() を呼び出して、新しい方法でコメントアウトすることです。CommentUtil クラスは jetbrains.mps.editor.runtime から取得されます。

汎用コメントアウト機能は、コメントアウトされたノードを、コメントアウトされたノードの親に添付され、コメントアウトされたノードの本来のロールを保持し、jetbrains.mps.lang.core から取得される BaseCommentAttribute アノテーションでマークします。そのため、コメントアウトされたノードを含むモデルではこの言語を使用する必要があります。自動移行では、変更されたすべてのモデルにこのような言語依存関係を追加する必要があります。BaseLanguage の SingleLineComment ノードを移行した ReplaceSingleLineCommentsWithGenericComments 移行からヒントを得ることができます。