Add sparse accessibility attribute interface to Blink

third_party/WebKit/public/web/WebAXObject.h

 /*
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 37 matching lines @@
 class WebAXObject;
 class WebNode;
 class WebDocument;
 class WebString;
 class WebURL;
 struct WebFloatRect;
 struct WebPoint;
 struct WebRect;
 struct WebSize;
 
+class BLINK_EXPORT WebAXSparseAttributeClient {
+ public:
+  WebAXSparseAttributeClient() {}
+  virtual ~WebAXSparseAttributeClient() {}
+
+  virtual void addBoolAttribute(WebAXBoolAttribute, bool) = 0;
+  virtual void addStringAttribute(WebAXStringAttribute, const WebString&) = 0;
+  virtual void addObjectAttribute(WebAXObjectAttribute, const WebAXObject&) = 0;
+  virtual void addObjectVectorAttribute(WebAXObjectVectorAttribute,
+                                        const WebVector<WebAXObject>&) = 0;
+};
+
 // An instance of this class, while kept alive, indicates that accessibility
 // should be temporarily enabled. If accessibility was enabled globally
 // (WebSettings::setAccessibilityEnabled), this will have no effect.
 class WebScopedAXContext {
  public:
   BLINK_EXPORT WebScopedAXContext(WebDocument& rootDocument);
   BLINK_EXPORT ~WebScopedAXContext();
 
   BLINK_EXPORT WebAXObject root() const;
 
@@ skipping 32 matching lines @@
   // still valid (not detached). Note that calling this method
   // can cause other WebAXObjects to become invalid, too,
   // so always call isDetached if any other WebCore code has run.
   BLINK_EXPORT bool updateLayoutAndCheckValidity();
 
   BLINK_EXPORT unsigned childCount() const;
 
   BLINK_EXPORT WebAXObject childAt(unsigned) const;
   BLINK_EXPORT WebAXObject parentObject() const;
 
+  // Retrieve accessibility attributes that apply to only a small
+  // fraction of WebAXObjects by passing an implementation of
+  // WebAXSparseAttributeClient, which will be called with only the attributes
+  // that apply to this object.
+  BLINK_EXPORT void getSparseAXAttributes(WebAXSparseAttributeClient&) const;
+
   BLINK_EXPORT bool isAnchor() const;
   BLINK_EXPORT bool isAriaReadOnly() const;
   BLINK_EXPORT bool isButtonStateMixed() const;
   BLINK_EXPORT bool isChecked() const;
   BLINK_EXPORT bool isClickable() const;
   BLINK_EXPORT bool isCollapsed() const;
   BLINK_EXPORT bool isControl() const;
   BLINK_EXPORT bool isEnabled() const;
   BLINK_EXPORT WebAXExpanded isExpanded() const;
   BLINK_EXPORT bool isFocused() const;
@@ skipping 12 matching lines @@
   BLINK_EXPORT bool isVisited() const;
 
   BLINK_EXPORT WebString accessKey() const;
   BLINK_EXPORT unsigned backgroundColor() const;
   BLINK_EXPORT unsigned color() const;
   // Deprecated.
   BLINK_EXPORT void colorValue(int& r, int& g, int& b) const;
   BLINK_EXPORT unsigned colorValue() const;
   BLINK_EXPORT WebAXObject ariaActiveDescendant() const;
   BLINK_EXPORT WebString ariaAutoComplete() const;
-  BLINK_EXPORT bool ariaControls(
-      WebVector<WebAXObject>& controlsElements) const;
   BLINK_EXPORT WebAXAriaCurrentState ariaCurrentState() const;
-  BLINK_EXPORT bool ariaFlowTo(WebVector<WebAXObject>& flowToElements) const;
   BLINK_EXPORT bool ariaHasPopup() const;
   BLINK_EXPORT bool isEditable() const;
   BLINK_EXPORT bool isMultiline() const;
   BLINK_EXPORT bool isRichlyEditable() const;
   BLINK_EXPORT bool ariaOwns(WebVector<WebAXObject>& ownsElements) const;
   BLINK_EXPORT WebString fontFamily() const;
   BLINK_EXPORT float fontSize() const;
   BLINK_EXPORT bool canvasHasFallbackContent() const;
   // If this is an image, returns the image (scaled to maxSize) as a data url.
   BLINK_EXPORT WebString imageDataUrl(const WebSize& maxSize) const;
@@ skipping 184 matching lines @@
   operator AXObject*() const;
 #endif
 
  private:
   WebPrivatePtr<AXObject> m_private;
 };
 
 }  // namespace blink
 
 #endif