Add a big grab bag of missing web accessibility functionality...

content/browser/accessibility/browser_accessibility.h

 // Copyright (c) 2011 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 CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_H_
 #define CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_H_
 #pragma once
 
 #include <map>
 #include <utility>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "build/build_config.h"
 #include "webkit/glue/webaccessibility.h"
 
 class BrowserAccessibilityManager;
 #if defined(OS_MACOSX) && __OBJC__
 @class BrowserAccessibilityCocoa;
 #elif defined(OS_WIN)
 class BrowserAccessibilityWin;
 #endif
 
 using webkit_glue::WebAccessibility;
+typedef std::map<WebAccessibility::BoolAttribute, bool> BoolAttrMap;

[Chris Guillory, 2011/08/31 02:14:53]

Optional: Attr -> Attribute

+typedef std::map<WebAccessibility::FloatAttribute, float> FloatAttrMap;
+typedef std::map<WebAccessibility::IntAttribute, int> IntAttrMap;
+typedef std::map<WebAccessibility::StringAttribute, string16> StringAttrMap;
 
 ////////////////////////////////////////////////////////////////////////////////
 //
 // BrowserAccessibility
 //
 // Class implementing the cross platform interface for the Browser-Renderer
 // communication of accessibility information, providing accessibility
 // to be used by screen readers and other assistive technology (AT).
 //
 // An implementation for each platform handles platform specific accessibility
@@ skipping 10 matching lines @@
 
   // Detach all descendants of this subtree and push all of the node pointers,
   // including this node, onto the end of |nodes|.
   virtual void DetachTree(std::vector<BrowserAccessibility*>* nodes);
 
   // Perform platform specific initialization. This can be called multiple times
   // during the lifetime of this instance after the members of this base object
   // have been reset with new values from the renderer process.
   virtual void Initialize();
 
+  // Optionally send events triggered simply by the fact that this node
+  // has been created or modified (and has been attached to the tree).
+  // This can include "show" events, "text changed" events in live regions,
+  // or "alert" events.
+  virtual void SendNodeUpdateEvents() {}
+
   // Initialize this object, reading attributes from |src|. Does not
   // recurse into children of |src| and build the whole subtree.
   void Initialize(BrowserAccessibilityManager* manager,
                   BrowserAccessibility* parent,
                   int32 child_id,
                   int32 index_in_parent,
                   const WebAccessibility& src);
 
   // Add a child of this object.
   void AddChild(BrowserAccessibility* child);
@@ skipping 57 matching lines @@
   // Subclasses should override this to support platform reference counting.
   virtual void NativeAddReference() { }
 
   // Subclasses should override this to support platform reference counting.
   virtual void NativeReleaseReference();
 
   //
   // Accessors
   //
 
