Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Merge "Clarified how to set for autofill views representing creditcard expiration dates." into oc-mr1-dev am: daf9b2ee15" into oc-mr1-dev-plus-aosp

Browse Source 
am: 606f2d1b93

Change-Id: I704f41d28f27c6c1559ab778cd49c35169995fc5
This commit is contained in:
Felipe Leme
2017-09-18 20:37:44 +00:00
committed by android-build-merger
parent 02ca638f7f 606f2d1b93
commit cbb7bc1511
1 changed files with 40 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
core/java/android/view/View.java
View File

@@ -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 =