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

Commit 8c293473 authored by Jiewen Lei's avatar Jiewen Lei Committed by Automerger Merge Worker
Browse files

Merge "Update javadoc to reflect "autofill for all apps" changes." into udc-dev am: 6ddd9681 

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/23066001



Change-Id: I140c32d576846fc52f8e13ec47518909fd837e07
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents da1fd3ea 6ddd9681

core/java/android/view/View.java

+35 −19
Original line number Diff line number Diff line
@@ -9845,10 +9845,11 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 
     *

     * <p><b>Note:</b> Setting the mode as {@link #IMPORTANT_FOR_AUTOFILL_NO} or

     * {@link #IMPORTANT_FOR_AUTOFILL_NO_EXCLUDE_DESCENDANTS} does not guarantee the view (and its

     * children) will be always be considered not important; for example, when the user explicitly

     * makes an autofill request, all views are considered important. See

     * {@link #isImportantForAutofill()} for more details about how the View's importance for

     * autofill is used.

     * children) will not be used for autofill purpose; for example, when the user explicitly

     * makes an autofill request, all views are included in the ViewStructure, and starting in

     * {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} the system uses other factors along

     * with importance to determine the autofill behavior. See {@link #isImportantForAutofill()}

     * for more details about how the View's importance for autofill is used.

     *

     * @param mode {@link #IMPORTANT_FOR_AUTOFILL_AUTO}, {@link #IMPORTANT_FOR_AUTOFILL_YES},

     * {@link #IMPORTANT_FOR_AUTOFILL_NO}, {@link #IMPORTANT_FOR_AUTOFILL_YES_EXCLUDE_DESCENDANTS},
@@ -9894,21 +9895,36 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 
     *   <li>otherwise, it returns {@code false}.

     * </ol>

     *

     * <p>When a view is considered important for autofill:

     * <ul>

     * <p> The behavior of importances depends on Android version:

     * <ol>

     *   <li>For {@link android.os.Build.VERSION_CODES#TIRAMISU} and below:

     *     <ol>

     *       <li>When a view is considered important for autofill:

     *          <ol>

     *            <li>The view might automatically trigger an autofill request when focused on.

     *   <li>The contents of the view are included in the {@link ViewStructure} used in an autofill

     *       request.

     * </ul>

     *

     * <p>On the other hand, when a view is considered not important for autofill:

     * <ul>

     *   <li>The view never automatically triggers autofill requests, but it can trigger a manual

     *       request through {@link AutofillManager#requestAutofill(View)}.

     *   <li>The contents of the view are not included in the {@link ViewStructure} used in an

     *       autofill request, unless the request has the

     *            <li>The contents of the view are included in the {@link ViewStructure} used in an

     *                autofill request.

     *          </ol>

     *        <li>On the other hand, when a view is considered not important for autofill:

     *          <ol>

     *            <li>The view never automatically triggers autofill requests, but it can trigger a

     *                manual request through {@link AutofillManager#requestAutofill(View)}.

     *            <li>The contents of the view are not included in the {@link ViewStructure} used in

     *                an autofill request, unless the request has the

     *                {@link #AUTOFILL_FLAG_INCLUDE_NOT_IMPORTANT_VIEWS} flag.

     * </ul>

     *          </ol>

     *      </ol>

     *  <li>For {@link android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE} and above:

     *    <ol>

     *      <li>The system uses importance, along with other view properties and other optimization

     *          factors, to determine if a view should trigger autofill on focus.

     *      <li>The contents of {@link #IMPORTANT_FOR_AUTOFILL_AUTO},

     *        {@link #IMPORTANT_FOR_AUTOFILL_YES}, {@link #IMPORTANT_FOR_AUTOFILL_NO},

     *        {@link #IMPORTANT_FOR_AUTOFILL_YES_EXCLUDE_DESCENDANTS}, and

     *        {@link #IMPORTANT_FOR_AUTOFILL_NO_EXCLUDE_DESCENDANTS} views will be included in the

     *        {@link ViewStructure} used in an autofill request.

     *    </ol>

     * </ol>

     *

     * @return whether the view is considered important for autofill.

     *