pageAction.setIcon()

语法

let settingIcon = browser.pageAction.setIcon(
  details         // object
)

参数

details

object。一个包含 imageData 或 path 属性的对象，以及一个 tabId 属性。

imageData 可选

pageAction.ImageDataType 或 object。这要么是一个单独的 ImageData 对象，要么是一个字典对象。

使用字典对象指定不同尺寸的多个 ImageData 对象，这样图标就不必为具有不同像素密度的设备进行缩放。如果 imageData 是字典，则每个属性的值是一个 ImageData 对象，其名称是其尺寸，如下所示：

js

let settingIcon = browser.pageAction.setIcon({
  imageData: {
    16: image16,
    32: image32,
  },
});

浏览器将根据屏幕的像素密度选择要使用的图像。有关详细信息，请参阅 选择图标尺寸。

path 可选

string 或 object。这要么是图标文件的相对路径，要么是一个字典对象。

使用字典对象指定不同尺寸的多个图标文件，这样图标就不必为具有不同像素密度的设备进行缩放。如果 path 是字典，则每个属性的值是一个相对路径，其名称是其尺寸，如下所示：

js

let settingIcon = browser.pageAction.setIcon({
  path: {
    16: "path/to/image16.jpg",
    32: "path/to/image32.jpg",
  },
});

浏览器将根据屏幕的像素密度选择要使用的图像。有关详细信息，请参阅 选择图标尺寸。

如果 path 为 null，这将把页面操作的图标重置为在 page_action manifest 键中提供的图标。

如果 path 为 ""，这将把图标重置为浏览器的全局默认图标（即，如果在 page_action manifest 键中未提供图标时使用的图标）。

如果 path 未指向有效的图标，则不会显示任何图标。

tabId

integer。您要设置图标的标签页的 ID。

返回值

一个 Promise，一旦设置了图标，它将以无参数的形式履行。

示例

当用户单击页面操作时设置其图标

browser.pageAction.onClicked.addListener((tab) => {
  browser.pageAction.setIcon({
    tabId: tab.id,
    path: "icons/icon-48.png",
  });
});

扩展程序示例

• apply-css

浏览器兼容性