// Copyright 2013 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

[
  {
    "namespace": "infobars",
    "description": "Use the <code>chrome.infobars</code> API to add a horizontal panel just above a tab's contents. See the screenshot below.",
    "compiler_options": {
      "implemented_in": "chrome/browser/infobars/infobar_extension_api.h"
    },
    "types": [],
    "functions": [
      {
        "name": "show",
        "type": "function",
        "description": "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": [
          {
            "name": "details",
            "type": "object",
            "properties": {
              "tabId": {
                "type": "integer",
                "description": "The tab id for the tab to display the infobar in."
              },
              "path": {
                "type": "string",
                "description": "The html file that contains the infobar."
              },
              "height": {
                "type": "integer",
                "description": "The height (in pixels) of the infobar to show. If omitted, the default infobar height will be used.",
                "optional": true,
                "minimum": 0,
                "maximum": 72
              }
            }
          },
          {
            "type": "function",
            "name": "callback",
            "optional": true,
            "parameters": [
              {
                "name": "window", "$ref": "windows.Window", "description": "Contains details about the window in which the infobar was created."
              }
            ]
          }
        ]
      }
    ]
  }
]