Что такое параметр accessKey для GM_registerMenuCommand () и как его использовать?

Question

Я смотрел на функцию GM_registerMenuCommand в Tampermonkey, и я заметил третий параметр, названный accessKey, и подумал, что нужно передать горячую клавишу для запуска этой команды.

Каков формат передаваемого параметра, и я ошибаюсь, полагая, что это именно то, что он делает?

Я не смог найти документацию по параметру где-либо.Кто-нибудь здесь когда-либо использовал это раньше?

Answer 1

Синтаксис для этой функции: :

GM_registerMenuCommand (menuName, callbackFunction, accessKey)

• Где accessKey, если он указан, должен быть одной буквой строки, переданной как menuName.
  Это меню «клавиша доступа», используемое для упрощения Good UI путем добавления поддержки только для клавиатуры .

С Руководство по оформлению меню ^{(Номер 8)} :

Выпадающие списки (как меню, так и поля) должны поддерживать не только ввод с помощью мыши, но и клавиши. В раскрывающихся меню клавиши доступа должны позволять пользователям быстро выбирать видимый параметр без использования мыши. В раскрывающемся списке пользователи должны иметь возможность вводить буквы и быстро переходить к параметрам начиная с этого письма.

^{(выделение добавлено.)}

Важное замечание: Клавиши доступа отличаются от и в дополнение к любым сочетаниям команд («горячие клавиши») .

---

Вот пример рабочего скрипта Tampermonkey, который иллюстрирует использование:

// ==UserScript==
// @name     _GM_registerMenuCommand demo
// @match    /8587902/chto-takoe-parametr-accesskey-dlya-gmregistermenucommand-i-kak-ego-ispolzovat*
// @match    *://YOUR_SERVER.COM/YOUR_PATH/*
// @grant    GM_registerMenuCommand
// ==/UserScript==

/*-- GM_registerMenuCommand (menuName, callbackFunction, accessKey)
*/
GM_registerMenuCommand ("Say Hello", helloFunc, "H");

function helloFunc () {
    console.log ("Say hello to my little script.");
}

Если вы установите и запустите его через Tampermonkey, вы увидите (щелкните для увеличения изображения):

---

Примечания:

1. Violentmonkey пока игнорирует параметр accessKey.
2. Greasemonkey 4+ отключил эту функцию . & emsp; за обычную .
3. Вы можете установить команду клавиатуры для активации значка / меню Tampermonkey в Chrome .
4. Активация иконки клавиатуры в настоящее время не работает в Firefox, но обходной путь запланирован для Firefox версии 67 .