swift selection search

迅速な選択検索

---

注：開発は無期限の休憩中です（ごめんなさい！）

• 問題ページを使用して、見つける可能性のある非常に問題のあるバグを報告してください。
• このプロジェクトは、プルリクエストを受け入れていません。
• SSSの独自のバージョンで作業し、改良されたアドオンとして公開することをお勧めします。他のブラウザでも！

これについてはこちらをご覧ください。

---

説明

Swift Selection Search（SSS）は、お気に入りの検索エンジンを使用してページでいくつかのテキストをすばやく検索するためのFirefoxアドオンです。

ページでテキストを選択し、検索エンジンを備えた小さなポップアップボックスがカーソルの上に表示されます。 1つを押すと、そのエンジンを使用して選択したテキストを自動的に検索できます！

SSSは設定可能です。ポップアップに表示される検索エンジン、アイコンの外観、クリックしたときに何が起こるか、ポップアップが表示される場所、ページがスクロールするときに非表示にするかどうか、選択にテキストを自動コピーする場合、さらに多くのオプションを定義できます。

また、エンジンのいずれかで検索するためのオプションのコンテキストメニューも取得します。必要に応じて、この追加メニューをオプションで無効にすることができます。また、ポップアップ自体を無効にし、このコンテキストメニューのみを残すオプションもあります。あなたの選択。 :)

SSSは、MozillaアドオンズのWebサイトで入手できます。

https://addons.mozilla.org/firefox/addon/swift-selection-search

構築方法

第一に、WebExtensionsはJavaScriptで作成されているため、TypeScriptをJavaScriptに変換できるようにする必要があります。

1. NPMをインストールします。 https://nodejs.orgからnode.jsをダウンロードすると、 npmが並んでいます。

2. プロジェクトのフォルダーで、これをコマンドラインで実行します。

   NPMインストール

   これにより、プロジェクトのタイプスクリプト依存関係がフォルダーnode_modulesにローカルにインストールされます。

3. すべての.tsスクリプトを.js（Windows）に透過させるには：

   "node_modules/.bin/tsc.cmd" -watch -p tsconfig.json

   コマンドは生き続け、.tsファイルの変更後にコードを自動的に再輸送します。これは、開発中に便利です。

これで.jsファイルができるようになるので、SSSをWebExtensionとして使用できます。わーい！

• 短い開発または単なる好奇心のために、SSSを試すより簡単な方法は、Firefoxの＃アドオンページのデバッグ＃デバッグです。 「一時アドオンのロード」ボタンを押し、Swift選択検索「SRC」ディレクトリ（ Manifest.jsonなど）のファイルを選択すると、ブラウザが閉じるまでアドオンをロードします。ほとんどのコードへの変更には、アドオンを再度リロードする必要があります。

• 変更後の自動リロードなど、より長期にわたる開発やパッケージについては、ここでMozillaの指示に従って、 Web-Extツールをインストールして使用してください。

SSSにコードを寄付する方法

準備

1. githubのリポジトリをフォークし、コンピューターにクローンします。

2. 構築方法については、上記の指示に従ってください。

   最終的に、TypeScriptからJavaScriptにコードを自動的に送信するスクリプトが必要であり、SSS on Firefoxのバージョンを実行する方法を知っている必要があります。

3. SSSには3つの主要なブランチがあることを学びます。

   • マスター- モジラアドオンに公開される最終バージョン。 「マスター」は通常、SSSバージョンが変更されたものであるためのコミットを指します（一般的に、バージョンを更新するためだけにコミットがあります）。
   • 開発- 開発が発生し、新しい機能が融合される場所。安定性が低いですが、不完全な機能を持つべきではありません。
   • Addon -SDK- WebExtensionになる前のSSSのコードであるため、無視できます。本質的にアーカイブ。

4. 以下のコードガイドラインをお読みください。

コードガイドライン

• インデントのためのタブをお願いします！ ;）（スペースを使用して物事を調整できます。）
• 線の端に白文学はありません。 vscodeの「files.trimtrailingwhiteSpace」などの設定は、これに役立ちます。
• 既存のコードに表示されるスタイルに従ってください。一部の場所で一貫性がないと思う場合は、自由に自分のことをしてください。とにかくレビューされます。 ;）
• SSSは現在、Firefox 63以降をサポートしています。つまり、WebExtensions APIを使用する場合は特に注意する必要があります。 Firefox 63、または少なくともコードが実行されず、古いバージョンでクラッシュしないことを確認してください。理想的には、Firefox 63をコンピューターに個別にインストールします（それについては別のFirefoxプロファイルを持つことは、大いに役立ちます）。自動更新を無効にします。

コラボレーション

1. 問題リストで解決したい問題を見つけてください。

2. 誰かがすでにそれに取り組んでいるかどうか尋ねてください。さらに、実装方法の詳細や、可能なアプローチを知りたい場合は、お気軽にお問い合わせください！

3. 実装しようとしている新機能またはバグ修正用の新しいgitブランチを作成します。 「開発」からこのブランチを作成して、後でマージを簡素化します（「マスター」にはすべての現在の変更がない場合があります）。

4. おそらく複数のコミットで、変更をブランチへの実装およびコミット/プッシュ。

5. 最後に、変更を元のリポジトリにマージするためのプルリクエストを作成します。コードレビュー、議論、および必要に応じて変更される場合があります。

   ありがとう！

タイプスクリプトの考慮事項と警告

SSSは、型チェッカーによって多くのエラーがキャッチできるため、型注釈の利点を取得するために、JavaScriptからTypeScriptまでのある時点で移植されました。ただし、Typesscriptは、実際にはWebExtensions環境にサンドボックスがあり、それを許可しない場合、スクリプトは他のスクリプトからコード/データをインポートできるとTypeScriptは想定しているため、WebExtensionsとTypeScriptとの相互作用はせいぜい気味が悪いことに注意してください。

コンテンツスクリプトは、バックグラウンドスクリプトまたはその逆からコードが表示されません。複数のコンテンツスクリプトが互いのコードを表示できる唯一の方法は、それらがすべて同じページに、HTMLページにスクリプトとしてどのように含まれているかと同様に、同じページに注入されている場合です。 TypeScriptは、これがWebExtensionsの仕組みであるとは考えていないため、JavaScriptに正しく透過しているからといって、WebExtensionが機能するわけではありません。

動作する例は、バックグラウンドスクリプトでタイプ/クラスを宣言し、他のスクリプトでそれらを参照できることです。タイプチェッカーのみがそれらを気にかけているためです。タイプチェックを受けていますが、問題ありません。

ただし、これらのクラスにいくつかのメソッド、可変割り当てなどを追加しようとすると、コンテンツスクリプトまたはオプションページスクリプトはこれらが表示されません。 JavaScriptに翻訳すると、WebExtensionsのサンドボクシングのために実行時に参照することはできません。これは、それらをconst enumとして宣言しない限り、enums（具体的な値を持つため、「データ」）にも当てはまります。

したがって、このプロジェクトの複数のスクリプトで完全または部分的に宣言されているクラス（たとえば、バックグラウンドスクリプトとページスクリプトの両方で）が表示される場合、上記は理由です。

失敗する可能性のあるもう1つのことは、 instanceofを使用して、オブジェクトが特定のクラスであるかどうかを確認することです。サンドボクシングのために失敗する可能性があるため、カスタム作成されたクラスでこれを行わないでください。