Spec-Zone.ru › Web Extensions

devtools.panels.create()

Добавляет новую панель в инструменты разработчика.

Эта функция принимает: заголовок, URL-адрес файла значка и URL-адрес файла HTML. Она создаёт новую панель в инструментах разработчика, содержимое которой определяется файлом HTML. Она возвращает Promise, который разрешается в объект ExtensionPanel, представляющий новую панель.

Синтаксис

let creating = browser.devtools.panels.create(
  title,       // string
  iconPath,    // string
  pagePath     // string
)

Параметры

title

string. Заголовок панели. Он будет отображаться в строке вкладок в верхней части окна инструментов разработчика и является основным способом, с помощью которого пользователь сможет идентифицировать вашу панель.

iconPath

string. Указывает значок, который будет отображаться рядом с заголовком. Он предоставляется как URL-адрес файла изображения, включённого в ваше расширение. URL-адрес разрешается относительно текущей страницы расширения (если не указан абсолютный URL-адрес, например, "/icons/panel.png").

pagePath

строка. Указывает файл HTML, который определяет фактическое содержимое панели. Он предоставляется как URL-адрес файла HTML, включённого в ваше расширение. URL-адрес разрешается относительно текущей страницы расширения (если не указан абсолютный URL-адрес, например, "/devtools/panel.html"). Файл HTML может включать файлы CSS и JavaScript, как и обычная веб-страница. JavaScript, выполняемый на панели, сможет использовать API инструментов разработчика. Смотрите Расширение инструментов разработчика.

Возвращаемое значение

A Promise, который будет выполнен с объектом ExtensionPanel, представляющим новую панель.

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
create Да 79 54 ? Да 16 ? ? Нет ? Нет ?

Примеры

Создайте новую панель и добавьте обработчики событий onShown и onHidden:

function handleShown() {
  console.log("panel is being shown");
}

function handleHidden() {
  console.log("panel is being hidden");
}

browser.devtools.panels.create(
  "My Panel",                 // title
  "/icons/star.png",           // icon
  "/devtools/panel/panel.html" // content
).then((newPanel) => {
  newPanel.onShown.addListener(handleShown);
  newPanel.onHidden.addListener(handleHidden);
});

Примечание: Этот API основан на API chrome.devtools.panels Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools/panels/create

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API