15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef CHROME_BROWSER_EXTENSIONS_MENU_MANAGER_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CHROME_BROWSER_EXTENSIONS_MENU_MANAGER_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <map> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <set> 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <string> 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector> 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/compiler_specific.h" 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/gtest_prod_util.h" 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/scoped_ptr.h" 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/weak_ptr.h" 185c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu#include "base/scoped_observer.h" 19868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)#include "base/strings/string16.h" 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/values.h" 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "chrome/browser/extensions/extension_icon_manager.h" 22a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles)#include "components/keyed_service/core/keyed_service.h" 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "content/public/browser/notification_observer.h" 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "content/public/browser/notification_registrar.h" 255c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu#include "extensions/browser/extension_registry_observer.h" 262a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)#include "extensions/common/url_pattern_set.h" 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class SkBitmap; 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace content { 315f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles)class BrowserContext; 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class WebContents; 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct ContextMenuParams; 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace extensions { 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Extension; 385c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liuclass ExtensionRegistry; 39f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles)class StateStore; 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Represents a menu item added by an extension. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class MenuItem { 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A list of MenuItems. 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef std::vector<MenuItem*> List; 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 47a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // Key used to identify which extension a menu item belongs to. 48a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // A menu item can also belong to a <webview> inside an extension, 49a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // only in that case |webview_instance_id| would be 50a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // non-zero (i.e. != guestview::kInstanceIDNone). 51a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) struct ExtensionKey { 52a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) std::string extension_id; 53a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) int webview_instance_id; 54a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 55a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) ExtensionKey(); 56a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) ExtensionKey(const std::string& extension_id, int webview_instance_id); 57a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) explicit ExtensionKey(const std::string& extension_id); 58a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 59a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) bool operator==(const ExtensionKey& other) const; 60a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) bool operator!=(const ExtensionKey& other) const; 61a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) bool operator<(const ExtensionKey& other) const; 62a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 63a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) bool empty() const; 64a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) }; 65a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // An Id uniquely identifies a context menu item registered by an extension. 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) struct Id { 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Id(); 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Since the unique ID (uid or string_uid) is parsed from API arguments, 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the normal usage is to set the uid or string_uid immediately after 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // construction. 72a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) Id(bool incognito, const ExtensionKey& extension_key); 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~Id(); 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool operator==(const Id& other) const; 765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool operator!=(const Id& other) const; 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool operator<(const Id& other) const; 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool incognito; 80a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) ExtensionKey extension_key; 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Only one of uid or string_uid will be defined. 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int uid; 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string string_uid; 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // For context menus, these are the contexts where an item can appear. 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) enum Context { 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ALL = 1, 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) PAGE = 2, 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SELECTION = 4, 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LINK = 8, 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) EDITABLE = 16, 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) IMAGE = 32, 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VIDEO = 64, 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) AUDIO = 128, 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FRAME = 256, 976e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles) LAUNCHER = 512, 986e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles) BROWSER_ACTION = 1024, 996e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles) PAGE_ACTION = 2048 1005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // An item can be only one of these types. 1035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) enum Type { 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NORMAL, 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CHECKBOX, 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RADIO, 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SEPARATOR 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A list of Contexts for an item. 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) class ContextList { 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ContextList() : value_(0) {} 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit ContextList(Context context) : value_(context) {} 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ContextList(const ContextList& other) : value_(other.value_) {} 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void operator=(const ContextList& other) { 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) value_ = other.value_; 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool operator==(const ContextList& other) const { 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return value_ == other.value_; 1235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool operator!=(const ContextList& other) const { 1265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return !(*this == other); 1275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool Contains(Context context) const { 1305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return (value_ & context) > 0; 1315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void Add(Context context) { 1345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) value_ |= context; 1355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 137eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch scoped_ptr<base::Value> ToValue() const { 1383551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) return scoped_ptr<base::Value>( 1393551c9c881056c480085172ff9840cab31610854Torne (Richard Coles) new base::FundamentalValue(static_cast<int>(value_))); 1405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 142eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch bool Populate(const base::Value& value) { 1435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int int_value; 1445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) if (!value.GetAsInteger(&int_value) || int_value < 0) 1455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return false; 1465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) value_ = int_value; 1475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return true; 1485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 1515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) uint32 value_; // A bitmask of Context values. 1525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 1535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) MenuItem(const Id& id, 1555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::string& title, 1565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool checked, 1575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool enabled, 1585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Type type, 1595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const ContextList& contexts); 1605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~MenuItem(); 1615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Simple accessor methods. 1635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool incognito() const { return id_.incognito; } 164a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) const std::string& extension_id() const { 165a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) return id_.extension_key.extension_id; 166a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) } 1675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const std::string& title() const { return title_; } 1685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const List& children() { return children_; } 1695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const Id& id() const { return id_; } 1705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Id* parent_id() const { return parent_id_.get(); } 1715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) int child_count() const { return children_.size(); } 1726e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles) const ContextList& contexts() const { return contexts_; } 1735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Type type() const { return type_; } 1745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool checked() const { return checked_; } 1755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool enabled() const { return enabled_; } 1765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const URLPatternSet& document_url_patterns() const { 1775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return document_url_patterns_; 1785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const URLPatternSet& target_url_patterns() const { 1805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) return target_url_patterns_; 1815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Simple mutator methods. 1845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_title(const std::string& new_title) { title_ = new_title; } 1855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_contexts(ContextList contexts) { contexts_ = contexts; } 1865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_type(Type type) { type_ = type; } 1875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_enabled(bool enabled) { enabled_ = enabled; } 1885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_document_url_patterns(const URLPatternSet& patterns) { 1895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) document_url_patterns_ = patterns; 1905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_target_url_patterns(const URLPatternSet& patterns) { 1925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) target_url_patterns_ = patterns; 1935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 1945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the title with any instances of %s replaced by |selection|. The 1965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // result will be no longer than |max_length|. 197a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) base::string16 TitleWithReplacement(const base::string16& selection, 1985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t max_length) const; 1995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sets the checked state to |checked|. Returns true if successful. 2015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool SetChecked(bool checked); 2025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Converts to Value for serialization to preferences. 2045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_ptr<base::DictionaryValue> ToValue() const; 2055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns a new MenuItem created from |value|, or NULL if there is 2075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // an error. The caller takes ownership of the MenuItem. 2085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static MenuItem* Populate(const std::string& extension_id, 209eb525c5499e34cc9c4b825d6d9e75bb07cc06aceBen Murdoch const base::DictionaryValue& value, 2105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string* error); 2115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Sets any document and target URL patterns from |properties|. 2135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool PopulateURLPatterns(std::vector<std::string>* document_url_patterns, 2145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::vector<std::string>* target_url_patterns, 2155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string* error); 2165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) protected: 2185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) friend class MenuManager; 2195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Takes ownership of |item| and sets its parent_id_. 2215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void AddChild(MenuItem* item); 2225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Takes the child item from this parent. The item is returned and the caller 2245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // then owns the pointer. 2255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) MenuItem* ReleaseChild(const Id& child_id, bool recursive); 2265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Recursively appends all descendant items (children, grandchildren, etc.) 2285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // to the output |list|. 2295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void GetFlattenedSubtree(MenuItem::List* list); 2305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Recursively removes all descendant items (children, grandchildren, etc.), 2325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // returning the ids of the removed items. 2335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::set<Id> RemoveAllDescendants(); 2345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 2365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The unique id for this item. 2375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Id id_; 2385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // What gets shown in the menu for this item. 2405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::string title_; 2415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Type type_; 2435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This should only be true for items of type CHECKBOX or RADIO. 2455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool checked_; 2465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If the item is enabled or not. 2485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool enabled_; 2495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // In what contexts should the item be shown? 2515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ContextList contexts_; 2525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If this item is a child of another item, the unique id of its parent. If 2545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // this is a top-level item with no parent, this will be NULL. 2555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_ptr<Id> parent_id_; 2565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Patterns for restricting what documents this item will appear for. This 2585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // applies to the frame where the click took place. 2595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) URLPatternSet document_url_patterns_; 2605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Patterns for restricting where items appear based on the src/href 2625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // attribute of IMAGE/AUDIO/VIDEO/LINK tags. 2635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) URLPatternSet target_url_patterns_; 2645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Any children this item may have. 2665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) List children_; 2675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(MenuItem); 2695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 2705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This class keeps track of menu items added by extensions. 2725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class MenuManager : public content::NotificationObserver, 273f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) public base::SupportsWeakPtr<MenuManager>, 2745c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu public KeyedService, 2755c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu public ExtensionRegistryObserver { 2765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 277effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch static const char kOnContextMenus[]; 278effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch static const char kOnWebviewContextMenus[]; 279effb81e5f8246d0db0270817048dc992db66e9fbBen Murdoch 2805f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) MenuManager(content::BrowserContext* context, StateStore* store_); 2815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~MenuManager(); 2825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2835f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) // Convenience function to get the MenuManager for a browser context. 2845f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) static MenuManager* Get(content::BrowserContext* context); 285f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 286a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // Returns the keys of extensions which have menu items registered. 287a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) std::set<MenuItem::ExtensionKey> ExtensionIds(); 2885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns a list of all the *top-level* menu items (added via AddContextItem) 290a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // for the given extension specified by |extension_key|, *not* including child 291a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // items (added via AddChildItem); although those can be reached via the 292a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // top-level items' children. A view can then decide how to display these, 293a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // including whether to put them into a submenu if there are more than 1. 294a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) const MenuItem::List* MenuItems(const MenuItem::ExtensionKey& extension_key); 2955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 2965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Adds a top-level menu item for an extension, requiring the |extension| 2975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // pointer so it can load the icon for the extension. Takes ownership of 2985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |item|. Returns a boolean indicating success or failure. 2995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool AddContextItem(const Extension* extension, MenuItem* item); 3005821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Add an item as a child of another item which has been previously added, and 3025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // takes ownership of |item|. Returns a boolean indicating success or failure. 3035821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool AddChildItem(const MenuItem::Id& parent_id, 3045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) MenuItem* child); 3055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Makes existing item with |child_id| a child of the item with |parent_id|. 3075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If the child item was already a child of another parent, this will remove 3085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // it from that parent first. It is an error to try and move an item to be a 3095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // child of one of its own descendants. It is legal to pass NULL for 3105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |parent_id|, which means the item should be moved to the top-level. 3115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ChangeParent(const MenuItem::Id& child_id, 3125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const MenuItem::Id* parent_id); 3135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Removes a context menu item with the given id (whether it is a top-level 3155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // item or a child of some other item), returning true if the item was found 3165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // and removed or false otherwise. 3175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool RemoveContextMenuItem(const MenuItem::Id& id); 3185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 319a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // Removes all items for the given extension specified by |extension_key|. 320a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) void RemoveAllContextItems(const MenuItem::ExtensionKey& extension_key); 3215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns the item with the given |id| or NULL. 3235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) MenuItem* GetItemById(const MenuItem::Id& id) const; 3245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Notify the MenuManager that an item has been updated not through 3265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // an explicit call into MenuManager. For example, if an item is 3275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // acquired by a call to GetItemById and changed, then this should be called. 3285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if the item was found or false otherwise. 3295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool ItemUpdated(const MenuItem::Id& id); 3305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Called when a menu item is clicked on by the user. 3325f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) void ExecuteCommand(content::BrowserContext* context, 3335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) content::WebContents* web_contents, 3345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const content::ContextMenuParams& params, 3355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const MenuItem::Id& menu_item_id); 3365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This returns a bitmap of width/height kFaviconSize, loaded either from an 3385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // entry specified in the extension's 'icon' section of the manifest, or a 3395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // default extension icon. 3405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const SkBitmap& GetIconForExtension(const std::string& extension_id); 3415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3425c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu // content::NotificationObserver implementation. 3435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Observe(int type, const content::NotificationSource& source, 3445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const content::NotificationDetails& details) OVERRIDE; 3455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3465c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu // ExtensionRegistryObserver implementation. 3475c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu virtual void OnExtensionLoaded(content::BrowserContext* browser_context, 3485c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu const Extension* extension) OVERRIDE; 3495c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu virtual void OnExtensionUnloaded( 3505c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu content::BrowserContext* browser_context, 3515c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu const Extension* extension, 3525c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu UnloadedExtensionInfo::Reason reason) OVERRIDE; 3535c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu 3545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Stores the menu items for the extension in the state storage. 355a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) void WriteToStorage(const Extension* extension, 356a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) const MenuItem::ExtensionKey& extension_key); 3575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Reads menu items for the extension from the state storage. Any invalid 3595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // items are ignored. 3605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void ReadFromStorage(const std::string& extension_id, 3615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) scoped_ptr<base::Value> value); 3625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Removes all "incognito" "split" mode context items. 3645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void RemoveAllIncognitoContextItems(); 3655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 3675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FRIEND_TEST_ALL_PREFIXES(MenuManagerTest, DeleteParent); 3685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) FRIEND_TEST_ALL_PREFIXES(MenuManagerTest, RemoveOneByOne); 3695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This is a helper function which takes care of de-selecting any other radio 3715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // items in the same group (i.e. that are adjacent in the list). 3725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void RadioItemSelected(MenuItem* item); 3735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Make sure that there is only one radio item selected at once in any run. 3755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // If there are no radio items selected, then the first item in the run 3765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // will get selected. If there are multiple radio items selected, then only 3775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the last one will get selcted. 3785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void SanitizeRadioList(const MenuItem::List& item_list); 3795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3805821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Returns true if item is a descendant of an item with id |ancestor_id|. 3815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool DescendantOf(MenuItem* item, const MenuItem::Id& ancestor_id); 3825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 383a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) // We keep items organized by mapping ExtensionKey to a list of items. 384a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles) typedef std::map<MenuItem::ExtensionKey, MenuItem::List> MenuItemMap; 3855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) MenuItemMap context_items_; 3865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This lets us make lookup by id fast. It maps id to MenuItem* for 3885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // all items the menu manager knows about, including all children of top-level 3895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // items. 3905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) std::map<MenuItem::Id, MenuItem*> items_by_id_; 3915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) content::NotificationRegistrar registrar_; 3935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 3945c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu // Listen to extension load, unloaded notifications. 3955c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu ScopedObserver<ExtensionRegistry, ExtensionRegistryObserver> 3965c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu extension_registry_observer_; 3975c02ac1a9c1b504631c0a3d2b6e737b5d738bae1Bo Liu 3985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ExtensionIconManager icon_manager_; 3995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4005f1c94371a64b3196d4be9466099bb892df9b88eTorne (Richard Coles) content::BrowserContext* browser_context_; 4015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 402f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) // Owned by ExtensionSystem. 403f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) StateStore* store_; 404f2477e01787aa58f445919b809d89e252beef54fTorne (Richard Coles) 4055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(MenuManager); 4065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 4075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace extensions 4095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 4105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // CHROME_BROWSER_EXTENSIONS_MENU_MANAGER_H_ 411