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

Commit 05ceb4e0 authored by Andrew Solovay's avatar Andrew Solovay
Browse files

docs: Clarifying code snippet for View.autoFill() 

Per bug, updating code snippet to clarify that it's an example of an
implementation of the method. Oscar & Felipe, please check that I did
it right!

Also fixed a couple of HTML syntax errors while I had the file open
(badly formatted escape-characters that Chrome figured out, but other
browsers might choke on) and a spelling error.

Revised Javadoc is staged to:

http://go/dac-stage/reference/android/view/View.html#autofill(android.view.autofill.AutofillValue)

Test: make ds-docs
Bug: 38347106
Change-Id: I587a66c53fd5ebeeb6108529723d2d7a74c61cf7
parent b8e5742f

core/java/android/view/View.java

+19 −12
Original line number Diff line number Diff line
@@ -593,12 +593,12 @@ import java.util.function.Predicate; 
 * a single tag using the {@link android.R.styleable#View_tag android:tag}

 * attribute or multiple tags using the {@code <tag>} child element:

 * <pre>

 *     &ltView ...

 *     &lt;View ...

 *           android:tag="@string/mytag_value" /&gt;

 *     &ltView ...&gt;

 *         &lttag android:id="@+id/mytag"

 *     &lt;View ...&gt;

 *         &lt;tag android:id="@+id/mytag"

 *              android:value="@string/mytag_value" /&gt;

 *     &lt/View>

 *     &lt;/View>

 * </pre>

 * </p>

 * <p>
@@ -628,11 +628,11 @@ import java.util.function.Predicate; 
 * {@link android.R.styleable#Theme_colorAccent android:colorAccent} defined on

 * the inflation context's theme (e.g. the Activity theme) will be preserved.

 * <pre>

 *     &ltLinearLayout

 *     &lt;LinearLayout

 *             ...

 *             android:theme="@android:theme/ThemeOverlay.Material.Dark"&gt;

 *         &ltView ...&gt;

 *     &lt/LinearLayout&gt;

 *         &lt;View ...&gt;

 *     &lt;/LinearLayout&gt;

 * </pre>

 * </p>

 *
@@ -7516,15 +7516,22 @@ public class View implements Drawable.Callback, KeyEvent.Callback, 
     * <li>Passing the actual value to the equivalent setter in the view.

     * </ol>

     *

     * <p>For example, a text-field view would call:

     * <p>For example, a text-field view could implement the method this way:

     *

     * <pre class="prettyprint">

     * &#64;Override

     * public void autofill(AutofillValue value) {

     *   if (!value.isText() || !this.isEditable()) {

     *      return;

     *   }

     *   CharSequence text = value.getTextValue();

     *   if (text != null) {

     *     setText(text);

     *     this.setText(text);

     *   }

     * }

     * </pre>

     *

     * <p>If the value is updated asyncronously the next call to

     * <p>If the value is updated asynchronously the next call to

     * {@link AutofillManager#notifyValueChanged(View)} must happen <u>after</u> the value was

     * changed to the autofilled value. If not, the view will not be considered autofilled.

     *