// 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.
#include "chrome/common/extensions/command.h"
#include "base/logging.h"
#include "base/strings/string_number_conversions.h"
#include "base/strings/string_split.h"
#include "base/strings/string_util.h"
#include "base/values.h"
#include "extensions/common/error_utils.h"
#include "extensions/common/extension.h"
#include "extensions/common/feature_switch.h"
#include "extensions/common/manifest_constants.h"
#include "grit/generated_resources.h"
#include "ui/base/l10n/l10n_util.h"
namespace extensions {
namespace errors = manifest_errors;
namespace keys = manifest_keys;
namespace values = manifest_values;
namespace {
static const char kMissing[] = "Missing";
static const char kCommandKeyNotSupported[] =
"Command key is not supported. Note: Ctrl means Command on Mac";
bool IsNamedCommand(const std::string& command_name) {
return command_name != values::kPageActionCommandEvent &&
command_name != values::kBrowserActionCommandEvent;
}
bool DoesRequireModifier(const std::string& accelerator) {
return accelerator != values::kKeyMediaNextTrack &&
accelerator != values::kKeyMediaPlayPause &&
accelerator != values::kKeyMediaPrevTrack &&
accelerator != values::kKeyMediaStop;
}
ui::Accelerator ParseImpl(const std::string& accelerator,
const std::string& platform_key,
int index,
bool should_parse_media_keys,
base::string16* error) {
error->clear();
if (platform_key != values::kKeybindingPlatformWin &&
platform_key != values::kKeybindingPlatformMac &&
platform_key != values::kKeybindingPlatformChromeOs &&
platform_key != values::kKeybindingPlatformLinux &&
platform_key != values::kKeybindingPlatformDefault) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBindingUnknownPlatform,
base::IntToString(index),
platform_key);
return ui::Accelerator();
}
std::vector<std::string> tokens;
base::SplitString(accelerator, '+', &tokens);
if (tokens.size() == 0 ||
(tokens.size() == 1 && DoesRequireModifier(accelerator)) ||
tokens.size() > 3) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBinding,
base::IntToString(index),
platform_key,
accelerator);
return ui::Accelerator();
}
// Now, parse it into an accelerator.
int modifiers = ui::EF_NONE;
ui::KeyboardCode key = ui::VKEY_UNKNOWN;
for (size_t i = 0; i < tokens.size(); i++) {
if (tokens[i] == values::kKeyCtrl) {
modifiers |= ui::EF_CONTROL_DOWN;
} else if (tokens[i] == values::kKeyCommand) {
if (platform_key == values::kKeybindingPlatformMac) {
// Either the developer specified Command+foo in the manifest for Mac or
// they specified Ctrl and it got normalized to Command (to get Ctrl on
// Mac the developer has to specify MacCtrl). Therefore we treat this
// as Command.
modifiers |= ui::EF_COMMAND_DOWN;
#if defined(OS_MACOSX)
} else if (platform_key == values::kKeybindingPlatformDefault) {
// If we see "Command+foo" in the Default section it can mean two
// things, depending on the platform:
// The developer specified "Ctrl+foo" for Default and it got normalized
// on Mac to "Command+foo". This is fine. Treat it as Command.
modifiers |= ui::EF_COMMAND_DOWN;
#endif
} else {
// No other platform supports Command.
key = ui::VKEY_UNKNOWN;
break;
}
} else if (tokens[i] == values::kKeyAlt) {
modifiers |= ui::EF_ALT_DOWN;
} else if (tokens[i] == values::kKeyShift) {
modifiers |= ui::EF_SHIFT_DOWN;
} else if (tokens[i].size() == 1 || // A-Z, 0-9.
tokens[i] == values::kKeyComma ||
tokens[i] == values::kKeyPeriod ||
tokens[i] == values::kKeyUp ||
tokens[i] == values::kKeyDown ||
tokens[i] == values::kKeyLeft ||
tokens[i] == values::kKeyRight ||
tokens[i] == values::kKeyIns ||
tokens[i] == values::kKeyDel ||
tokens[i] == values::kKeyHome ||
tokens[i] == values::kKeyEnd ||
tokens[i] == values::kKeyPgUp ||
tokens[i] == values::kKeyPgDwn ||
tokens[i] == values::kKeyTab ||
tokens[i] == values::kKeyMediaNextTrack ||
tokens[i] == values::kKeyMediaPlayPause ||
tokens[i] == values::kKeyMediaPrevTrack ||
tokens[i] == values::kKeyMediaStop) {
if (key != ui::VKEY_UNKNOWN) {
// Multiple key assignments.
key = ui::VKEY_UNKNOWN;
break;
}
if (tokens[i] == values::kKeyComma) {
key = ui::VKEY_OEM_COMMA;
} else if (tokens[i] == values::kKeyPeriod) {
key = ui::VKEY_OEM_PERIOD;
} else if (tokens[i] == values::kKeyUp) {
key = ui::VKEY_UP;
} else if (tokens[i] == values::kKeyDown) {
key = ui::VKEY_DOWN;
} else if (tokens[i] == values::kKeyLeft) {
key = ui::VKEY_LEFT;
} else if (tokens[i] == values::kKeyRight) {
key = ui::VKEY_RIGHT;
} else if (tokens[i] == values::kKeyIns) {
key = ui::VKEY_INSERT;
} else if (tokens[i] == values::kKeyDel) {
key = ui::VKEY_DELETE;
} else if (tokens[i] == values::kKeyHome) {
key = ui::VKEY_HOME;
} else if (tokens[i] == values::kKeyEnd) {
key = ui::VKEY_END;
} else if (tokens[i] == values::kKeyPgUp) {
key = ui::VKEY_PRIOR;
} else if (tokens[i] == values::kKeyPgDwn) {
key = ui::VKEY_NEXT;
} else if (tokens[i] == values::kKeyTab) {
key = ui::VKEY_TAB;
} else if (tokens[i] == values::kKeyMediaNextTrack &&
should_parse_media_keys) {
key = ui::VKEY_MEDIA_NEXT_TRACK;
} else if (tokens[i] == values::kKeyMediaPlayPause &&
should_parse_media_keys) {
key = ui::VKEY_MEDIA_PLAY_PAUSE;
} else if (tokens[i] == values::kKeyMediaPrevTrack &&
should_parse_media_keys) {
key = ui::VKEY_MEDIA_PREV_TRACK;
} else if (tokens[i] == values::kKeyMediaStop &&
should_parse_media_keys) {
key = ui::VKEY_MEDIA_STOP;
} else if (tokens[i].size() == 1 &&
tokens[i][0] >= 'A' && tokens[i][0] <= 'Z') {
key = static_cast<ui::KeyboardCode>(ui::VKEY_A + (tokens[i][0] - 'A'));
} else if (tokens[i].size() == 1 &&
tokens[i][0] >= '0' && tokens[i][0] <= '9') {
key = static_cast<ui::KeyboardCode>(ui::VKEY_0 + (tokens[i][0] - '0'));
} else {
key = ui::VKEY_UNKNOWN;
break;
}
} else {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBinding,
base::IntToString(index),
platform_key,
accelerator);
return ui::Accelerator();
}
}
bool command = (modifiers & ui::EF_COMMAND_DOWN) != 0;
bool ctrl = (modifiers & ui::EF_CONTROL_DOWN) != 0;
bool alt = (modifiers & ui::EF_ALT_DOWN) != 0;
bool shift = (modifiers & ui::EF_SHIFT_DOWN) != 0;
// We support Ctrl+foo, Alt+foo, Ctrl+Shift+foo, Alt+Shift+foo, but not
// Ctrl+Alt+foo and not Shift+foo either. For a more detailed reason why we
// don't support Ctrl+Alt+foo see this article:
// http://blogs.msdn.com/b/oldnewthing/archive/2004/03/29/101121.aspx.
// On Mac Command can also be used in combination with Shift or on its own,
// as a modifier.
if (key == ui::VKEY_UNKNOWN || (ctrl && alt) || (command && alt) ||
(shift && !ctrl && !alt && !command)) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBinding,
base::IntToString(index),
platform_key,
accelerator);
return ui::Accelerator();
}
if ((key == ui::VKEY_MEDIA_NEXT_TRACK ||
key == ui::VKEY_MEDIA_PREV_TRACK ||
key == ui::VKEY_MEDIA_PLAY_PAUSE ||
key == ui::VKEY_MEDIA_STOP) &&
(shift || ctrl || alt || command)) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBindingMediaKeyWithModifier,
base::IntToString(index),
platform_key,
accelerator);
return ui::Accelerator();
}
return ui::Accelerator(key, modifiers);
}
// For Mac, we convert "Ctrl" to "Command" and "MacCtrl" to "Ctrl". Other
// platforms leave the shortcut untouched.
std::string NormalizeShortcutSuggestion(const std::string& suggestion,
const std::string& platform) {
bool normalize = false;
if (platform == values::kKeybindingPlatformMac) {
normalize = true;
} else if (platform == values::kKeybindingPlatformDefault) {
#if defined(OS_MACOSX)
normalize = true;
#endif
}
if (!normalize)
return suggestion;
std::vector<std::string> tokens;
base::SplitString(suggestion, '+', &tokens);
for (size_t i = 0; i < tokens.size(); i++) {
if (tokens[i] == values::kKeyCtrl)
tokens[i] = values::kKeyCommand;
else if (tokens[i] == values::kKeyMacCtrl)
tokens[i] = values::kKeyCtrl;
}
return JoinString(tokens, '+');
}
} // namespace
Command::Command() : global_(false) {}
Command::Command(const std::string& command_name,
const base::string16& description,
const std::string& accelerator,
bool global)
: command_name_(command_name),
description_(description),
global_(global) {
base::string16 error;
accelerator_ = ParseImpl(accelerator, CommandPlatform(), 0,
IsNamedCommand(command_name), &error);
}
Command::~Command() {}
// static
std::string Command::CommandPlatform() {
#if defined(OS_WIN)
return values::kKeybindingPlatformWin;
#elif defined(OS_MACOSX)
return values::kKeybindingPlatformMac;
#elif defined(OS_CHROMEOS)
return values::kKeybindingPlatformChromeOs;
#elif defined(OS_LINUX)
return values::kKeybindingPlatformLinux;
#else
return "";
#endif
}
// static
ui::Accelerator Command::StringToAccelerator(const std::string& accelerator,
const std::string& command_name) {
base::string16 error;
ui::Accelerator parsed =
ParseImpl(accelerator, Command::CommandPlatform(), 0,
IsNamedCommand(command_name), &error);
return parsed;
}
// static
std::string Command::AcceleratorToString(const ui::Accelerator& accelerator) {
std::string shortcut;
// Ctrl and Alt are mutually exclusive.
if (accelerator.IsCtrlDown())
shortcut += values::kKeyCtrl;
else if (accelerator.IsAltDown())
shortcut += values::kKeyAlt;
if (!shortcut.empty())
shortcut += values::kKeySeparator;
if (accelerator.IsCmdDown()) {
shortcut += values::kKeyCommand;
shortcut += values::kKeySeparator;
}
if (accelerator.IsShiftDown()) {
shortcut += values::kKeyShift;
shortcut += values::kKeySeparator;
}
if (accelerator.key_code() >= ui::VKEY_0 &&
accelerator.key_code() <= ui::VKEY_9) {
shortcut += '0' + (accelerator.key_code() - ui::VKEY_0);
} else if (accelerator.key_code() >= ui::VKEY_A &&
accelerator.key_code() <= ui::VKEY_Z) {
shortcut += 'A' + (accelerator.key_code() - ui::VKEY_A);
} else {
switch (accelerator.key_code()) {
case ui::VKEY_OEM_COMMA:
shortcut += values::kKeyComma;
break;
case ui::VKEY_OEM_PERIOD:
shortcut += values::kKeyPeriod;
break;
case ui::VKEY_UP:
shortcut += values::kKeyUp;
break;
case ui::VKEY_DOWN:
shortcut += values::kKeyDown;
break;
case ui::VKEY_LEFT:
shortcut += values::kKeyLeft;
break;
case ui::VKEY_RIGHT:
shortcut += values::kKeyRight;
break;
case ui::VKEY_INSERT:
shortcut += values::kKeyIns;
break;
case ui::VKEY_DELETE:
shortcut += values::kKeyDel;
break;
case ui::VKEY_HOME:
shortcut += values::kKeyHome;
break;
case ui::VKEY_END:
shortcut += values::kKeyEnd;
break;
case ui::VKEY_PRIOR:
shortcut += values::kKeyPgUp;
break;
case ui::VKEY_NEXT:
shortcut += values::kKeyPgDwn;
break;
case ui::VKEY_TAB:
shortcut += values::kKeyTab;
break;
case ui::VKEY_MEDIA_NEXT_TRACK:
shortcut += values::kKeyMediaNextTrack;
break;
case ui::VKEY_MEDIA_PLAY_PAUSE:
shortcut += values::kKeyMediaPlayPause;
break;
case ui::VKEY_MEDIA_PREV_TRACK:
shortcut += values::kKeyMediaPrevTrack;
break;
case ui::VKEY_MEDIA_STOP:
shortcut += values::kKeyMediaStop;
break;
default:
return "";
}
}
return shortcut;
}
// static
bool Command::IsMediaKey(const ui::Accelerator& accelerator) {
if (accelerator.modifiers() != 0)
return false;
return (accelerator.key_code() == ui::VKEY_MEDIA_NEXT_TRACK ||
accelerator.key_code() == ui::VKEY_MEDIA_PREV_TRACK ||
accelerator.key_code() == ui::VKEY_MEDIA_PLAY_PAUSE ||
accelerator.key_code() == ui::VKEY_MEDIA_STOP);
}
bool Command::Parse(const base::DictionaryValue* command,
const std::string& command_name,
int index,
base::string16* error) {
DCHECK(!command_name.empty());
base::string16 description;
if (IsNamedCommand(command_name)) {
if (!command->GetString(keys::kDescription, &description) ||
description.empty()) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBindingDescription,
base::IntToString(index));
return false;
}
}
// We'll build up a map of platform-to-shortcut suggestions.
typedef std::map<const std::string, std::string> SuggestionMap;
SuggestionMap suggestions;
// First try to parse the |suggested_key| as a dictionary.
const base::DictionaryValue* suggested_key_dict;
if (command->GetDictionary(keys::kSuggestedKey, &suggested_key_dict)) {
for (base::DictionaryValue::Iterator iter(*suggested_key_dict);
!iter.IsAtEnd(); iter.Advance()) {
// For each item in the dictionary, extract the platforms specified.
std::string suggested_key_string;
if (iter.value().GetAsString(&suggested_key_string) &&
!suggested_key_string.empty()) {
// Found a platform, add it to the suggestions list.
suggestions[iter.key()] = suggested_key_string;
} else {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBinding,
base::IntToString(index),
keys::kSuggestedKey,
kMissing);
return false;
}
}
} else {
// No dictionary was found, fall back to using just a string, so developers
// don't have to specify a dictionary if they just want to use one default
// for all platforms.
std::string suggested_key_string;
if (command->GetString(keys::kSuggestedKey, &suggested_key_string) &&
!suggested_key_string.empty()) {
// If only a single string is provided, it must be default for all.
suggestions[values::kKeybindingPlatformDefault] = suggested_key_string;
} else {
suggestions[values::kKeybindingPlatformDefault] = "";
}
}
// Check if this is a global or a regular shortcut.
bool global = false;
if (FeatureSwitch::global_commands()->IsEnabled())
command->GetBoolean(keys::kGlobal, &global);
// Normalize the suggestions.
for (SuggestionMap::iterator iter = suggestions.begin();
iter != suggestions.end(); ++iter) {
// Before we normalize Ctrl to Command we must detect when the developer
// specified Command in the Default section, which will work on Mac after
// normalization but only fail on other platforms when they try it out on
// other platforms, which is not what we want.
if (iter->first == values::kKeybindingPlatformDefault &&
iter->second.find("Command+") != std::string::npos) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBinding,
base::IntToString(index),
keys::kSuggestedKey,
kCommandKeyNotSupported);
return false;
}
suggestions[iter->first] = NormalizeShortcutSuggestion(iter->second,
iter->first);
}
std::string platform = CommandPlatform();
std::string key = platform;
if (suggestions.find(key) == suggestions.end())
key = values::kKeybindingPlatformDefault;
if (suggestions.find(key) == suggestions.end()) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBindingMissingPlatform,
base::IntToString(index),
keys::kSuggestedKey,
platform);
return false; // No platform specified and no fallback. Bail.
}
// For developer convenience, we parse all the suggestions (and complain about
// errors for platforms other than the current one) but use only what we need.
std::map<const std::string, std::string>::const_iterator iter =
suggestions.begin();
for ( ; iter != suggestions.end(); ++iter) {
ui::Accelerator accelerator;
if (!iter->second.empty()) {
// Note that we pass iter->first to pretend we are on a platform we're not
// on.
accelerator = ParseImpl(iter->second, iter->first, index,
IsNamedCommand(command_name), error);
if (accelerator.key_code() == ui::VKEY_UNKNOWN) {
if (error->empty()) {
*error = ErrorUtils::FormatErrorMessageUTF16(
errors::kInvalidKeyBinding,
base::IntToString(index),
iter->first,
iter->second);
}
return false;
}
}
if (iter->first == key) {
// This platform is our platform, so grab this key.
accelerator_ = accelerator;
command_name_ = command_name;
description_ = description;
global_ = global;
}
}
return true;
}
base::DictionaryValue* Command::ToValue(const Extension* extension,
bool active) const {
base::DictionaryValue* extension_data = new base::DictionaryValue();
base::string16 command_description;
bool extension_action = false;
if (command_name() == values::kBrowserActionCommandEvent ||
command_name() == values::kPageActionCommandEvent) {
command_description =
l10n_util::GetStringUTF16(IDS_EXTENSION_COMMANDS_GENERIC_ACTIVATE);
extension_action = true;
} else {
command_description = description();
}
extension_data->SetString("description", command_description);
extension_data->SetBoolean("active", active);
extension_data->SetString("keybinding", accelerator().GetShortcutText());
extension_data->SetString("command_name", command_name());
extension_data->SetString("extension_id", extension->id());
extension_data->SetBoolean("global", global());
extension_data->SetBoolean("extension_action", extension_action);
if (FeatureSwitch::global_commands()->IsEnabled())
extension_data->SetBoolean("scope_ui_visible", true);
return extension_data;
}
} // namespace extensions