This page was saved using WebZIP 7.0.3.1030 offline browser on 12/24/13 11:31:36.
Address: https://crxdoc-zh.appspot.com/extensions/infobars.html
Title: chrome.infobars - Google Chrome 扩展程序开发文档(非官方中文版)  •  Size: 22471

该 API 还是实验性的,仅对 dev 分支的 Chrome 用户可用。

chrome.infobars

描述: 使用 chrome.infobars API 在标签页内容的正上方添加一个水平面板,如以下屏幕截图所示。
可用版本: 仅用于 Dev 分支。
权限: "infobars"

信息栏 API 允许您在标签页的内容上面添加一个水平面板,如以下屏幕截图所示。

An infobar asking whether the user wants to translate the current page

使用信息栏告诉读者有关特定页面的一些信息。当用户离开显示了信息栏的页面,Google Chrome 浏览器会自动关闭信息栏。

您使用 HTML 实现信息栏的内容。因为信息栏是扩展程序中的普通页面,它们可以和其他扩展程序页面通信。

清单文件

信息栏 API 要求 "infobars" 权限,并且仅在 dev 分支可用。此外,您需要指定一个 16×16 像素大小的图标,显示在您的信息栏旁边。例如:

{
  "name": "Andy 的信息栏扩展程序",
  "version": "1.0",
  "permissions": ["infobars"],
  "icons": {
    "16": "16.png"
  },
  "background": {
    "scripts": ["background.js"]
  }
}

chrome.infobars 参考

方法

show

chrome.infobars.show(object details, function callback)

在指定标签页中显示信息栏。当标签页导航到其他页面时信息栏会自动关闭。如果要在那之前关闭,请调用 window.close()。

参数

details ( object )

属性

tabId ( integer )

要显示信息栏的标签页标识符。

path ( string )

包含信息栏内容的 HTML 文件。

height ( optional integer )

要显示的信息栏高度(以像素为单位),如果省略则使用默认信息栏高度。

callback ( optional function )

如果您指定了 callback 参数,它应该指定一个如下形式的函数:

function(windows.Window window) {...};

window ( windows.Window )

包含已创建信息栏所在窗口的详情。