AutoFill: Preview form field values when the user changes the AutoFill dropdown

chrome/renderer/form_manager.h

 // Copyright (c) 2010 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.
 
 #ifndef CHROME_RENDERER_FORM_MANAGER_H_
 #define CHROME_RENDERER_FORM_MANAGER_H_
 
 #include <map>
 #include <vector>
 
@@ skipping 11 matching lines @@
 class WebFrame;
 }  // namespace WebKit
 
 // Manages the forms in a RenderView.
 class FormManager {
  public:
   // A bit field mask for form requirements.
   enum RequirementsMask {
     REQUIRE_NONE = 0x0,             // No requirements.
     REQUIRE_AUTOCOMPLETE = 0x1,     // Require that autocomplete != off.
-    REQUIRE_ELEMENTS_ENABLED = 0x2  // Require that disabled attribute is off.
+    REQUIRE_ENABLED = 0x2,          // Require that disabled attribute is off.
+    REQUIRE_EMPTY = 0x4,            // Require that the fields are empty.
   };
 
   FormManager();
   virtual ~FormManager();
 
   // Fills out a FormField object from a given WebFormControlElement.
   // If |get_value| is true, |field| will have the value set from |element|.
   static void WebFormControlElementToFormField(
       const WebKit::WebFormControlElement& element,
       bool get_value,
@@ skipping 41 matching lines @@
       RequirementsMask requirements,
       webkit_glue::FormData* form);
 
   // Fills the form represented by |form|.  |form| should have the name set to
   // the name of the form to fill out, and the number of elements and values
   // must match the number of stored elements in the form.
   // TODO(jhawkins): Is matching on name alone good enough?  It's possible to
   // store multiple forms with the same names from different frames.
   bool FillForm(const webkit_glue::FormData& form);
 
+  // Previews the form represented by |form|.  Same conditions as FillForm.
+  bool PreviewForm(const webkit_glue::FormData& form);
+
+  // Clears the placeholder values and the auto-filled background for any fields
+  // in |form| that have been previewed.
+  void ClearPreviewedForm(const webkit_glue::FormData& form);
+
   // Fills all of the forms in the cache with form data from |forms|.
   void FillForms(const std::vector<webkit_glue::FormData>& forms);
 
   // Resets the stored set of forms.
   void Reset();
 
   // Resets the forms for the specified |frame|.
   void ResetFrame(const WebKit::WebFrame* frame);
 
  private:
@@ skipping 23 matching lines @@
   // Infers corresponding label for |element| from surrounding context in the
   // DOM.  Contents of preceding <p> tag or preceding text element found in
   // the form.
   static string16 InferLabelForElement(
       const WebKit::WebFormControlElement& element);
 
   // Uses the data in |form| to find the cached FormElement.
   bool FindCachedFormElement(const webkit_glue::FormData& form,
                              FormElement** form_element);
 
-  // For each field in |form| that matches the corresponding field in the cached
-  // FormElement, |callback| is called with the actual WebFormControlElement and
-  // the FormField data from |form|. This method owns |callback|.
+  // For each field in |data| that matches the corresponding field in |form|
+  // and meets the |requirements|, |callback| is called with the actual
+  // WebFormControlElement and the FormField data from |form|. This method owns
+  // |callback|.
   void ForEachMatchingFormField(FormElement* form,
+                                RequirementsMask requirements,
                                 const webkit_glue::FormData& data,
                                 Callback* callback);
 
   // A ForEachMatchingFormField() callback that sets |field|'s value using the
-  // value in |data|.
+  // value in |data|.  This method also sets the autofill attribute, causing the
+  // background to be yellow.
   void FillFormField(WebKit::WebFormControlElement* field,
                      const webkit_glue::FormField* data);
 
+  // A ForEachMatchingFormField() callback that sets |field|'s placeholder value
+  // using the value in |data|, causing the test to be greyed-out.  This method
+  // also sets the autofill attribute, causing the background to be yellow.
+  void PreviewFormField(WebKit::WebFormControlElement* field,
+                        const webkit_glue::FormField* data);
+
   // The map of form elements.
   WebFrameFormElementMap form_elements_map_;
 
   DISALLOW_COPY_AND_ASSIGN(FormManager);
 };
 
 #endif  // CHROME_RENDERER_FORM_MANAGER_H_