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