Home | History | Annotate | Download | only in accessibility 
      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 CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_MANAGER_ANDROID_H_
      6 #define CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_MANAGER_ANDROID_H_
      7 
      8 #include "base/android/scoped_java_ref.h"
      9 #include "content/browser/accessibility/browser_accessibility_manager.h"
     10 #include "content/browser/android/content_view_core_impl.h"
     11 
     12 namespace content {
     13 
     14 namespace aria_strings {
     15   extern const char kAriaLivePolite[];
     16   extern const char kAriaLiveAssertive[];
     17 }
     18 
     19 class CONTENT_EXPORT BrowserAccessibilityManagerAndroid
     20     : public BrowserAccessibilityManager {
     21  public:
     22   BrowserAccessibilityManagerAndroid(
     23       base::android::ScopedJavaLocalRef<jobject> content_view_core,
     24       const ui::AXTreeUpdate& initial_tree,
     25       BrowserAccessibilityDelegate* delegate,
     26       BrowserAccessibilityFactory* factory = new BrowserAccessibilityFactory());
     27 
     28   virtual ~BrowserAccessibilityManagerAndroid();
     29 
     30   static ui::AXTreeUpdate GetEmptyDocument();
     31 
     32   void SetContentViewCore(
     33       base::android::ScopedJavaLocalRef<jobject> content_view_core);
     34 
     35   // Implementation of BrowserAccessibilityManager.
     36   virtual void NotifyAccessibilityEvent(
     37       ui::AXEvent event_type, BrowserAccessibility* node) OVERRIDE;
     38 
     39   // --------------------------------------------------------------------------
     40   // Methods called from Java via JNI
     41   // --------------------------------------------------------------------------
     42 
     43   // Tree methods.
     44   jint GetRootId(JNIEnv* env, jobject obj);
     45   jboolean IsNodeValid(JNIEnv* env, jobject obj, jint id);
     46   void HitTest(JNIEnv* env, jobject obj, jint x, jint y);
     47 
     48   // Populate Java accessibility data structures with info about a node.
     49   jboolean PopulateAccessibilityNodeInfo(
     50       JNIEnv* env, jobject obj, jobject info, jint id);
     51   jboolean PopulateAccessibilityEvent(
     52       JNIEnv* env, jobject obj, jobject event, jint id, jint event_type);
     53 
     54   // Perform actions.
     55   void Click(JNIEnv* env, jobject obj, jint id);
     56   void Focus(JNIEnv* env, jobject obj, jint id);
     57   void Blur(JNIEnv* env, jobject obj);
     58   void ScrollToMakeNodeVisible(JNIEnv* env, jobject obj, int id);
     59 
     60   // Return the id of the next node in tree order in the direction given by
     61   // |forwards|, starting with |start_id|, that matches |element_type|,
     62   // where |element_type| is a special uppercase string from TalkBack or
     63   // BrailleBack indicating general categories of web content like
     64   // "SECTION" or "CONTROL".  Return 0 if not found.
     65   jint FindElementType(JNIEnv* env, jobject obj, jint start_id,
     66                        jstring element_type, jboolean forwards);
     67 
     68  protected:
     69   // AXTreeDelegate overrides.
     70   virtual void OnRootChanged(ui::AXNode* new_root) OVERRIDE;
     71 
     72   virtual bool UseRootScrollOffsetsWhenComputingBounds() OVERRIDE;
     73 
     74  private:
     75   // This gives BrowserAccessibilityManager::Create access to the class
     76   // constructor.
     77   friend class BrowserAccessibilityManager;
     78 
     79   // A weak reference to the Java BrowserAccessibilityManager object.
     80   // This avoids adding another reference to BrowserAccessibilityManager and
     81   // preventing garbage collection.
     82   // Premature garbage collection is prevented by the long-lived reference in
     83   // ContentViewCore.
     84   JavaObjectWeakGlobalRef java_ref_;
     85 
     86   // Handle a hover event from the renderer process.
     87   void HandleHoverEvent(BrowserAccessibility* node);
     88 
     89   DISALLOW_COPY_AND_ASSIGN(BrowserAccessibilityManagerAndroid);
     90 };
     91 
     92 bool RegisterBrowserAccessibilityManager(JNIEnv* env);
     93 
     94 }
     95 
     96 #endif  // CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_MANAGER_ANDROID_H_
     97