Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d55fb27c authored by Jacky Kao's avatar Jacky Kao
Browse files

Clarify documentation for View#setScreenReaderFocusable 

Modify the document of this method, View#setScreenReaderFocusable,
To make as clear and precise as possible

Bug: 109898645
Test: Java Doc Build PASS
Change-Id: I683d420b6f1a4743d57dad9d06a343b85ec5da00
parent be0106ab

core/java/android/view/View.java

+5 −8
Original line number Diff line number Diff line
@@ -12134,14 +12134,11 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 
    }















    /**













     * When screen readers (one type of accessibility tool) decide what should be read to the













     * user, they typically look for input focusable ({@link #isFocusable()}) parents of













     * non-focusable text items, and read those focusable parents and their non-focusable children













     * as a unit. In some situations, this behavior is desirable for views that should not take













     * input focus. Setting an item to be screen reader focusable requests that the view be













     * treated as a unit by screen readers without any effect on input focusability. The default













     * value of {@code false} lets screen readers use other signals, like focusable, to determine













     * how to group items.













     * Sets whether this View should be a focusable element for screen readers













     * and include non-focusable Views from its subtree when providing feedback.













     * <p>













     * Note: this is similar to using <a href="#attr_android:focusable">{@code android:focusable},













     * but does not impact input focus behavior.















     *















     * @param screenReaderFocusable Whether the view should be treated as a unit by screen reader















     *                              accessibility tools.