Home | History | Annotate | Download | only in autofill
      1 // Copyright 2013 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_AUTOFILL_AUTOFILL_DIALOG_VIEW_DELEGATE_H_
      6 #define CHROME_BROWSER_UI_AUTOFILL_AUTOFILL_DIALOG_VIEW_DELEGATE_H_
      7 
      8 #include <vector>
      9 
     10 #include "base/strings/string16.h"
     11 #include "chrome/browser/ui/autofill/autofill_dialog_types.h"
     12 #include "components/autofill/content/browser/wallet/required_action.h"
     13 #include "components/autofill/core/browser/field_types.h"
     14 #include "ui/base/ui_base_types.h"
     15 #include "ui/gfx/image/image.h"
     16 #include "ui/gfx/native_widget_types.h"
     17 #include "ui/gfx/range/range.h"
     18 
     19 class FieldValueMap;
     20 class GURL;
     21 class Profile;
     22 
     23 namespace content {
     24 class WebContents;
     25 struct NativeWebKeyboardEvent;
     26 }
     27 
     28 namespace gfx {
     29 class Rect;
     30 }
     31 
     32 namespace ui {
     33 class ComboboxModel;
     34 class MenuModel;
     35 }
     36 
     37 namespace autofill {
     38 
     39 typedef std::map<ServerFieldType, gfx::Image> FieldIconMap;
     40 
     41 // This class defines the interface to the controller that the dialog view sees.
     42 class AutofillDialogViewDelegate {
     43  public:
     44   // Strings -------------------------------------------------------------------
     45 
     46   virtual base::string16 DialogTitle() const = 0;
     47   virtual base::string16 AccountChooserText() const = 0;
     48   virtual base::string16 SignInLinkText() const = 0;
     49   virtual base::string16 SpinnerText() const = 0;
     50   virtual base::string16 EditSuggestionText() const = 0;
     51   virtual base::string16 CancelButtonText() const = 0;
     52   virtual base::string16 ConfirmButtonText() const = 0;
     53   virtual base::string16 SaveLocallyText() const = 0;
     54   virtual base::string16 SaveLocallyTooltip() const = 0;
     55   virtual base::string16 LegalDocumentsText() = 0;
     56 
     57   // State ---------------------------------------------------------------------
     58 
     59   // Whether a loading animation should be shown (e.g. while signing in,
     60   // retreiving Wallet data, etc.).
     61   virtual bool ShouldShowSpinner() const = 0;
     62 
     63   // Whether the account chooser/sign in link control should be visible.
     64   virtual bool ShouldShowAccountChooser() const = 0;
     65 
     66   // Whether the sign in web view should be displayed.
     67   virtual bool ShouldShowSignInWebView() const = 0;
     68 
     69   // The URL to sign in to Google.
     70   virtual GURL SignInUrl() const = 0;
     71 
     72   // Whether to show the checkbox to save data locally (in Autofill).
     73   virtual bool ShouldOfferToSaveInChrome() const = 0;
     74 
     75   // Whether the checkbox to save data locally should be checked initially.
     76   virtual bool ShouldSaveInChrome() const = 0;
     77 
     78   // Returns the model for the account chooser. It will return NULL if the
     79   // account chooser should not show a menu. In this case, clicking on the
     80   // account chooser should initiate sign-in.
     81   virtual ui::MenuModel* MenuModelForAccountChooser() = 0;
     82 
     83   // Returns the icon that should be shown in the account chooser.
     84   virtual gfx::Image AccountChooserImage() = 0;
     85 
     86   // Returns the image that should be shown on the left of the button strip
     87   // or an empty image if none should be shown.
     88   virtual gfx::Image ButtonStripImage() const = 0;
     89 
     90   // Which dialog buttons should be visible.
     91   virtual int GetDialogButtons() const = 0;
     92 
     93   // Whether or not the |button| should be enabled.
     94   virtual bool IsDialogButtonEnabled(ui::DialogButton button) const = 0;
     95 
     96   // Returns a struct full of data concerning what overlay, if any, should be
     97   // displayed on top of the dialog.
     98   virtual DialogOverlayState GetDialogOverlay() = 0;
     99 
    100   // Returns ranges to linkify in the text returned by |LegalDocumentsText()|.
    101   virtual const std::vector<gfx::Range>& LegalDocumentLinks() = 0;
    102 
    103   // Detail inputs -------------------------------------------------------------
    104 
    105   // Whether the section is currently active (i.e. should be shown).
    106   virtual bool SectionIsActive(DialogSection section) const = 0;
    107 
    108   // Returns the set of inputs the page has requested which fall under
    109   // |section|.
    110   virtual const DetailInputs& RequestedFieldsForSection(DialogSection section)
    111       const = 0;
    112 
    113   // Returns the combobox model for inputs of type |type|, or NULL if the input
    114   // should be a text field.
    115   virtual ui::ComboboxModel* ComboboxModelForAutofillType(
    116       ServerFieldType type) = 0;
    117 
    118   // Returns the model for suggestions for fields that fall under |section|.
    119   // This may return NULL, in which case no menu should be shown for that
    120   // section.
    121   virtual ui::MenuModel* MenuModelForSection(DialogSection section) = 0;
    122 
    123   // Returns the label text used to describe the section (i.e. Billing).
    124   virtual base::string16 LabelForSection(DialogSection section) const = 0;
    125 
    126   // Returns the current state of suggestions for |section|.
    127   virtual SuggestionState SuggestionStateForSection(DialogSection section) = 0;
    128 
    129   // Returns the icons to be displayed along with the given |user_inputs| in a
    130   // section.
    131   virtual FieldIconMap IconsForFields(
    132       const FieldValueMap& user_inputs) const = 0;
    133 
    134   // Returns true if the value of this field |type| controls the icons for the
    135   // rest of the fields in a section.
    136   virtual bool FieldControlsIcons(ServerFieldType type) const = 0;
    137 
    138   // Returns a tooltip for the given field, or an empty string if none exists.
    139   virtual base::string16 TooltipForField(ServerFieldType type) const = 0;
    140 
    141   // Whether a particular DetailInput in |section| should be edited or not.
    142   virtual bool InputIsEditable(const DetailInput& input,
    143                                DialogSection section) = 0;
    144 
    145   // Decides whether input of |value| is valid for a field of type |type|. If
    146   // valid, the returned string will be empty. Otherwise it will contain an
    147   // error message.
    148   virtual base::string16 InputValidityMessage(DialogSection section,
    149                                         ServerFieldType type,
    150                                         const base::string16& value) = 0;
    151 
    152   // Decides whether the combination of all |inputs| is valid, returns a
    153   // map of field types to validity messages.
    154   virtual ValidityMessages InputsAreValid(DialogSection section,
    155                                           const FieldValueMap& inputs) = 0;
    156 
    157   // Called when the user edits or activates a textfield or combobox.
    158   // |was_edit| is true when the function was called in response to the user
    159   // editing the input.
    160   virtual void UserEditedOrActivatedInput(DialogSection section,
    161                                           ServerFieldType type,
    162                                           gfx::NativeView parent_view,
    163                                           const gfx::Rect& content_bounds,
    164                                           const base::string16& field_contents,
    165                                           bool was_edit) = 0;
    166 
    167   // The view forwards keypresses in text inputs. Returns true if there should
    168   // be no further processing of the event.
    169   virtual bool HandleKeyPressEventInInput(
    170       const content::NativeWebKeyboardEvent& event) = 0;
    171 
    172   // Called when focus has changed position within the view.
    173   virtual void FocusMoved() = 0;
    174 
    175   // Whether the view is allowed to show a validation error bubble.
    176   virtual bool ShouldShowErrorBubble() const = 0;
    177 
    178   // Miscellany ----------------------------------------------------------------
    179 
    180   // Called when the view has been closed.
    181   virtual void ViewClosed() = 0;
    182 
    183   // Returns dialog notifications that the view should currently be showing in
    184   // order from top to bottom.
    185   virtual std::vector<DialogNotification> CurrentNotifications() = 0;
    186 
    187   // Called when a generic link has been clicked in the dialog. Opens the URL
    188   // out-of-line.
    189   virtual void LinkClicked(const GURL& url) = 0;
    190 
    191   // Begins or aborts the flow to sign into Wallet.
    192   virtual void SignInLinkClicked() = 0;
    193 
    194   // Called when a checkbox in the notification area has changed its state.
    195   virtual void NotificationCheckboxStateChanged(DialogNotification::Type type,
    196                                                 bool checked) = 0;
    197 
    198   // A legal document link has been clicked.
    199   virtual void LegalDocumentLinkClicked(const gfx::Range& range) = 0;
    200 
    201   // Called when the view has been cancelled. Returns true if the dialog should
    202   // now close, or false to keep it open.
    203   virtual bool OnCancel() = 0;
    204 
    205   // Called when the view has been accepted. This could be to submit the payment
    206   // info or to handle a required action. Returns true if the dialog should now
    207   // close, or false to keep it open.
    208   virtual bool OnAccept() = 0;
    209 
    210   // Returns the profile for this dialog.
    211   virtual Profile* profile() = 0;
    212 
    213   // The web contents that prompted the dialog.
    214   virtual content::WebContents* GetWebContents() = 0;
    215 
    216  protected:
    217   virtual ~AutofillDialogViewDelegate();
    218 };
    219 
    220 }  // namespace autofill
    221 
    222 #endif  // CHROME_BROWSER_UI_AUTOFILL_AUTOFILL_DIALOG_VIEW_DELEGATE_H_
    223