Flutter: doc comments(3本スラッシュ「///」のコメント)のポップアップを表示できない

結論:control+jでポップアップを表示し、「︙」マークから、「Show on Mouse Move」にチェックを入れる

2022/6/24 Flutter エラー・バグ日記 

 

ソースコード内にある、3本スラッシュ(///)で書かれた緑色の説明文「doc comments」と呼ぶらしい)が、説明対象のクラス名やメソッド名の所でマウスオーバーしても、ポップアップ表示されなくなっていた(※IDEはAndroid Studioを使用している)。

 

本記事はライトな日記思考で書いているので、詳細説明はしておらず、基本、テキストのみで画像とかは載せておりません。。m(_ _)m

解説記事ではないため、解決していない内容や、その時々の間違った解釈を述べてしまっている可能性が大いにありますので、何卒、ご了承ください。

 

「doc comments」自体に関しては、下記ページに説明がある。

 

 

ソースコード内に書かれている「doc comments」は、Flutter公式ページにあるクラスやメソッドの説明と同じ内容であることが多い。

 

そのため、最近は、クラス内に有用なメソッドやプロパティが無いか探すとき、公式ページで確認するよりも、直接ソースコード内の「doc comments」を読んだ方が早いので、よく閲覧していた。

 

和訳して読めると楽なので、Google翻訳やDeepLに直接コピペしたいが、改行毎にある3本スラッシュ(///)を除去する必要があり、その点が面倒。

 

しかし、対象となるクラス名やメソッド名のところでマウスオーバーすれば、下図のように、ポップアップで同じコメントを///無しの状態で表示できるので、ここからコピペすれば良く、大変助かっていた。

 

 

今回、そのポップアップを表示できなくなってしまったので、困ったことに。。。

 

Android Studioを再起動しても変わらず。

 

「Preferences」をひと通り眺めるも、該当する設定は見つけられず。

 

仕方なくググってみると、下記情報が見つかり、クラス名やメソッド名にカーソルを当てた状態で「control」+「j」でポップアップを表示できると分かった(Macの場合、「command」キーではなく、あくまで「control」キー)。

 

 

ただ、以前はマウスオーバーするだけでポップアップを表示できていたので、何とか戻せないか試行錯誤したところ、下図のように、ポップアップ右下の「︙」マークから、「Show on Mouse Move」にチェックを入れると、戻せることが分かった。

 

 

明確な記憶は無いが、どこかで設定を変更してしまったのかもしれない。。

 

ただ、マウスオーバーするだけで表示されると、煩わしい時もあるので、今後は「Show on Mouse Move」で切り替え可能であることを覚えておこう。

 

\一般的なエラー対処法をまとめた記事はこちら/

 

リリースしたアプリ(全てFlutterで開発)

OCR文字認識Fast -シンプルな高精度・日本語スキャナー

Google Play で手に入れよう
Download on the App Store

 

暗記用マーカー - シンプル穴埋め問題作成

Google Play で手に入れよう
Download on the App Store

 

超即ToDo –最短2タップで通知登録できるタスク管理アプリ

Google Play で手に入れよう
Download on the App Store

 

かんたんプリント管理:アラート・OCR文字認識・検索機能を搭載

Google Play で手に入れよう
Download on the App Store

 

シンプルメモ帳「BasicMemo」 - 文字カウント、ワンタッチ入力、タグ管理等の機能を搭載

Macのデスクトップ版もリリースしました。

Google Play で手に入れよう
Download on the App Store

 

個人アプリ開発で役立ったもの

おすすめの学習教材

超初心者向けでオススメな元Udemyの講座/

 

 \キャンペーン時を狙えば安価で本場の内容が学べる/

 

\Gitの基礎について無料で学べる/

 

おすすめの学習書籍

実用的image_pickerに関してかなり助けられた/

 

Dartの基礎文法を素早くインプットできる/


Dart入門 - Dartの要点をつかむためのクイックツアー

 

おすすめのソフトウェア

安くて高機能。アプリの独自ドメイン・紹介サイト構築に最適/

 

\アイコン作成・画面設計・クラウド保存...何でもできて超必須

Microsoft Public Affiliate Program (JP)(マイクロソフトアフィリエイトプログラム)

 

おすすめのハードウェア

\リーズナブルな価格で検証端末を確保できる/

 

\目線の高さを調節しやすく、疲れにくい

 

\キータッチが超静音で心地よい/

 

おすすめのサポートアイテム

\部屋の中を仕切って、集中できる開発環境を作れる/

 

\部屋の中でも大き過ぎず、長時間座っても疲れない

 

\バグと格闘した後の肩こりを解消してくれる/

タイトルとURLをコピーしました