MANUAL & PLAYGROUND
使い方
設定から基本操作までを順番に確認し、ページ下部のPlaygroundで実際の動きを試せます。
01
初期設定
初回インストール後、新しいタブでWelcomeページが開きます。基本操作を確認し、「設定を開く」または「マニュアルを見る」へ進めます。「閉じる」でWelcomeタブを閉じられます。更新時やブラウザ起動時には自動表示しません。インストール前から開いていたページでは、必要に応じて再読み込みしてください。
- 設定ページを開く
ツールバーのTabbySelectアイコンをクリックし、「設定ページを開く」を選択します。
- 有効URLを指定する
「URLフィルターを有効にする」は初期設定でオフです。オンのときのみ、1行ずつ入力したURLパターンに一致するページに対象を制限します。*は任意の文字列に一致します。オフまたは空欄の場合は、すべてのHTTP/HTTPSページが対象です。オフでは入力欄を編集できませんが、保存済みパターンは保持されます。設定変更は開いているページとiframeにも反映されます。既存ユーザーも更新後は、チェックをオンにするまで保存済みパターンを適用しません。
https://example.com/* - 検索方式を選ぶ
設定ページの「検索方式」で先頭一致または部分一致(標準)を選びます。Ja は先頭一致で Japan に、pan は部分一致で Japan に一致します。大文字・小文字は区別しません。変更は自動保存され、開いているページとiframeにも反映されます。
- 候補UIの表示
マウスクリック時の候補UI表示は初期設定でオンです。オフにするとマウスクリックではブラウザ標準のリストを使用します。キーボードやタッチ操作では候補UIが表示されます。ページ遷移後、操作するまでは、自動フォーカスやスクリプトによるフォーカスでは開きません。操作後のプログラムによるフォーカスでは開きます。
- 対象ページでオンにする
アイコンを再度クリックし、ポップアップのトグルをオンにします。設定変更は開いているページにも反映されます。
設定のインポート・エクスポート
設定画面の「エクスポート」で、URLフィルターのON/OFF、URLパターン、検索方式、マウスクリック時の候補表示、Enter確定後のフォーカス移動を tabbyselect-settings.toml に保存できます。フィルターがオフでも保存済みパターンを含めます。「インポート」でファイルを選ぶと、含まれる項目だけを上書きして保存し、開いているページとiframeにも反映します。拡張機能全体のON/OFFとデバッグログ設定は変更しません。
書き出した形式のTOMLファイルを読み込めます。値は1行の文字列配列、二重引用符の文字列、true/falseで記述し、空行と行全体のコメントにも対応します。URLパターンの空行と行頭・行末の空白は除去されます。不正な値や重複項目があるファイルは保存しません。
02
キーボード操作
Tabキーでselectへ移動すると候補UIがすぐに開きます。文字入力で検索し、矢印キーで候補を移動できます。Escで閉じた後は再度キー入力すると開けます。日本語IMEと全角文字にも対応します。
設定の「Enterで確定後、次のフィールドへ移動する」は初期設定でオンです。オフにすると、Enterで候補を確定して候補UIを閉じ、元のselectにフォーカスを残します。Tab/Shift+Tabの移動は変わりません。変更は自動保存され、開いている候補UIとiframeにも反映されます。
候補UIを表示しているselectは青い枠で強調され、候補UIの上部に対象の項目名が表示されます。項目名を取得できない場合は「選択肢を検索」と表示します。候補UIの外でマウスホイールやトラックパッドによるスクロール入力をすると、未確定の候補を確定せずに閉じ、元のselectにフォーカスを戻します。候補UI内のスクロールでは閉じません。iframe内の候補UIは同じiframe内のホイール入力だけが対象です。
03
Playground
拡張機能を有効にした状態で、下の「練習を始める」ボタンからTabキーでselectへ移動してください。文字入力、候補移動、確定を試せます。
このページでは拡張機能の動作を再実装していません。通常のselect要素に対する実際の拡張機能の動作を確認できます。
04
対象と制限
- 対象はネイティブHTMLの単一選択selectです。独自UIのドロップダウンとselect[multiple]は対象外です。
- トップページとiframe内の通常DOMにあるselectが対象です。別ドメイン、入れ子、動的追加、about:blank・srcdocのiframeにも対応し、有効URLはトップページのURLで判定します。ページ側Shadow DOM内は対象外です。
- 有効化できるのはhttp://またはhttps://のページです。ブラウザ設定ページなどでは動作しません。
- マウスクリック時に標準のselectを使用したい場合は、設定の「マウスクリックで候補UIを表示する」をオフにします。オンの場合は候補UIの選択肢をクリックして確定できます。
NEED HELP?
解決しない場合
状況と対象ページのURLを添えてお問い合わせください。