diff --git a/files/en-us/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/index.md b/files/en-us/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/index.md index 285dbca2ea4712a..7d8c7cd77bb3dbe 100644 --- a/files/en-us/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/index.md +++ b/files/en-us/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/index.md @@ -17,6 +17,8 @@ To create an `ExtensionSidebarPane`, call the [`browser.devtools.panels.elements - [`devtools.panels.ExtensionSidebarPane.setExpression()`](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools/panels/ExtensionSidebarPane/setExpression) - : Evaluate a JavaScript expression in the web page that the inspector is inspecting. The result is displayed in the sidebar pane. +- [`devtools.panels.ExtensionSidebarPane.setHeight()`](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools/panels/ExtensionSidebarPane/setHeight) + - : Sets the height of the sidebar. - [`devtools.panels.ExtensionSidebarPane.setObject()`](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools/panels/ExtensionSidebarPane/setObject) - : Sets a JSON object that will be displayed in the sidebar pane. - [`devtools.panels.ExtensionSidebarPane.setPage()`](/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools/panels/ExtensionSidebarPane/setPage) diff --git a/files/en-us/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setheight/index.md b/files/en-us/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setheight/index.md new file mode 100644 index 000000000000000..e266bae79cf2d71 --- /dev/null +++ b/files/en-us/mozilla/add-ons/webextensions/api/devtools/panels/extensionsidebarpane/setheight/index.md @@ -0,0 +1,78 @@ +--- +title: devtools.panels.ExtensionSidebarPane.setHeight() +slug: Mozilla/Add-ons/WebExtensions/API/devtools/panels/ExtensionSidebarPane/setHeight +page-type: webextension-api-function +browser-compat: webextensions.api.devtools.panels.ExtensionSidebarPane.setHeight +--- + +{{AddonSidebar}} + +Sets the height of the sidebar. + +This is an asynchronous function that returns a [`Promise`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise). + +## Syntax + +```js-nolint +let setting = browser.devtools.panels.setHeight( + height, // string +) +``` + +### Parameters + +- `height` + - : `String` A CSS-like size specification, such as '100px' or '12ex'. + +### Return value + +A [`Promise`](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) that is fulfilled with no arguments when the height has been set. + +## Examples + +Create a new pane, populate it with an HTML page, and set the pane's height. You could run this code in a script loaded by your extension's [devtools page](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/devtools_page). + +```js +function onCreated(sidebarPane) { + sidebarPane.setPage("sidebar/sidebar.html"); + sidebarPane.setHeight("100px"); +} +``` + +{{WebExtExamples}} + +## Browser compatibility + +{{Compat}} + +> **Note:** This API is based on Chromium's [`chrome.devtools.panels`](https://developer.chrome.com/docs/extensions/reference/devtools_panels/) API. + +