Skip to content

Latest commit

 

History

History
164 lines (110 loc) · 9.58 KB

README.ja.md

File metadata and controls

164 lines (110 loc) · 9.58 KB
Raw

ShortcutKey2URL for Chrome

ShortcutKey2URL for Chromeは、ショートカットキーを使用してURLを開いたり、移動したり、JavaScriptを実行できるGoogle Chrome向け拡張機能です。

スタートアップキーであらかじめ設定しておいた動作の一覧を表示し、次のキーでその動作を実行します。
スタートアップキーは、デフォルトの状態ではCtrl+.(ピリオド)です。このキーは後から変更できます。(Macでは、Command+,(カンマ))

キーとして使用できる文字は1文字に限定されません。複数文字として設定しておくことが可能です。ShrotcutKey2URLは、キーとして連続して入力された文字から、対象が1つに絞り込まれた時点でその動作を実行します。

動作として設定できるものには、下記のようなものがあります。

  • URLへの移動。既に開いているURLの場合は、そのタブへ移動し、開かれていない場合には、新しいタブとして開く。
  • 新規タブとしてURLを開く。
  • 現在のタブにURLを開く。
  • 現在のタブで指定したJavaScriptを実行する。
  • 新規タブとしてURLを開いて、その後に指定したJavaScriptを実行する。
  • シークレットウインドウに指定のURLを開く。
  • シークレットウインドウに現在のタブと同じURLを開く。

Manifest V3 の制限により、文字列としてJavaScriptを指定できなくなりました。
Scriptを利用したい場合には、拡張機能を別フォルダに配置したうえで、フォルダ内にあるuser-script.jsに実行したいJavaScriptを記載し、「パッケージ化されていない拡張機能を読み込む」で読み込んで利用する必要があります。 詳しくは Scriptの指定方法 をご参照ください。

インストール

下記からインストールします。

スタートアップキーの設定

スタートアップキーは、 Menu > More tools > Extensions の Keybord shortcuts から変更できます。

Screenshot of change startupkey

操作方法

スタートアップキーを押下すると、ポップアップにてショートカットの一覧が表示されます。

Screenshot of popup

一覧にあるキーを入力すると、対応するショートカットが実行されます。

Screenshot of running

ショートカットの設定

設定画面でショートカットキーを設定します。

Screenshot of option

Settings

Column count は、ポップアップで表示するショートカットの列数を指定します。
左が2を指定した場合、右が3を指定した場合です。

Screenshot of column 2 Screenshot of column 3

OptionのInteractive filter of shortcut keys on the popupをチェックすると、ポップアップで表示するショートカットをインタラクティブに絞り込むことができます。

Screenshot of interactive filter

Disable synchronization of settingsをチェックすると、設定の同期を無効化できます。
ブラウザの同期を行っているけれども、ショートカットキーは分けたいといった場合に有用です。

Shortcut Keys

Add current pageをクリックすると、現在のページをショートカットキーとして簡単に設定できます。

Screenshot of add current page

コンテキストメニューからも追加可能です。

Screenshot of context menu

Screenshot of add current page setting

Keyにはショートカットキーとして割り当てるキーを設定します。複数文字とすることも可能です。 スタートアップキーを押下後、ここで設定したキーを押下することによって、ショートカットが実行されます。

Hide in shortcut key list displayed in popupにチェックを付けると、ポップアップで表示されるショートカットの一覧にて非表示とすることができます。
非表示となるだけで、ショートカットキーとしては有効です。

Actionでショートカットキーとしての動作を指定します。
指定できるものは、下記の通りです。

  • Jump to url URLへの移動。既に開いているURLの場合は、そのタブへ移動し、開かれていない場合には、新しいタブとして開く。
  • Jump to url (Including other windows) URLへの移動。Jump to urlとの違いは、対象が全てのウインドウとなることです。
  • Open url in new tab 新規タブとしてURLを開く。
  • Open url in current tab 現在のタブにURLを開く。
  • Execute script 現在のタブで指定したJavaScriptを実行する。
  • Open url in incognito window シークレットウインドウでURLを開く。
  • Open current tab in incognito window シークレットウインドウで現在のタブを開く。

Script (optional)を指定することによって、URLを開いた後に任意のJavaScriptを実行することができます。

同期

同期に対応しているので、ショートカットキーなどの設定がPC間で共有されます。
ただし、同期で保存可能な容量に制限があるため、同期で保存できないサイズだった場合には、同期せずに保存します。

Import / Export

ショートカットキーの一覧は、エクスポート / インポートが可能です。
これによりバックアップを取ったり、移行を行うことができます。(FirefoxとChrome間での移行など)

Scriptの設定方法

Scriptを利用したい場合には、拡張機能のフォルダ内にあるuser-script.jsにて定義しておく必要があります。
これは Manifest V3 の制限により、文字列としてJavaScriptを指定できなくなったためです。

ただし、Chrome Web Storeからインストールした拡張機能のファイルを編集すると、破損しているとみなされてしまうため、別フォルダに配置したうえで、「パッケージ化されていない拡張機能を読み込む」で読み込む必要があります。

拡張機能のインストールフォルダから、ShortcutKey2URLのフォルダを探し、適当なフォルダにコピーしてください。
拡張機能のインストールフォルダの探し方は、下記を参考にしてください。

user-script.jsのUSER_SCRIPTとして定義した内容が、Scriptの選択肢として表示されます。 user-script.jsには、あらかじめ例となるコードが記載されています。

const USER_SCRIPTS = [
  {
    id: 'scroll-to-bottom',
    title: '(Example) Scroll to bottom',
    func: () => {
      window.scrollTo({
        top: document.body.scrollHeight,
        behavior: 'smooth'
      });
    }
  },
  {
    id: 'save-to-pinboard',
    title: '(Example) Save to Pinboard',
    func: () => {
      // https://pinboard.in/howto/#saving
      q = location.href; if (document.getSelection) { d = document.getSelection(); } else { d = ''; }; p = document.title; void (open('https://pinboard.in/add?url=' + encodeURIComponent(q) + '&description=' + encodeURIComponent(d) + '&title=' + encodeURIComponent(p), 'Pinboard', 'toolbar=no,width=700,height=350'));
    }
  }
];

Screenshot of script

1つのスクリプトは、下記の3つのプロパティから構成されます。

  • id : 一意に識別するためのIDです。画面には表示されませんが、設定値としてこの値が保存されます。
  • title : 設定画面で選択肢として表示される名前です。
  • func : 実際に実行される関数です。

新しいスクリプトを用意する際には、ここに追記します。

追記したら「パッケージ化されていない拡張機能を読み込む」で読み込んで利用してください。
「パッケージ化されていない拡張機能を読み込む」方法は、下記のような手順となります。

  1. Chromeの拡張機能管理ページを開く
    • アドレスバーに chrome://extensions/ と入力します。
  2. デベロッパーモードを有効にする
    • 拡張機能管理ページの右上にある「デベロッパーモード」のスイッチをオンにします。
  3. パッケージ化されていない拡張機能を読み込む
    • 「パッケージ化されていない拡張機能を読み込む」ボタンをクリックします。
    • 拡張機能のフォルダを選択し、「選択」をクリックします。このフォルダには、拡張機能の manifest.json ファイルが含まれている必要があります。