-  const std::map<WebAccessibility::StringAttribute, string16>&
-  string_attributes() const {
-    return string_attributes_;
+  const BoolAttrMap& bool_attributes() const {
+    return bool_attributes_;
   }
 
-  const std::map<WebAccessibility::IntAttribute, int32>&
-  int_attributes() const {
+  const FloatAttrMap& float_attributes() const {
+    return float_attributes_;
+  }
+
+  const IntAttrMap& int_attributes() const {
     return int_attributes_;
   }
 
+  const StringAttrMap& string_attributes() const {
+    return string_attributes_;
+  }
+
   int32 child_id() const { return child_id_; }
   const std::vector<BrowserAccessibility*>& children() const {
     return children_;
   }
   const std::vector<std::pair<string16, string16> >& html_attributes() const {
     return html_attributes_;
   }
   int32 index_in_parent() const { return index_in_parent_; }
   const std::vector<int32>& indirect_child_ids() const {
     return indirect_child_ids_;
   }
   const std::vector<int32>& line_breaks() const {
     return line_breaks_;
   }
   const std::vector<int32>& cell_ids() const {
     return cell_ids_;
   }
+  const std::vector<int32>& unique_cell_ids() const {
+    return unique_cell_ids_;
+  }
   gfx::Rect location() const { return location_; }
   BrowserAccessibilityManager* manager() const { return manager_; }
   const string16& name() const { return name_; }
   int32 renderer_id() const { return renderer_id_; }
   int32 role() const { return role_; }
   const string16& role_name() const { return role_name_; }
   int32 state() const { return state_; }
   const string16& value() const { return value_; }
   bool instance_active() const { return instance_active_; }
   int32 ref_count() const { return ref_count_; }
 
 #if defined(OS_MACOSX) && __OBJC__
   BrowserAccessibilityCocoa* toBrowserAccessibilityCocoa();
 #elif defined(OS_WIN)
   BrowserAccessibilityWin* toBrowserAccessibilityWin();
 #endif
 
+  // Retrieve the value of a bool attribute from the bool attribute
+  // map and returns true if found.
+  bool GetBoolAttribute(WebAccessibility::BoolAttribute attr, bool* value)
+      const;
+
+  // Retrieve the value of a float attribute from the float attribute
+  // map and returns true if found.
+  bool GetFloatAttribute(WebAccessibility::FloatAttribute attr, float* value)
+      const;
+
+  // Retrieve the value of an integer attribute from the integer attribute
+  // map and returns true if found.
+  bool GetIntAttribute(WebAccessibility::IntAttribute attribute, int* value)
+      const;
+
   // Retrieve the value of a string attribute from the attribute map and
   // returns true if found.
   bool GetStringAttribute(WebAccessibility::StringAttribute attribute,
-                          string16* value);
+                          string16* value) const;
 
-  // Retrieve the value of an integer attribute from the integer attribute
-  // map and returns true if found.
-  bool GetIntAttribute(WebAccessibility::IntAttribute attribute, int* value);
+  // Retrieve the value of a html attribute from the attribute map and
+  // returns true if found.
+  bool GetHtmlAttribute(const char* attr, string16* value) const;
+
+  // Returns true if this node is an editable text field of any kind.
+  bool IsEditableText() const;
 
  protected:
   BrowserAccessibility();
 
   // The manager of this tree of accessibility objects; needed for
   // global operations like focus tracking.
   BrowserAccessibilityManager* manager_;
 
   // The parent of this object, may be NULL if we're the root object.
   BrowserAccessibility* parent_;
 
   // The ID of this object; globally unique within the browser process.
   int32 child_id_;
 
   // The index of this within its parent object.
   int32 index_in_parent_;
 
   // The ID of this object in the renderer process.
   int32 renderer_id_;
 
   // The children of this object.
   std::vector<BrowserAccessibility*> children_;
 
   // The number of internal references to this object.
   int32 ref_count_;
 
   // Accessibility metadata from the renderer
   string16 name_;
   string16 value_;
-  std::map<WebAccessibility::StringAttribute, string16> string_attributes_;
-  std::map<WebAccessibility::IntAttribute, int32> int_attributes_;
+  BoolAttrMap bool_attributes_;
+  IntAttrMap int_attributes_;
+  FloatAttrMap float_attributes_;
+  StringAttrMap string_attributes_;
   std::vector<std::pair<string16, string16> > html_attributes_;
   int32 role_;
   int32 state_;
   string16 role_name_;
   gfx::Rect location_;
   std::vector<int32> indirect_child_ids_;
   std::vector<int32> line_breaks_;
   std::vector<int32> cell_ids_;
+  std::vector<int32> unique_cell_ids_;
 
   // BrowserAccessibility objects are reference-counted on some platforms.
   // When we're done with this object and it's removed from our accessibility
   // tree, a client may still be holding onto a pointer to this object, so
   // we mark it as inactive so that calls to any of this object's methods
   // immediately return failure.
   bool instance_active_;
 
  private:
   DISALLOW_COPY_AND_ASSIGN(BrowserAccessibility);
 };
 
 #endif  // CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_H_