You are viewing extension docs in chrome via the 'file:' scheme: are you expecting to see local changes when you refresh? You'll need run chrome with --allow-file-access-from-files.
WARNING: This is the BETA documentation. It may not work with the stable release of Chrome.
WARNING: This is unofficial documentation. It may not work with the current release of Chrome.

Google Chrome Extensions (Labs)

chrome.experimental.infobars

For information on how to use experimental APIs, see the chrome.experimental.* APIs page.

The infobars API allows you to add a horizontal panel just above a tab's contents, as the following screenshot shows.

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

Use an infobar to tell the reader something about a particular page. When the user leaves the page for which the infobar is displayed, Google Chrome automatically closes the infobar.

You implement the content of your infobar using HTML. Because infobars are ordinary pages inside an extension, they can communicate with other extension pages.

Manifest

The infobars API is currently experimental, so you must declare the "experimental" permission to use it. Also, you should specify a 16x16-pixel icon for display next to your infobar. For example:

{
  "name": "Andy's infobar extension",
  "version": "1.0",
  "permissions": ["experimental"],
  "icons": {
    "16": "16.png"
  },
  "background": {
    "scripts": ["background.js"]
  }
}

API reference: chrome.experimental.infobars

Methods

show

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

Shows an infobar in the specified tab. The infobar will be closed automatically when the tab navigates. Use window.close() to close the infobar before then.

Parameters

details
( object )
Undocumented.
tabId
( integer )
The tab id for the tab to display the infobar in.
path
( string )
The html file that contains the infobar.
height
( optional integer )
The height (in pixels) of the infobar to show. If omitted, the default infobar height will be used.
callback
( optional function )
Undocumented.

Callback function

If you specify the callback parameter, it should specify a function that looks like this:

function(Window window) {...};
window
( Window )
Contains details about the window in which the infobar was created.