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

Commit f3d30a21 authored by Felipe Leme's avatar Felipe Leme
Browse files

Clarified how to set for autofill views representing creditcard expiration dates. 

Test: mmm -j108 frameworks/base/:doc-comment-check-docs
Fixes: 65673410

Change-Id: I0ebf452dff401d0863d841d714fc1350f73c2542
parent 0fe3b1aa

core/java/android/view/View.java

+40 −0
Original line number Diff line number Diff line
@@ -127,6 +127,7 @@ import java.lang.reflect.Method; 
import java.lang.reflect.Modifier;

import java.util.ArrayList;

import java.util.Arrays;

import java.util.Calendar;

import java.util.Collection;

import java.util.Collections;

import java.util.HashMap;
@@ -1078,6 +1079,29 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 
     * <a href="#attr_android:autofillHint"> {@code android:autofillHint}</a> (in which case the

     * value should be <code>{@value #AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE}</code>).

     *

     * <p>When annotating a view with this hint, it's recommended to use a date autofill value to

     * avoid ambiguity when the autofill service provides a value for it. To understand why a

     * value can be ambiguous, consider "April of 2020", which could be represented as either of

     * the following options:

     *

     * <ul>

     *   <li>{@code "04/2020"}

     *   <li>{@code "4/2020"}

     *   <li>{@code "2020/04"}

     *   <li>{@code "2020/4"}

     *   <li>{@code "April/2020"}

     *   <li>{@code "Apr/2020"}

     * </ul>

     *

     * <p>You define a date autofill value for the view by overriding the following methods:

     *

     * <ol>

     *   <li>{@link #getAutofillType()} to return {@link #AUTOFILL_TYPE_DATE}.

     *   <li>{@link #getAutofillValue()} to return a

     *       {@link AutofillValue#forDate(long) date autofillvalue}.

     *   <li>{@link #autofill(AutofillValue)} to expect a data autofillvalue.

     * </ol>

     *

     * <p>See {@link #setAutofillHints(String...)} for more info about autofill hints.

     */

    public static final String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE =
@@ -1090,6 +1114,22 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 
     * <a href="#attr_android:autofillHint"> {@code android:autofillHint}</a> (in which case the

     * value should be <code>{@value #AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH}</code>).

     *

     * <p>When annotating a view with this hint, it's recommended to use a text autofill value

     * whose value is the numerical representation of the month, starting on {@code 1} to avoid

     * ambiguity when the autofill service provides a value for it. To understand why a

     * value can be ambiguous, consider "January", which could be represented as either of

     *

     * <ul>

     *   <li>{@code "1"}: recommended way.

     *   <li>{@code "0"}: if following the {@link Calendar#MONTH} convention.

     *   <li>{@code "January"}: full name, in English.

     *   <li>{@code "jan"}: abbreviated name, in English.

     *   <li>{@code "Janeiro"}: full name, in another language.

     * </ul>

     *

     * <p>Another recommended approach is to use a date autofill value - see

     * {@link #AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE} for more details.

     *

     * <p>See {@link #setAutofillHints(String...)} for more info about autofill hints.

     */

    public static final String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH =