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 )

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