chrome/browser/ui/views/extensions/extension_install_dialog_view.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_UI_VIEWS_EXTENSIONS_EXTENSION_INSTALL_DIALOG_VIEW_H_
   6 #define CHROME_BROWSER_UI_VIEWS_EXTENSIONS_EXTENSION_INSTALL_DIALOG_VIEW_H_
   7
   8 #include "chrome/browser/extensions/extension_install_prompt.h"
   9 #include "ui/gfx/animation/animation_delegate.h"
  10 #include "ui/gfx/animation/slide_animation.h"
  11 #include "ui/views/controls/button/button.h"
  12 #include "ui/views/controls/link_listener.h"
  13 #include "ui/views/view.h"
  14 #include "ui/views/window/dialog_delegate.h"
  15
  16 typedef std::vector<base::string16> PermissionDetails;
  17 class ExtensionInstallPromptShowParams;
  18 class Profile;
  19
  20 namespace content {
  21 class PageNavigator;
  22 }
  23
  24 namespace extensions {
  25 class ExperienceSamplingEvent;
  26 }
  27
  28 namespace ui {
  29 class ResourceBundle;
  30 }
  31
  32 namespace views {
  33 class GridLayout;
  34 class ImageButton;
  35 class Label;
  36 class Link;
  37 }
  38
  39 // A custom scrollable view implementation for the dialog.
  40 class CustomScrollableView : public views::View {
  41  public:
  42   CustomScrollableView();
  43   ~CustomScrollableView() override;
  44
  45  private:
  46   void Layout() override;
  47
  48   DISALLOW_COPY_AND_ASSIGN(CustomScrollableView);
  49 };
  50
  51 // Implements the extension installation dialog for TOOLKIT_VIEWS.
  52 class ExtensionInstallDialogView : public views::DialogDelegateView,
  53                                    public views::LinkListener {
  54  public:
  55   ExtensionInstallDialogView(
  56       Profile* profile,
  57       content::PageNavigator* navigator,
  58       ExtensionInstallPrompt::Delegate* delegate,
  59       scoped_refptr<ExtensionInstallPrompt::Prompt> prompt);
  60   ~ExtensionInstallDialogView() override;
  61
  62   // Returns the interior ScrollView of the dialog. This allows us to inspect
  63   // the contents of the DialogView.
  64   const views::ScrollView* scroll_view() const { return scroll_view_; }
  65
  66   // Called when one of the child elements has expanded/collapsed.
  67   void ContentsChanged();
  68
  69  private:
  70   // views::DialogDelegateView:
  71   int GetDialogButtons() const override;
  72   base::string16 GetDialogButtonLabel(ui::DialogButton button) const override;
  73   int GetDefaultDialogButton() const override;
  74   bool Cancel() override;
  75   bool Accept() override;
  76   ui::ModalType GetModalType() const override;
  77   base::string16 GetWindowTitle() const override;
  78   void Layout() override;
  79   gfx::Size GetPreferredSize() const override;
  80
  81   // views::LinkListener:
  82   void LinkClicked(views::Link* source, int event_flags) override;
  83
  84   // Initializes the dialog view, adding in permissions if they exist.
  85   void InitView();
  86
  87   // Adds permissions of |perm_type| to the dialog view if they exist.
  88   bool AddPermissions(views::GridLayout* layout,
  89                       ui::ResourceBundle& rb,
  90                       int column_set_id,
  91                       int left_column_width,
  92                       ExtensionInstallPrompt::PermissionsType perm_type);
  93
  94   // Creates a layout consisting of dialog header, extension name and icon.
  95   views::GridLayout* CreateLayout(
  96       views::View* parent,
  97       int left_column_width,
  98       int column_set_id,
  99       bool single_detail_row) const;
 100
 101   bool is_inline_install() const {
 102     return prompt_->type() == ExtensionInstallPrompt::INLINE_INSTALL_PROMPT;
 103   }
 104
 105   bool is_bundle_install() const {
 106     return prompt_->type() == ExtensionInstallPrompt::BUNDLE_INSTALL_PROMPT;
 107   }
 108
 109   bool is_external_install() const {
 110     return prompt_->type() == ExtensionInstallPrompt::EXTERNAL_INSTALL_PROMPT;
 111   }
 112
 113   // Updates the histogram that holds installation accepted/aborted data.
 114   void UpdateInstallResultHistogram(bool accepted) const;
 115
 116   Profile* profile_;
 117   content::PageNavigator* navigator_;
 118   ExtensionInstallPrompt::Delegate* delegate_;
 119   scoped_refptr<ExtensionInstallPrompt::Prompt> prompt_;
 120
 121   // The scroll view containing all the details for the dialog (including all
 122   // collapsible/expandable sections).
 123   views::ScrollView* scroll_view_;
 124
 125   // The container view for the scroll view.
 126   CustomScrollableView* scrollable_;
 127
 128   // The preferred size of the dialog.
 129   gfx::Size dialog_size_;
 130
 131   // ExperienceSampling: Track this UI event.
 132   scoped_ptr<extensions::ExperienceSamplingEvent> sampling_event_;
 133
 134   // Set to true once the user's selection has been received and the
 135   // |delegate_| has been notified.
 136   bool handled_result_;
 137
 138   DISALLOW_COPY_AND_ASSIGN(ExtensionInstallDialogView);
 139 };
 140
 141 // A simple view that prepends a view with a bullet with the help of a grid
 142 // layout.
 143 class BulletedView : public views::View {
 144  public:
 145   explicit BulletedView(views::View* view);
 146  private:
 147   DISALLOW_COPY_AND_ASSIGN(BulletedView);
 148 };
 149
 150 // A view to display text with an expandable details section.
 151 class ExpandableContainerView : public views::View,
 152                                 public views::ButtonListener,
 153                                 public views::LinkListener,
 154                                 public gfx::AnimationDelegate {
 155  public:
 156   ExpandableContainerView(ExtensionInstallDialogView* owner,
 157                           const base::string16& description,
 158                           const PermissionDetails& details,
 159                           int horizontal_space,
 160                           bool parent_bulleted);
 161   ~ExpandableContainerView() override;
 162
 163   // views::View:
 164   void ChildPreferredSizeChanged(views::View* child) override;
 165
 166   // views::ButtonListener:
 167   void ButtonPressed(views::Button* sender, const ui::Event& event) override;
 168
 169   // views::LinkListener:
 170   void LinkClicked(views::Link* source, int event_flags) override;
 171
 172   // gfx::AnimationDelegate:
 173   void AnimationProgressed(const gfx::Animation* animation) override;
 174   void AnimationEnded(const gfx::Animation* animation) override;
 175
 176  private:
 177   // A view which displays all the details of an IssueAdviceInfoEntry.
 178   class DetailsView : public views::View {
 179    public:
 180     DetailsView(int horizontal_space, bool parent_bulleted);
 181     ~DetailsView() override {}
 182
 183     // views::View:
 184     gfx::Size GetPreferredSize() const override;
 185
 186     void AddDetail(const base::string16& detail);
 187
 188     // Animates this to be a height proportional to |state|.
 189     void AnimateToState(double state);
 190
 191    private:
 192     views::GridLayout* layout_;
 193     double state_;
 194
 195     DISALLOW_COPY_AND_ASSIGN(DetailsView);
 196   };
 197
 198   // Expand/Collapse the detail section for this ExpandableContainerView.
 199   void ToggleDetailLevel();
 200
 201   // The dialog that owns |this|. It's also an ancestor in the View hierarchy.
 202   ExtensionInstallDialogView* owner_;
 203
 204   // A view for showing |issue_advice.details|.
 205   DetailsView* details_view_;
 206
 207   gfx::SlideAnimation slide_animation_;
 208
 209   // The 'more details' link shown under the heading (changes to 'hide details'
 210   // when the details section is expanded).
 211   views::Link* more_details_;
 212
 213   // The up/down arrow next to the 'more detail' link (points up/down depending
 214   // on whether the details section is expanded).
 215   views::ImageButton* arrow_toggle_;
 216
 217   // Whether the details section is expanded.
 218   bool expanded_;
 219
 220   DISALLOW_COPY_AND_ASSIGN(ExpandableContainerView);
 221 };
 222
 223 void ShowExtensionInstallDialogImpl(
 224     ExtensionInstallPromptShowParams* show_params,
 225     ExtensionInstallPrompt::Delegate* delegate,
 226     scoped_refptr<ExtensionInstallPrompt::Prompt> prompt);
 227
 228 #endif  // CHROME_BROWSER_UI_VIEWS_EXTENSIONS_EXTENSION_INSTALL_DIALOG_VIEW_H_