Меню

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

Отслеживайте щелчки по элементу меню, добавив обработчик события menus.onClicked. Этот обработчик получит объект menus.OnClickData, содержащий подробности события.

Вы можете создать четыре разных типа элементов меню, в зависимости от значения свойства type , которое вы передаете в параметры для create():

• "normal": элемент меню, который просто отображает метку
• "checkbox": элемент меню, который представляет двоичное состояние. Он отображает галочку рядом с меткой. Щелчок по элементу переключает галочку. Обработчик щелчка получит два дополнительных свойства: "checked", указывающее, установлен ли флажок сейчас, и "wasChecked", указывающее, был ли флажок установлен до события щелчка.
• "radio": элемент меню, представляющий один из набора вариантов. Подобно флажку, он также отображает галочку рядом с меткой, и его обработчик щелчка получает "checked" и "wasChecked". Однако, если вы создаете более одного элемента "radio", эти элементы функционируют как группа элементов "radio": только один элемент в группе может быть выбран, и щелчок по элементу делает его выбранным элементом.
• "separator": линия, разделяющая группу элементов.

Если вы создали более одного элемента контекстного меню или более одного элемента меню инструментов, элементы будут размещены в подменю. Родительским элементом подменю будет метка с именем расширения. Например, вот расширение под названием "Демонстрация меню", которому добавлены два элемента контекстного меню:

Если вы указали иконки для своего расширения, используя ключ "icons" манифеста, элемент меню будет отображать указанную иконку рядом с его меткой. Браузер попытается выбрать иконку размером 16x16 пикселей для обычного отображения или 32x32 пикселя для отображения высокой плотности:

Только для элементов в подменю, вы можете указать пользовательские иконки, передав опцию icons методу menus.create():

Вот контекстное меню, содержащее 4 элемента: обычный элемент, два элемента "radio" с разделителями по обе стороны и флажок. Элементам "radio" заданы пользовательские иконки.

Вы могли бы создать подменю, используя код такого типа:

browser.menus.create({
  id: "remove-me",
  title: browser.i18n.getMessage("menuItemRemoveMe"),
  contexts: ["all"]
}, onCreated);

browser.menus.create({
  id: "separator-1",
  type: "separator",
  contexts: ["all"]
}, onCreated);

browser.menus.create({
  id: "greenify",
  type: "radio",
  title: browser.i18n.getMessage("menuItemGreenify"),
  contexts: ["all"],
  checked: true,
  icons: {
    "16": "icons/paint-green-16.png",
    "32": "icons/paint-green-32.png"
  }
}, onCreated);

browser.menus.create({
  id: "bluify",
  type: "radio",
  title: browser.i18n.getMessage("menuItemBluify"),
  contexts: ["all"],
  checked: false,
  icons: {
    "16": "icons/paint-blue-16.png",
    "32": "icons/paint-blue-32.png"
  }
}, onCreated);

browser.menus.create({
  id: "separator-2",
  type: "separator",
  contexts: ["all"]
}, onCreated);

let checkedState = true;

browser.menus.create({
  id: "check-uncheck",
  type: "checkbox",
  title: browser.i18n.getMessage("menuItemUncheckMe"),
  contexts: ["all"],
  checked: checkedState
}, onCreated);

menus.ContextType

Различные контексты, в которых может отображаться меню.

menus.ItemType

Тип элемента меню: "normal", "checkbox", "radio", "separator".

menus.OnClickData

Информация, отправляемая при нажатии на элемент меню.

menus.ACTION_MENU_TOP_LEVEL_LIMIT

Максимальное количество элементов расширений верхнего уровня, которые могут быть добавлены в элемент меню, у которого ContextType равен "browser_action" или "page_action".

menus.create()

Создает новый элемент меню.

menus.getTargetElement()

Возвращает элемент для заданного info.targetElementId.

menus.overrideContext()

Скрыть все стандартные элементы меню Firefox в пользу настраиваемого пользовательского интерфейса контекстного меню.

menus.refresh()

Обновить отображаемое меню.

menus.remove()

Удаляет элемент меню.

menus.removeAll()

Удаляет все элементы меню, добавленные этим расширением.

menus.update()

Обновляет ранее созданный элемент меню.

menus.onClicked

Вызывается при нажатии на элемент меню.

menus.onHidden

Вызывается, когда браузер скрывает меню.

menus.onShown

Вызывается, когда браузер отображает меню.