| // Copyright 2014 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": "contextMenusInternal", |
| "description": "Use the <code>chrome.contextMenus</code> API to add items to Google Chrome's context menu. You can choose what types of objects your context menu additions apply to, such as images, hyperlinks, and pages.", |
| "types": [ |
| { |
| "id": "OnClickData", |
| "type": "object", |
| "description": "Information sent when a context menu item is clicked.", |
| "properties": { |
| "menuItemId": { |
| "choices": [ |
| { "type": "integer" }, |
| { "type": "string" } |
| ], |
| "description": "The ID of the menu item that was clicked." |
| }, |
| "parentMenuItemId": { |
| "choices": [ |
| { "type": "integer" }, |
| { "type": "string" } |
| ], |
| "optional": true, |
| "description": "The parent ID, if any, for the item clicked." |
| }, |
| "mediaType": { |
| "type": "string", |
| "optional": true, |
| "description": "One of 'image', 'video', or 'audio' if the context menu was activated on one of these types of elements." |
| }, |
| "linkUrl": { |
| "type": "string", |
| "optional": true, |
| "description": "If the element is a link, the URL it points to." |
| }, |
| "srcUrl": { |
| "type": "string", |
| "optional": true, |
| "description": "Will be present for elements with a 'src' URL." |
| }, |
| "pageUrl": { |
| "type": "string", |
| "optional": true, |
| "description": "The URL of the page where the menu item was clicked. This property is not set if the click occured in a context where there is no current page, such as in a launcher context menu." |
| }, |
| "frameUrl": { |
| "type": "string", |
| "optional": true, |
| "description": " The URL of the frame of the element where the context menu was clicked, if it was in a frame." |
| }, |
| "selectionText": { |
| "type": "string", |
| "optional": true, |
| "description": "The text for the context selection, if any." |
| }, |
| "editable": { |
| "type": "boolean", |
| "description": "A flag indicating whether the element is editable (text input, textarea, etc.)." |
| }, |
| "wasChecked": { |
| "type": "boolean", |
| "optional": true, |
| "description": "A flag indicating the state of a checkbox or radio item before it was clicked." |
| }, |
| "checked": { |
| "type": "boolean", |
| "optional": true, |
| "description": "A flag indicating the state of a checkbox or radio item after it is clicked." |
| } |
| } |
| } |
| ], |
| "events": [ |
| { |
| "name": "onClicked", |
| "type": "function", |
| "description": "Fired when a context menu item is clicked.", |
| "parameters": [ |
| { |
| "name": "info", |
| "$ref": "OnClickData", |
| "description": "Information about the item clicked and the context where the click happened." |
| }, |
| { |
| "name": "tab", |
| "$ref": "tabs.Tab", |
| "description": "The details of the tab where the click took place. If the click did not take place in a tab, this parameter will be missing.", |
| "optional": true |
| } |
| ] |
| } |
| ] |
| } |
| ] |
