| // Copyright (c) 2012 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": "browserAction", |
| "description": "The browserAction API.", |
| "dependencies": [ "tabs" ], |
| "types": [ |
| { |
| "id": "ColorArray", |
| "type": "array", |
| "items": { |
| "type": "integer", |
| "minimum": 0, |
| "maximum": 255 |
| }, |
| "minItems": 4, |
| "maxItems": 4 |
| } |
| ], |
| "functions": [ |
| { |
| "name": "setTitle", |
| "type": "function", |
| "description": "Sets the title of the browser action. This shows up in the tooltip.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "title": { |
| "type": "string", |
| "description": "The string the browser action should display when moused over." |
| }, |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Limits the change to when a particular tab is selected. Automatically resets when the tab is closed." |
| } |
| } |
| } |
| ] |
| }, |
| { |
| "name": "getTitle", |
| "type": "function", |
| "description": "Gets the title of the browser action.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Specify the tab to get the title from. If no tab is specified, the non-tab-specific title is returned." |
| } |
| } |
| }, |
| { |
| "type": "function", |
| "name": "callback", |
| "parameters": [ |
| { |
| "name": "result", |
| "type": "string" |
| } |
| ] |
| } |
| ] |
| }, |
| { |
| "name": "setIcon", |
| "type": "function", |
| "description": "Sets the icon for the browser action. The icon can be specified either as the path to an image file or as the pixel data from a canvas element. Either the <b>path</b> or the <b>imageData</b> property must be specified.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "imageData": { |
| "type": "object", |
| "isInstanceOf": "ImageData", |
| "additionalProperties": { "type": "any" }, |
| "description": "Pixel data for an image. Must be an ImageData object (for example, from a <code>canvas</code> element).", |
| "optional": true |
| }, |
| "path": { |
| "type": "string", |
| "description": "Relative path to an image in the extension to show in the browser action.", |
| "optional": true |
| }, |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Limits the change to when a particular tab is selected. Automatically resets when the tab is closed." |
| } |
| } |
| } |
| ] |
| }, |
| { |
| "name": "setPopup", |
| "type": "function", |
| "description": "Sets the html document to be opened as a popup when the user clicks on the browser action's icon.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "minimum": 0, |
| "description": "Limits the change to when a particular tab is selected. Automatically resets when the tab is closed." |
| }, |
| "popup": { |
| "type": "string", |
| "description": "The html file to show in a popup. If set to the empty string (''), no popup is shown." |
| } |
| } |
| } |
| ] |
| }, |
| { |
| "name": "getPopup", |
| "type": "function", |
| "description": "Gets the html document set as the popup for this browser action.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Specify the tab to get the popup from. If no tab is specified, the non-tab-specific popup is returned." |
| } |
| } |
| }, |
| { |
| "type": "function", |
| "name": "callback", |
| "parameters": [ |
| { |
| "name": "result", |
| "type": "string" |
| } |
| ] |
| } |
| ] |
| }, |
| { |
| "name": "setBadgeText", |
| "type": "function", |
| "description": "Sets the badge text for the browser action. The badge is displayed on top of the icon.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "text": { |
| "type": "string", |
| "description": "Any number of characters can be passed, but only about four can fit in the space." |
| }, |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Limits the change to when a particular tab is selected. Automatically resets when the tab is closed." |
| } |
| } |
| } |
| ] |
| }, |
| { |
| "name": "getBadgeText", |
| "type": "function", |
| "description": "Gets the badge text of the browser action. If no tab is specified, the non-tab-specific badge text is returned.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Specify the tab to get the badge text from. If no tab is specified, the non-tab-specific badge text is returned." |
| } |
| } |
| }, |
| { |
| "type": "function", |
| "name": "callback", |
| "parameters": [ |
| { |
| "name": "result", |
| "type": "string" |
| } |
| ] |
| } |
| ] |
| }, |
| { |
| "name": "setBadgeBackgroundColor", |
| "type": "function", |
| "description": "Sets the background color for the badge.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "color": { |
| "description": "An array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <code>[255, 0, 0, 255]</code>. Can also be a string with a CSS value, with opaque red being <code>#FF0000</code> or <code>#F00</code>.", |
| "choices": [ |
| {"type": "string"}, |
| {"$ref": "ColorArray"} |
| ] |
| }, |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Limits the change to when a particular tab is selected. Automatically resets when the tab is closed." |
| } |
| } |
| } |
| ] |
| }, |
| { |
| "name": "getBadgeBackgroundColor", |
| "type": "function", |
| "description": "Gets the background color of the browser action.", |
| "parameters": [ |
| { |
| "name": "details", |
| "type": "object", |
| "properties": { |
| "tabId": { |
| "type": "integer", |
| "optional": true, |
| "description": "Specify the tab to get the badge background color from. If no tab is specified, the non-tab-specific badge background color is returned." |
| } |
| } |
| }, |
| { |
| "type": "function", |
| "name": "callback", |
| "parameters": [ |
| { |
| "name": "result", |
| "$ref": "ColorArray" |
| } |
| ] |
| } |
| ] |
| } |
| ], |
| "events": [ |
| { |
| "name": "onClicked", |
| "type": "function", |
| "description": "Fired when a browser action icon is clicked. This event will not fire if the browser action has a popup.", |
| "parameters": [ |
| { |
| "name": "tab", |
| "$ref": "Tab" |
| } |
| ] |
| } |
| ] |
| } |
| ] |