mirror of
https://github.com/material-components/material-components-android.git
synced 2026-01-20 12:01:46 +08:00
bdb25ff7e3
Move to use native android:padding attrs instead of custom boxPadding attributes for text fields. This is accomplished by creating box styles for TextInputEditText, and setting android:padding attributes in those. The TextInputLayout box styles set the appropriate TextInputEditText style on its child by wrapping the TextInputEditText style in theme overlays. This is kind of neat, since it allows for the user not to have to set a style on both the TextInputLayout and TextInputEditText - the user does not even have to know about the TextInputEditText styles with this pattern. It should also help clear up some confusion over where to set the hint and other areas of haziness between TextInputLayout and TextInputEditText. The default editTextStyle is set to the filled box style, to match the default TextInputLayout style. This change removes the box padding attributes, and it also removes the dimension resources in favor of setting them in the style to improve readability. This commit also changes TextInputEditText constructors to both use a theme attribute in the 3-arg constructor and call through to the TextInputEditText overloaded constructors rather than call the super's constructor from each. This allows the theme attribute set in the theme overlays to take effect. PiperOrigin-RevId: 198051251
2122 lines
75 KiB
Java
2122 lines
75 KiB
Java
/*
|
|
* Copyright (C) 2015 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package com.google.android.material.textfield;
|
|
|
|
import com.google.android.material.R;
|
|
|
|
import static com.google.android.material.textfield.IndicatorViewController.COUNTER_INDEX;
|
|
|
|
import android.animation.ValueAnimator;
|
|
import android.content.Context;
|
|
import android.content.res.ColorStateList;
|
|
import android.graphics.Canvas;
|
|
import android.graphics.Color;
|
|
import android.graphics.PorterDuff;
|
|
import android.graphics.Rect;
|
|
import android.graphics.RectF;
|
|
import android.graphics.Typeface;
|
|
import android.graphics.drawable.ColorDrawable;
|
|
import android.graphics.drawable.Drawable;
|
|
import android.graphics.drawable.DrawableContainer;
|
|
import android.graphics.drawable.GradientDrawable;
|
|
import android.os.Build;
|
|
import android.os.Build.VERSION;
|
|
import android.os.Build.VERSION_CODES;
|
|
import android.os.Parcel;
|
|
import android.os.Parcelable;
|
|
import android.support.annotation.ColorInt;
|
|
import android.support.annotation.ColorRes;
|
|
import android.support.annotation.DimenRes;
|
|
import android.support.annotation.DrawableRes;
|
|
import android.support.annotation.IntDef;
|
|
import android.support.annotation.NonNull;
|
|
import android.support.annotation.Nullable;
|
|
import android.support.annotation.StringRes;
|
|
import android.support.annotation.StyleRes;
|
|
import android.support.annotation.VisibleForTesting;
|
|
import com.google.android.material.animation.AnimationUtils;
|
|
import com.google.android.material.internal.CheckableImageButton;
|
|
import com.google.android.material.internal.CollapsingTextHelper;
|
|
import com.google.android.material.internal.DescendantOffsetUtils;
|
|
import com.google.android.material.internal.DrawableUtils;
|
|
import com.google.android.material.internal.ThemeEnforcement;
|
|
import com.google.android.material.internal.ViewUtils;
|
|
import android.support.v4.content.ContextCompat;
|
|
import android.support.v4.graphics.drawable.DrawableCompat;
|
|
import android.support.v4.view.AbsSavedState;
|
|
import android.support.v4.view.AccessibilityDelegateCompat;
|
|
import android.support.v4.view.GravityCompat;
|
|
import android.support.v4.view.ViewCompat;
|
|
import android.support.v4.view.accessibility.AccessibilityNodeInfoCompat;
|
|
import android.support.v4.widget.TextViewCompat;
|
|
import android.support.v7.content.res.AppCompatResources;
|
|
import android.support.v7.widget.AppCompatDrawableManager;
|
|
import android.support.v7.widget.AppCompatTextView;
|
|
import android.support.v7.widget.TintTypedArray;
|
|
import android.text.Editable;
|
|
import android.text.TextUtils;
|
|
import android.text.TextWatcher;
|
|
import android.text.method.PasswordTransformationMethod;
|
|
import android.util.AttributeSet;
|
|
import android.util.Log;
|
|
import android.util.SparseArray;
|
|
import android.view.Gravity;
|
|
import android.view.LayoutInflater;
|
|
import android.view.View;
|
|
import android.view.ViewGroup;
|
|
import android.view.ViewStructure;
|
|
import android.view.accessibility.AccessibilityEvent;
|
|
import android.widget.EditText;
|
|
import android.widget.FrameLayout;
|
|
import android.widget.LinearLayout;
|
|
import android.widget.TextView;
|
|
import java.lang.annotation.Retention;
|
|
import java.lang.annotation.RetentionPolicy;
|
|
|
|
/**
|
|
* Layout which wraps an {@link android.widget.EditText} (or descendant) to show a floating label
|
|
* when the hint is hidden while the user inputs text.
|
|
*
|
|
* <p>Also supports:
|
|
*
|
|
* <ul>
|
|
* <li>Showing an error via {@link #setErrorEnabled(boolean)} and {@link #setError(CharSequence)}
|
|
* <li>Showing helper text via {@link #setHelperTextEnabled(boolean)} and {@link
|
|
* #setHelperText(CharSequence)}
|
|
* <li>Showing a character counter via {@link #setCounterEnabled(boolean)} and {@link
|
|
* #setCounterMaxLength(int)}
|
|
* <li>Password visibility toggling via the {@link #setPasswordVisibilityToggleEnabled(boolean)}
|
|
* API and related attribute. If enabled, a button is displayed to toggle between the password
|
|
* being displayed as plain-text or disguised, when your EditText is set to display a
|
|
* password.
|
|
* <p><strong>Note:</strong> When using the password toggle functionality, the 'end' compound
|
|
* drawable of the EditText will be overridden while the toggle is enabled. To ensure that any
|
|
* existing drawables are restored correctly, you should set those compound drawables
|
|
* relatively (start/end), opposed to absolutely (left/right).
|
|
* </ul>
|
|
*
|
|
* <p>The {@link TextInputEditText} class is provided to be used as a child of this layout. Using
|
|
* TextInputEditText allows TextInputLayout greater control over the visual aspects of any text
|
|
* input. An example usage is as so:
|
|
*
|
|
* <pre>
|
|
* <com.google.android.material.textfield.TextInputLayout
|
|
* android:layout_width="match_parent"
|
|
* android:layout_height="wrap_content"
|
|
* android:hint="@string/form_username">
|
|
*
|
|
* <com.google.android.material.textfield.TextInputEditText
|
|
* android:layout_width="match_parent"
|
|
* android:layout_height="wrap_content"/>
|
|
*
|
|
* </com.google.android.material.textfield.TextInputLayout>
|
|
* </pre>
|
|
*
|
|
* <p><strong>Note:</strong> The actual view hierarchy present under TextInputLayout is
|
|
* <strong>NOT</strong> guaranteed to match the view hierarchy as written in XML. As a result, calls
|
|
* to getParent() on children of the TextInputLayout -- such as an TextInputEditText -- may not
|
|
* return the TextInputLayout itself, but rather an intermediate View. If you need to access a View
|
|
* directly, set an {@code android:id} and use {@link View#findViewById(int)}.
|
|
*/
|
|
public class TextInputLayout extends LinearLayout {
|
|
|
|
/** Duration for the label's scale up and down animations. */
|
|
private static final int LABEL_SCALE_ANIMATION_DURATION = 167;
|
|
|
|
private static final int INVALID_MAX_LENGTH = -1;
|
|
|
|
private static final String LOG_TAG = "TextInputLayout";
|
|
|
|
private final FrameLayout inputFrame;
|
|
EditText editText;
|
|
private CharSequence originalHint;
|
|
|
|
private final IndicatorViewController indicatorViewController = new IndicatorViewController(this);
|
|
|
|
boolean counterEnabled;
|
|
private int counterMaxLength;
|
|
private boolean counterOverflowed;
|
|
private TextView counterView;
|
|
private final int counterOverflowTextAppearance;
|
|
private final int counterTextAppearance;
|
|
|
|
private boolean hintEnabled;
|
|
private CharSequence hint;
|
|
|
|
/**
|
|
* {@code true} when providing a hint on behalf of a child {@link EditText}. If the child is an
|
|
* instance of {@link TextInputEditText}, this value defines the behavior of its {@link
|
|
* TextInputEditText#getHint()} method.
|
|
*/
|
|
private boolean isProvidingHint;
|
|
|
|
private GradientDrawable boxBackground;
|
|
private final int boxBottomOffsetPx;
|
|
private final int boxLabelCutoutPaddingPx;
|
|
@BoxBackgroundMode private int boxBackgroundMode;
|
|
private final int boxCollapsedPaddingTopPx;
|
|
private float boxCornerRadiusTopStart;
|
|
private float boxCornerRadiusTopEnd;
|
|
private float boxCornerRadiusBottomEnd;
|
|
private float boxCornerRadiusBottomStart;
|
|
private int boxStrokeWidthPx;
|
|
private final int boxStrokeWidthDefaultPx;
|
|
private final int boxStrokeWidthFocusedPx;
|
|
@ColorInt private int boxStrokeColor;
|
|
@ColorInt private int boxBackgroundColor;
|
|
private Drawable editTextOriginalDrawable;
|
|
|
|
/**
|
|
* Values for box background mode. There is either a filled background, an outline background, or
|
|
* no background.
|
|
*/
|
|
@IntDef({BOX_BACKGROUND_NONE, BOX_BACKGROUND_FILLED, BOX_BACKGROUND_OUTLINE})
|
|
@Retention(RetentionPolicy.SOURCE)
|
|
public @interface BoxBackgroundMode {}
|
|
|
|
public static final int BOX_BACKGROUND_NONE = 0;
|
|
public static final int BOX_BACKGROUND_FILLED = 1;
|
|
public static final int BOX_BACKGROUND_OUTLINE = 2;
|
|
|
|
private final Rect tmpRect = new Rect();
|
|
private final RectF tmpRectF = new RectF();
|
|
private Typeface typeface;
|
|
|
|
private boolean passwordToggleEnabled;
|
|
private Drawable passwordToggleDrawable;
|
|
private CharSequence passwordToggleContentDesc;
|
|
private CheckableImageButton passwordToggleView;
|
|
private boolean passwordToggledVisible;
|
|
private Drawable passwordToggleDummyDrawable;
|
|
private Drawable originalEditTextEndDrawable;
|
|
|
|
private ColorStateList passwordToggleTintList;
|
|
private boolean hasPasswordToggleTintList;
|
|
private PorterDuff.Mode passwordToggleTintMode;
|
|
private boolean hasPasswordToggleTintMode;
|
|
|
|
private ColorStateList defaultHintTextColor;
|
|
private ColorStateList focusedTextColor;
|
|
|
|
@ColorInt private final int defaultStrokeColor;
|
|
@ColorInt private final int hoveredStrokeColor;
|
|
@ColorInt private int focusedStrokeColor;
|
|
|
|
@ColorInt private final int disabledColor;
|
|
|
|
// Only used for testing
|
|
private boolean hintExpanded;
|
|
|
|
final CollapsingTextHelper collapsingTextHelper = new CollapsingTextHelper(this);
|
|
|
|
private boolean hintAnimationEnabled;
|
|
private ValueAnimator animator;
|
|
|
|
private boolean hasReconstructedEditTextBackground;
|
|
private boolean inDrawableStateChanged;
|
|
|
|
private boolean restoringSavedState;
|
|
|
|
public TextInputLayout(Context context) {
|
|
this(context, null);
|
|
}
|
|
|
|
public TextInputLayout(Context context, AttributeSet attrs) {
|
|
this(context, attrs, R.attr.textInputStyle);
|
|
}
|
|
|
|
public TextInputLayout(Context context, AttributeSet attrs, int defStyleAttr) {
|
|
super(context, attrs, defStyleAttr);
|
|
|
|
setOrientation(VERTICAL);
|
|
setWillNotDraw(false);
|
|
setAddStatesFromChildren(true);
|
|
|
|
inputFrame = new FrameLayout(context);
|
|
inputFrame.setAddStatesFromChildren(true);
|
|
addView(inputFrame);
|
|
|
|
collapsingTextHelper.setTextSizeInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
|
|
collapsingTextHelper.setPositionInterpolator(AnimationUtils.LINEAR_INTERPOLATOR);
|
|
collapsingTextHelper.setCollapsedTextGravity(Gravity.TOP | GravityCompat.START);
|
|
|
|
final TintTypedArray a =
|
|
ThemeEnforcement.obtainTintedStyledAttributes(
|
|
context,
|
|
attrs,
|
|
R.styleable.TextInputLayout,
|
|
defStyleAttr,
|
|
R.style.Widget_Design_TextInputLayout);
|
|
|
|
hintEnabled = a.getBoolean(R.styleable.TextInputLayout_hintEnabled, true);
|
|
setHint(a.getText(R.styleable.TextInputLayout_android_hint));
|
|
hintAnimationEnabled = a.getBoolean(R.styleable.TextInputLayout_hintAnimationEnabled, true);
|
|
|
|
boxBottomOffsetPx =
|
|
context.getResources().getDimensionPixelOffset(R.dimen.mtrl_textinput_box_bottom_offset);
|
|
boxLabelCutoutPaddingPx =
|
|
context
|
|
.getResources()
|
|
.getDimensionPixelOffset(R.dimen.mtrl_textinput_box_label_cutout_padding);
|
|
|
|
boxCollapsedPaddingTopPx =
|
|
a.getDimensionPixelOffset(R.styleable.TextInputLayout_boxCollapsedPaddingTop, 0);
|
|
boxCornerRadiusTopStart =
|
|
a.getDimension(R.styleable.TextInputLayout_boxCornerRadiusTopStart, 0f);
|
|
boxCornerRadiusTopEnd = a.getDimension(R.styleable.TextInputLayout_boxCornerRadiusTopEnd, 0f);
|
|
boxCornerRadiusBottomEnd =
|
|
a.getDimension(R.styleable.TextInputLayout_boxCornerRadiusBottomEnd, 0f);
|
|
boxCornerRadiusBottomStart =
|
|
a.getDimension(R.styleable.TextInputLayout_boxCornerRadiusBottomStart, 0f);
|
|
|
|
boxBackgroundColor =
|
|
a.getColor(R.styleable.TextInputLayout_boxBackgroundColor, Color.TRANSPARENT);
|
|
|
|
focusedStrokeColor = a.getColor(R.styleable.TextInputLayout_boxStrokeColor, Color.TRANSPARENT);
|
|
boxStrokeWidthDefaultPx =
|
|
context
|
|
.getResources()
|
|
.getDimensionPixelSize(R.dimen.mtrl_textinput_box_stroke_width_default);
|
|
boxStrokeWidthFocusedPx =
|
|
context
|
|
.getResources()
|
|
.getDimensionPixelSize(R.dimen.mtrl_textinput_box_stroke_width_focused);
|
|
boxStrokeWidthPx = boxStrokeWidthDefaultPx;
|
|
|
|
@BoxBackgroundMode
|
|
final int boxBackgroundMode =
|
|
a.getInt(R.styleable.TextInputLayout_boxBackgroundMode, BOX_BACKGROUND_NONE);
|
|
setBoxBackgroundMode(boxBackgroundMode);
|
|
if (a.hasValue(R.styleable.TextInputLayout_android_textColorHint)) {
|
|
defaultHintTextColor =
|
|
focusedTextColor = a.getColorStateList(R.styleable.TextInputLayout_android_textColorHint);
|
|
}
|
|
defaultStrokeColor =
|
|
ContextCompat.getColor(context, R.color.mtrl_textinput_default_box_stroke_color);
|
|
disabledColor = ContextCompat.getColor(context, R.color.mtrl_textinput_disabled_color);
|
|
hoveredStrokeColor =
|
|
ContextCompat.getColor(context, R.color.mtrl_textinput_hovered_box_stroke_color);
|
|
|
|
final int hintAppearance = a.getResourceId(R.styleable.TextInputLayout_hintTextAppearance, -1);
|
|
if (hintAppearance != -1) {
|
|
setHintTextAppearance(a.getResourceId(R.styleable.TextInputLayout_hintTextAppearance, 0));
|
|
}
|
|
|
|
final int mErrorTextAppearance =
|
|
a.getResourceId(R.styleable.TextInputLayout_errorTextAppearance, 0);
|
|
final boolean errorEnabled = a.getBoolean(R.styleable.TextInputLayout_errorEnabled, false);
|
|
|
|
final int mHelperTextTextAppearance =
|
|
a.getResourceId(R.styleable.TextInputLayout_helperTextTextAppearance, 0);
|
|
final boolean helperTextEnabled =
|
|
a.getBoolean(R.styleable.TextInputLayout_helperTextEnabled, false);
|
|
final CharSequence helperText = a.getText(R.styleable.TextInputLayout_helperText);
|
|
|
|
final boolean counterEnabled = a.getBoolean(R.styleable.TextInputLayout_counterEnabled, false);
|
|
setCounterMaxLength(a.getInt(R.styleable.TextInputLayout_counterMaxLength, INVALID_MAX_LENGTH));
|
|
counterTextAppearance = a.getResourceId(R.styleable.TextInputLayout_counterTextAppearance, 0);
|
|
counterOverflowTextAppearance =
|
|
a.getResourceId(R.styleable.TextInputLayout_counterOverflowTextAppearance, 0);
|
|
|
|
passwordToggleEnabled = a.getBoolean(R.styleable.TextInputLayout_passwordToggleEnabled, false);
|
|
passwordToggleDrawable = a.getDrawable(R.styleable.TextInputLayout_passwordToggleDrawable);
|
|
passwordToggleContentDesc =
|
|
a.getText(R.styleable.TextInputLayout_passwordToggleContentDescription);
|
|
if (a.hasValue(R.styleable.TextInputLayout_passwordToggleTint)) {
|
|
hasPasswordToggleTintList = true;
|
|
passwordToggleTintList = a.getColorStateList(R.styleable.TextInputLayout_passwordToggleTint);
|
|
}
|
|
if (a.hasValue(R.styleable.TextInputLayout_passwordToggleTintMode)) {
|
|
hasPasswordToggleTintMode = true;
|
|
passwordToggleTintMode =
|
|
ViewUtils.parseTintMode(
|
|
a.getInt(R.styleable.TextInputLayout_passwordToggleTintMode, -1), null);
|
|
}
|
|
|
|
a.recycle();
|
|
|
|
setHelperTextEnabled(helperTextEnabled);
|
|
setHelperText(helperText);
|
|
setHelperTextTextAppearance(mHelperTextTextAppearance);
|
|
setErrorEnabled(errorEnabled);
|
|
setErrorTextAppearance(mErrorTextAppearance);
|
|
setCounterEnabled(counterEnabled);
|
|
|
|
applyPasswordToggleTint();
|
|
|
|
// For accessibility, consider TextInputLayout itself to be a simple container for an EditText,
|
|
// and do not expose it to accessibility services.
|
|
ViewCompat.setImportantForAccessibility(this, ViewCompat.IMPORTANT_FOR_ACCESSIBILITY_NO);
|
|
}
|
|
|
|
@Override
|
|
public void addView(View child, int index, final ViewGroup.LayoutParams params) {
|
|
if (child instanceof EditText) {
|
|
// Make sure that the EditText is vertically at the bottom, so that it sits on the
|
|
// EditText's underline
|
|
FrameLayout.LayoutParams flp = new FrameLayout.LayoutParams(params);
|
|
flp.gravity = Gravity.CENTER_VERTICAL | (flp.gravity & ~Gravity.VERTICAL_GRAVITY_MASK);
|
|
inputFrame.addView(child, flp);
|
|
|
|
// Now use the EditText's LayoutParams as our own and update them to make enough space
|
|
// for the label
|
|
inputFrame.setLayoutParams(params);
|
|
updateInputLayoutMargins();
|
|
|
|
setEditText((EditText) child);
|
|
} else {
|
|
// Carry on adding the View...
|
|
super.addView(child, index, params);
|
|
}
|
|
}
|
|
|
|
@NonNull
|
|
private Drawable getBoxBackground() {
|
|
if (boxBackgroundMode == BOX_BACKGROUND_FILLED || boxBackgroundMode == BOX_BACKGROUND_OUTLINE) {
|
|
return boxBackground;
|
|
}
|
|
throw new IllegalStateException();
|
|
}
|
|
|
|
/**
|
|
* Set the mode for the box's background (filled, outline, or none).
|
|
*
|
|
* @param boxBackgroundMode the box's background mode.
|
|
*/
|
|
public void setBoxBackgroundMode(@BoxBackgroundMode int boxBackgroundMode) {
|
|
if (boxBackgroundMode == this.boxBackgroundMode) {
|
|
return;
|
|
}
|
|
this.boxBackgroundMode = boxBackgroundMode;
|
|
onApplyBoxBackgroundMode();
|
|
}
|
|
|
|
private void onApplyBoxBackgroundMode() {
|
|
assignBoxBackgroundByMode();
|
|
if (boxBackgroundMode != BOX_BACKGROUND_NONE) {
|
|
updateInputLayoutMargins();
|
|
}
|
|
updateTextInputBoxBounds();
|
|
}
|
|
|
|
private void assignBoxBackgroundByMode() {
|
|
if (boxBackgroundMode == BOX_BACKGROUND_NONE) {
|
|
boxBackground = null;
|
|
} else if (boxBackgroundMode == BOX_BACKGROUND_OUTLINE
|
|
&& hintEnabled
|
|
&& !(boxBackground instanceof CutoutDrawable)) {
|
|
// Make boxBackground a CutoutDrawable if in outline mode, there is a hint, and
|
|
// boxBackground isn't already a CutoutDrawable.
|
|
boxBackground = new CutoutDrawable();
|
|
} else if (!(boxBackground instanceof GradientDrawable)) {
|
|
// Otherwise, make boxBackground a GradientDrawable if it isn't already.
|
|
boxBackground = new GradientDrawable();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set the outline box's stroke color.
|
|
*
|
|
* <p>Calling this method when not in outline box mode will do nothing.
|
|
*
|
|
* @param boxStrokeColor the color to use for the box's stroke
|
|
* @see #getBoxStrokeColor()
|
|
*/
|
|
public void setBoxStrokeColor(@ColorInt int boxStrokeColor) {
|
|
if (focusedStrokeColor != boxStrokeColor) {
|
|
focusedStrokeColor = boxStrokeColor;
|
|
updateTextInputBoxState();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the box's stroke color.
|
|
*
|
|
* @return the color used for the box's stroke
|
|
* @see #setBoxStrokeColor(int)
|
|
*/
|
|
public int getBoxStrokeColor() {
|
|
return focusedStrokeColor;
|
|
}
|
|
|
|
/**
|
|
* Set the resource used for the filled box's background color.
|
|
*
|
|
* @param boxBackgroundColorId the resource to use for the box's background color
|
|
*/
|
|
public void setBoxBackgroundColorResource(@ColorRes int boxBackgroundColorId) {
|
|
setBoxBackgroundColor(ContextCompat.getColor(getContext(), boxBackgroundColorId));
|
|
}
|
|
|
|
/**
|
|
* Set the filled box's background color.
|
|
*
|
|
* @param boxBackgroundColor the color to use for the filled box's background
|
|
* @see #getBoxBackgroundColor()
|
|
*/
|
|
public void setBoxBackgroundColor(@ColorInt int boxBackgroundColor) {
|
|
if (this.boxBackgroundColor != boxBackgroundColor) {
|
|
this.boxBackgroundColor = boxBackgroundColor;
|
|
applyBoxAttributes();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the box's background color.
|
|
*
|
|
* @return the color used for the box's background
|
|
* @see #setBoxBackgroundColor(int)
|
|
*/
|
|
public int getBoxBackgroundColor() {
|
|
return boxBackgroundColor;
|
|
}
|
|
|
|
/**
|
|
* Set the resources used for the box's corner radii.
|
|
*
|
|
* @param boxCornerRadiusTopStartId the resource to use for the box's top start corner radius
|
|
* @param boxCornerRadiusTopEndId the resource to use for the box's top end corner radius
|
|
* @param boxCornerRadiusBottomEndId the resource to use for the box's bottom end corner radius
|
|
* @param boxCornerRadiusBottomStartId the resource to use for the box's bottom start corner
|
|
* radius
|
|
*/
|
|
public void setBoxCornerRadiiResources(
|
|
@DimenRes int boxCornerRadiusTopStartId,
|
|
@DimenRes int boxCornerRadiusTopEndId,
|
|
@DimenRes int boxCornerRadiusBottomEndId,
|
|
@DimenRes int boxCornerRadiusBottomStartId) {
|
|
setBoxCornerRadii(
|
|
getContext().getResources().getDimension(boxCornerRadiusTopStartId),
|
|
getContext().getResources().getDimension(boxCornerRadiusTopEndId),
|
|
getContext().getResources().getDimension(boxCornerRadiusBottomEndId),
|
|
getContext().getResources().getDimension(boxCornerRadiusBottomStartId));
|
|
}
|
|
|
|
/**
|
|
* Set the box's corner radii.
|
|
*
|
|
* @param boxCornerRadiusTopStart the value to use for the box's top start corner radius
|
|
* @param boxCornerRadiusTopEnd the value to use for the box's top end corner radius
|
|
* @param boxCornerRadiusBottomEnd the value to use for the box's bottom end corner radius
|
|
* @param boxCornerRadiusBottomStart the value to use for the box's bottom start corner radius
|
|
* @see #getBoxCornerRadiusTopStart()
|
|
* @see #getBoxCornerRadiusTopEnd()
|
|
* @see #getBoxCornerRadiusBottomEnd()
|
|
* @see #getBoxCornerRadiusBottomStart()
|
|
*/
|
|
public void setBoxCornerRadii(
|
|
float boxCornerRadiusTopStart,
|
|
float boxCornerRadiusTopEnd,
|
|
float boxCornerRadiusBottomStart,
|
|
float boxCornerRadiusBottomEnd) {
|
|
if (this.boxCornerRadiusTopStart != boxCornerRadiusTopStart
|
|
|| this.boxCornerRadiusTopEnd != boxCornerRadiusTopEnd
|
|
|| this.boxCornerRadiusBottomEnd != boxCornerRadiusBottomEnd
|
|
|| this.boxCornerRadiusBottomStart != boxCornerRadiusBottomStart) {
|
|
this.boxCornerRadiusTopStart = boxCornerRadiusTopStart;
|
|
this.boxCornerRadiusTopEnd = boxCornerRadiusTopEnd;
|
|
this.boxCornerRadiusBottomEnd = boxCornerRadiusBottomEnd;
|
|
this.boxCornerRadiusBottomStart = boxCornerRadiusBottomStart;
|
|
applyBoxAttributes();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the box's top start corner radius.
|
|
*
|
|
* @return the value used for the box's top start corner radius
|
|
* @see #setBoxCornerRadii(float, float, float, float)
|
|
*/
|
|
public float getBoxCornerRadiusTopStart() {
|
|
return boxCornerRadiusTopStart;
|
|
}
|
|
|
|
/**
|
|
* Returns the box's top end corner radius.
|
|
*
|
|
* @return the value used for the box's top end corner radius
|
|
* @see #setBoxCornerRadii(float, float, float, float)
|
|
*/
|
|
public float getBoxCornerRadiusTopEnd() {
|
|
return boxCornerRadiusTopEnd;
|
|
}
|
|
|
|
/**
|
|
* Returns the box's bottom end corner radius.
|
|
*
|
|
* @return the value used for the box's bottom end corner radius
|
|
* @see #setBoxCornerRadii(float, float, float, float)
|
|
*/
|
|
public float getBoxCornerRadiusBottomEnd() {
|
|
return boxCornerRadiusBottomEnd;
|
|
}
|
|
|
|
/**
|
|
* Returns the box's bottom start corner radius.
|
|
*
|
|
* @return the value used for the box's bottom start corner radius
|
|
* @see #setBoxCornerRadii(float, float, float, float)
|
|
*/
|
|
public float getBoxCornerRadiusBottomStart() {
|
|
return boxCornerRadiusBottomStart;
|
|
}
|
|
|
|
private float[] getCornerRadiiAsArray() {
|
|
if (!ViewUtils.isLayoutRtl(this)) {
|
|
return new float[] {
|
|
boxCornerRadiusTopStart,
|
|
boxCornerRadiusTopStart,
|
|
boxCornerRadiusTopEnd,
|
|
boxCornerRadiusTopEnd,
|
|
boxCornerRadiusBottomEnd,
|
|
boxCornerRadiusBottomEnd,
|
|
boxCornerRadiusBottomStart,
|
|
boxCornerRadiusBottomStart,
|
|
};
|
|
} else {
|
|
return new float[] {
|
|
boxCornerRadiusTopEnd,
|
|
boxCornerRadiusTopEnd,
|
|
boxCornerRadiusTopStart,
|
|
boxCornerRadiusTopStart,
|
|
boxCornerRadiusBottomStart,
|
|
boxCornerRadiusBottomStart,
|
|
boxCornerRadiusBottomEnd,
|
|
boxCornerRadiusBottomEnd
|
|
};
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set the typeface to use for the hint and any label views (such as counter and error views).
|
|
*
|
|
* @param typeface typeface to use, or {@code null} to use the default.
|
|
*/
|
|
@SuppressWarnings("ReferenceEquality") // Matches the Typeface comparison in TextView
|
|
public void setTypeface(@Nullable Typeface typeface) {
|
|
if (typeface != this.typeface) {
|
|
this.typeface = typeface;
|
|
|
|
collapsingTextHelper.setTypefaces(typeface);
|
|
indicatorViewController.setTypefaces(typeface);
|
|
|
|
if (counterView != null) {
|
|
counterView.setTypeface(typeface);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the typeface used for the hint and any label views (such as counter and error views).
|
|
*/
|
|
@Nullable
|
|
public Typeface getTypeface() {
|
|
return typeface;
|
|
}
|
|
|
|
@Override
|
|
public void dispatchProvideAutofillStructure(ViewStructure structure, int flags) {
|
|
if (originalHint == null || editText == null) {
|
|
super.dispatchProvideAutofillStructure(structure, flags);
|
|
return;
|
|
}
|
|
|
|
// Temporarily sets child's hint to its original value so it is properly set in the
|
|
// child's ViewStructure.
|
|
boolean wasProvidingHint = isProvidingHint;
|
|
// Ensures a child TextInputEditText does not retrieve its hint from this TextInputLayout.
|
|
isProvidingHint = false;
|
|
final CharSequence hint = editText.getHint();
|
|
editText.setHint(originalHint);
|
|
try {
|
|
super.dispatchProvideAutofillStructure(structure, flags);
|
|
} finally {
|
|
editText.setHint(hint);
|
|
isProvidingHint = wasProvidingHint;
|
|
}
|
|
}
|
|
|
|
private void setEditText(EditText editText) {
|
|
// If we already have an EditText, throw an exception
|
|
if (this.editText != null) {
|
|
throw new IllegalArgumentException("We already have an EditText, can only have one");
|
|
}
|
|
|
|
if (!(editText instanceof TextInputEditText)) {
|
|
Log.i(
|
|
LOG_TAG,
|
|
"EditText added is not a TextInputEditText. Please switch to using that"
|
|
+ " class instead.");
|
|
}
|
|
|
|
this.editText = editText;
|
|
onApplyBoxBackgroundMode();
|
|
setTextInputAccessibilityDelegate(new AccessibilityDelegate(this));
|
|
|
|
final boolean hasPasswordTransformation = hasPasswordTransformation();
|
|
|
|
// Use the EditText's typeface, and its text size for our expanded text.
|
|
if (!hasPasswordTransformation) {
|
|
// We don't want a monospace font just because we have a password field
|
|
collapsingTextHelper.setTypefaces(this.editText.getTypeface());
|
|
}
|
|
collapsingTextHelper.setExpandedTextSize(this.editText.getTextSize());
|
|
|
|
final int editTextGravity = this.editText.getGravity();
|
|
collapsingTextHelper.setCollapsedTextGravity(
|
|
Gravity.TOP | (editTextGravity & ~Gravity.VERTICAL_GRAVITY_MASK));
|
|
collapsingTextHelper.setExpandedTextGravity(editTextGravity);
|
|
|
|
// Add a TextWatcher so that we know when the text input has changed.
|
|
this.editText.addTextChangedListener(
|
|
new TextWatcher() {
|
|
@Override
|
|
public void afterTextChanged(Editable s) {
|
|
updateLabelState(!restoringSavedState);
|
|
if (counterEnabled) {
|
|
updateCounter(s.length());
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public void beforeTextChanged(CharSequence s, int start, int count, int after) {}
|
|
|
|
@Override
|
|
public void onTextChanged(CharSequence s, int start, int before, int count) {}
|
|
});
|
|
|
|
// Use the EditText's hint colors if we don't have one set
|
|
if (defaultHintTextColor == null) {
|
|
defaultHintTextColor = this.editText.getHintTextColors();
|
|
}
|
|
|
|
// If we do not have a valid hint, try and retrieve it from the EditText, if enabled
|
|
if (hintEnabled) {
|
|
if (TextUtils.isEmpty(hint)) {
|
|
// Save the hint so it can be restored on dispatchProvideAutofillStructure();
|
|
originalHint = this.editText.getHint();
|
|
setHint(originalHint);
|
|
// Clear the EditText's hint as we will display it ourselves
|
|
this.editText.setHint(null);
|
|
}
|
|
this.isProvidingHint = true;
|
|
}
|
|
|
|
if (counterView != null) {
|
|
updateCounter(this.editText.getText().length());
|
|
}
|
|
|
|
indicatorViewController.adjustIndicatorPadding();
|
|
|
|
updatePasswordToggleView();
|
|
|
|
// Update the label visibility with no animation, but force a state change
|
|
updateLabelState(false, true);
|
|
}
|
|
|
|
private void updateInputLayoutMargins() {
|
|
// Create/update the LayoutParams so that we can add enough top margin
|
|
// to the EditText to make room for the label.
|
|
final LayoutParams lp = (LayoutParams) inputFrame.getLayoutParams();
|
|
final int newTopMargin = calculateLabelMarginTop();
|
|
|
|
if (newTopMargin != lp.topMargin) {
|
|
lp.topMargin = newTopMargin;
|
|
inputFrame.requestLayout();
|
|
}
|
|
}
|
|
|
|
void updateLabelState(boolean animate) {
|
|
updateLabelState(animate, false);
|
|
}
|
|
|
|
private void updateLabelState(boolean animate, boolean force) {
|
|
final boolean isEnabled = isEnabled();
|
|
final boolean hasText = editText != null && !TextUtils.isEmpty(editText.getText());
|
|
final boolean hasFocus = editText != null && editText.hasFocus();
|
|
final boolean errorShouldBeShown = indicatorViewController.errorShouldBeShown();
|
|
|
|
// Set the expanded and collapsed labels to the default text color.
|
|
if (defaultHintTextColor != null) {
|
|
collapsingTextHelper.setCollapsedTextColor(defaultHintTextColor);
|
|
collapsingTextHelper.setExpandedTextColor(defaultHintTextColor);
|
|
}
|
|
|
|
// Set the collapsed and expanded label text colors based on the current state.
|
|
if (!isEnabled) {
|
|
collapsingTextHelper.setCollapsedTextColor(ColorStateList.valueOf(disabledColor));
|
|
collapsingTextHelper.setExpandedTextColor(ColorStateList.valueOf(disabledColor));
|
|
} else if (errorShouldBeShown) {
|
|
collapsingTextHelper.setCollapsedTextColor(indicatorViewController.getErrorViewTextColors());
|
|
} else if (counterOverflowed && counterView != null) {
|
|
collapsingTextHelper.setCollapsedTextColor(counterView.getTextColors());
|
|
} else if (hasFocus && focusedTextColor != null) {
|
|
collapsingTextHelper.setCollapsedTextColor(focusedTextColor);
|
|
} // If none of these states apply, leave the expanded and collapsed colors as they are.
|
|
|
|
if (hasText || (isEnabled() && (hasFocus || errorShouldBeShown))) {
|
|
// We should be showing the label so do so if it isn't already
|
|
if (force || hintExpanded) {
|
|
collapseHint(animate);
|
|
}
|
|
} else {
|
|
// We should not be showing the label so hide it
|
|
if (force || !hintExpanded) {
|
|
expandHint(animate);
|
|
}
|
|
}
|
|
}
|
|
|
|
/** Returns the {@link android.widget.EditText} used for text input. */
|
|
@Nullable
|
|
public EditText getEditText() {
|
|
return editText;
|
|
}
|
|
|
|
/**
|
|
* Set the hint to be displayed in the floating label, if enabled.
|
|
*
|
|
* @see #setHintEnabled(boolean)
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_android_hint
|
|
*/
|
|
public void setHint(@Nullable CharSequence hint) {
|
|
if (hintEnabled) {
|
|
setHintInternal(hint);
|
|
sendAccessibilityEvent(AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED);
|
|
}
|
|
}
|
|
|
|
private void setHintInternal(CharSequence hint) {
|
|
if (!TextUtils.equals(hint, this.hint)) {
|
|
this.hint = hint;
|
|
collapsingTextHelper.setText(hint);
|
|
// Reset the cutout to make room for a larger hint.
|
|
if (!hintExpanded) {
|
|
openCutout();
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the hint which is displayed in the floating label, if enabled.
|
|
*
|
|
* @return the hint, or null if there isn't one set, or the hint is not enabled.
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_android_hint
|
|
*/
|
|
@Nullable
|
|
public CharSequence getHint() {
|
|
return hintEnabled ? hint : null;
|
|
}
|
|
|
|
/**
|
|
* Sets whether the floating label functionality is enabled or not in this layout.
|
|
*
|
|
* <p>If enabled, any non-empty hint in the child EditText will be moved into the floating hint,
|
|
* and its existing hint will be cleared. If disabled, then any non-empty floating hint in this
|
|
* layout will be moved into the EditText, and this layout's hint will be cleared.
|
|
*
|
|
* @see #setHint(CharSequence)
|
|
* @see #isHintEnabled()
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_hintEnabled
|
|
*/
|
|
public void setHintEnabled(boolean enabled) {
|
|
if (enabled != hintEnabled) {
|
|
hintEnabled = enabled;
|
|
if (!hintEnabled) {
|
|
// Ensures a child TextInputEditText provides its internal hint, not this TextInputLayout's.
|
|
isProvidingHint = false;
|
|
if (!TextUtils.isEmpty(hint) && TextUtils.isEmpty(editText.getHint())) {
|
|
// If the child EditText has no hint, but this layout does, restore it on the child.
|
|
editText.setHint(hint);
|
|
}
|
|
// Now clear out any set hint
|
|
setHintInternal(null);
|
|
} else {
|
|
final CharSequence editTextHint = editText.getHint();
|
|
if (!TextUtils.isEmpty(editTextHint)) {
|
|
// If the hint is now enabled and the EditText has one set, we'll use it if
|
|
// we don't already have one, and clear the EditText's
|
|
if (TextUtils.isEmpty(hint)) {
|
|
setHint(editTextHint);
|
|
}
|
|
editText.setHint(null);
|
|
}
|
|
isProvidingHint = true;
|
|
}
|
|
|
|
// Now update the EditText top margin
|
|
if (editText != null) {
|
|
updateInputLayoutMargins();
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns whether the floating label functionality is enabled or not in this layout.
|
|
*
|
|
* @see #setHintEnabled(boolean)
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_hintEnabled
|
|
*/
|
|
public boolean isHintEnabled() {
|
|
return hintEnabled;
|
|
}
|
|
|
|
/**
|
|
* Returns whether or not this layout is actively managing a child {@link EditText}'s hint. If the
|
|
* child is an instance of {@link TextInputEditText}, this value defines the behavior of {@link
|
|
* TextInputEditText#getHint()}.
|
|
*/
|
|
boolean isProvidingHint() {
|
|
return isProvidingHint;
|
|
}
|
|
|
|
/**
|
|
* Sets the hint text color, size, style from the specified TextAppearance resource.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_hintTextAppearance
|
|
*/
|
|
public void setHintTextAppearance(@StyleRes int resId) {
|
|
collapsingTextHelper.setCollapsedTextAppearance(resId);
|
|
focusedTextColor = collapsingTextHelper.getCollapsedTextColor();
|
|
|
|
if (editText != null) {
|
|
updateLabelState(false);
|
|
// Text size might have changed so update the top margin
|
|
updateInputLayoutMargins();
|
|
}
|
|
}
|
|
|
|
/** Sets the text color used by the hint in both the collapsed and expanded states. */
|
|
public void setDefaultHintTextColor(@Nullable ColorStateList textColor) {
|
|
defaultHintTextColor = textColor;
|
|
focusedTextColor = textColor;
|
|
|
|
if (editText != null) {
|
|
updateLabelState(false);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the text color used by the hint in both the collapsed and expanded states, or null if
|
|
* no color has been set.
|
|
*/
|
|
@Nullable
|
|
public ColorStateList getDefaultHintTextColor() {
|
|
return defaultHintTextColor;
|
|
}
|
|
|
|
/**
|
|
* Whether the error functionality is enabled or not in this layout. Enabling this functionality
|
|
* before setting an error message via {@link #setError(CharSequence)}, will mean that this layout
|
|
* will not change size when an error is displayed.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_errorEnabled
|
|
*/
|
|
public void setErrorEnabled(boolean enabled) {
|
|
indicatorViewController.setErrorEnabled(enabled);
|
|
}
|
|
|
|
/**
|
|
* Sets the text color and size for the error message from the specified TextAppearance resource.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_errorTextAppearance
|
|
*/
|
|
public void setErrorTextAppearance(@StyleRes int resId) {
|
|
indicatorViewController.setErrorTextAppearance(resId);
|
|
}
|
|
|
|
/** Sets the text color used by the error message in all states. */
|
|
public void setErrorTextColor(@Nullable ColorStateList textColors) {
|
|
indicatorViewController.setErrorViewTextColor(textColors);
|
|
}
|
|
|
|
/** Returns the text color used by the error message in current state. */
|
|
@ColorInt
|
|
public int getErrorCurrentTextColors() {
|
|
return indicatorViewController.getErrorViewCurrentTextColor();
|
|
}
|
|
|
|
/**
|
|
* Sets the text color and size for the helper text from the specified TextAppearance resource.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_helperTextTextAppearance
|
|
*/
|
|
public void setHelperTextTextAppearance(@StyleRes int resId) {
|
|
indicatorViewController.setHelperTextAppearance(resId);
|
|
}
|
|
|
|
/**
|
|
* Returns whether the error functionality is enabled or not in this layout.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_errorEnabled
|
|
* @see #setErrorEnabled(boolean)
|
|
*/
|
|
public boolean isErrorEnabled() {
|
|
return indicatorViewController.isErrorEnabled();
|
|
}
|
|
|
|
/**
|
|
* Whether the helper text functionality is enabled or not in this layout. Enabling this
|
|
* functionality before setting a helper message via {@link #setHelperText(CharSequence)} will
|
|
* mean that this layout will not change size when a helper message is displayed.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_helperTextEnabled
|
|
*/
|
|
public void setHelperTextEnabled(boolean enabled) {
|
|
indicatorViewController.setHelperTextEnabled(enabled);
|
|
}
|
|
|
|
/**
|
|
* Sets a helper message that will be displayed below the {@link EditText}. If the {@code helper}
|
|
* is {@code null}, the helper text functionality will be disabled and the helper message will be
|
|
* hidden.
|
|
*
|
|
* <p>If the helper text functionality has not been enabled via {@link
|
|
* #setHelperTextEnabled(boolean)}, then it will be automatically enabled if {@code helper} is not
|
|
* empty.
|
|
*
|
|
* @param helperText Helper text to display
|
|
* @see #getHelperText()
|
|
*/
|
|
public void setHelperText(@Nullable final CharSequence helperText) {
|
|
// If helper text is null, disable helper if it's enabled.
|
|
if (TextUtils.isEmpty(helperText)) {
|
|
if (isHelperTextEnabled()) {
|
|
setHelperTextEnabled(false);
|
|
}
|
|
} else {
|
|
if (!isHelperTextEnabled()) {
|
|
setHelperTextEnabled(true);
|
|
}
|
|
indicatorViewController.showHelper(helperText);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns whether the helper text functionality is enabled or not in this layout.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_helperTextEnabled
|
|
* @see #setHelperTextEnabled(boolean)
|
|
*/
|
|
public boolean isHelperTextEnabled() {
|
|
return indicatorViewController.isHelperTextEnabled();
|
|
}
|
|
|
|
/** Sets the text color used by the helper text in all states. */
|
|
public void setHelperTextColor(@Nullable ColorStateList textColors) {
|
|
indicatorViewController.setHelperTextViewTextColor(textColors);
|
|
}
|
|
|
|
/** Returns the text color used by the helper text in the current states. */
|
|
@ColorInt
|
|
public int getHelperTextCurrentTextColor() {
|
|
return indicatorViewController.getHelperTextViewCurrentTextColor();
|
|
}
|
|
|
|
/**
|
|
* Sets an error message that will be displayed below our {@link EditText}. If the {@code error}
|
|
* is {@code null}, the error message will be cleared.
|
|
*
|
|
* <p>If the error functionality has not been enabled via {@link #setErrorEnabled(boolean)}, then
|
|
* it will be automatically enabled if {@code error} is not empty.
|
|
*
|
|
* @param errorText Error message to display, or null to clear
|
|
* @see #getError()
|
|
*/
|
|
public void setError(@Nullable final CharSequence errorText) {
|
|
if (!indicatorViewController.isErrorEnabled()) {
|
|
if (TextUtils.isEmpty(errorText)) {
|
|
// If error isn't enabled, and the error is empty, just return
|
|
return;
|
|
}
|
|
// Else, we'll assume that they want to enable the error functionality
|
|
setErrorEnabled(true);
|
|
}
|
|
|
|
if (!TextUtils.isEmpty(errorText)) {
|
|
indicatorViewController.showError(errorText);
|
|
} else {
|
|
indicatorViewController.hideError();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Whether the character counter functionality is enabled or not in this layout.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_counterEnabled
|
|
*/
|
|
public void setCounterEnabled(boolean enabled) {
|
|
if (counterEnabled != enabled) {
|
|
if (enabled) {
|
|
counterView = new AppCompatTextView(getContext());
|
|
counterView.setId(R.id.textinput_counter);
|
|
if (typeface != null) {
|
|
counterView.setTypeface(typeface);
|
|
}
|
|
counterView.setMaxLines(1);
|
|
setTextAppearanceCompatWithErrorFallback(counterView, counterTextAppearance);
|
|
indicatorViewController.addIndicator(counterView, COUNTER_INDEX);
|
|
if (editText == null) {
|
|
updateCounter(0);
|
|
} else {
|
|
updateCounter(editText.getText().length());
|
|
}
|
|
} else {
|
|
indicatorViewController.removeIndicator(counterView, COUNTER_INDEX);
|
|
counterView = null;
|
|
}
|
|
counterEnabled = enabled;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns whether the character counter functionality is enabled or not in this layout.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_counterEnabled
|
|
* @see #setCounterEnabled(boolean)
|
|
*/
|
|
public boolean isCounterEnabled() {
|
|
return counterEnabled;
|
|
}
|
|
|
|
/**
|
|
* Sets the max length to display at the character counter.
|
|
*
|
|
* @param maxLength maxLength to display. Any value less than or equal to 0 will not be shown.
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_counterMaxLength
|
|
*/
|
|
public void setCounterMaxLength(int maxLength) {
|
|
if (counterMaxLength != maxLength) {
|
|
if (maxLength > 0) {
|
|
counterMaxLength = maxLength;
|
|
} else {
|
|
counterMaxLength = INVALID_MAX_LENGTH;
|
|
}
|
|
if (counterEnabled) {
|
|
updateCounter(editText == null ? 0 : editText.getText().length());
|
|
}
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public void setEnabled(boolean enabled) {
|
|
// Since we're set to addStatesFromChildren, we need to make sure that we set all
|
|
// children to enabled/disabled otherwise any enabled children will wipe out our disabled
|
|
// drawable state
|
|
recursiveSetEnabled(this, enabled);
|
|
super.setEnabled(enabled);
|
|
}
|
|
|
|
private static void recursiveSetEnabled(final ViewGroup vg, final boolean enabled) {
|
|
for (int i = 0, count = vg.getChildCount(); i < count; i++) {
|
|
final View child = vg.getChildAt(i);
|
|
child.setEnabled(enabled);
|
|
if (child instanceof ViewGroup) {
|
|
recursiveSetEnabled((ViewGroup) child, enabled);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the max length shown at the character counter.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_counterMaxLength
|
|
*/
|
|
public int getCounterMaxLength() {
|
|
return counterMaxLength;
|
|
}
|
|
|
|
void updateCounter(int length) {
|
|
boolean wasCounterOverflowed = counterOverflowed;
|
|
if (counterMaxLength == INVALID_MAX_LENGTH) {
|
|
counterView.setText(String.valueOf(length));
|
|
counterOverflowed = false;
|
|
} else {
|
|
// Make sure the counter view region is not live to prevent spamming the user with the counter
|
|
// overflow message on every key press.
|
|
if (ViewCompat.getAccessibilityLiveRegion(counterView)
|
|
== ViewCompat.ACCESSIBILITY_LIVE_REGION_POLITE) {
|
|
ViewCompat.setAccessibilityLiveRegion(
|
|
counterView, ViewCompat.ACCESSIBILITY_LIVE_REGION_NONE);
|
|
}
|
|
counterOverflowed = length > counterMaxLength;
|
|
if (wasCounterOverflowed != counterOverflowed) {
|
|
setTextAppearanceCompatWithErrorFallback(
|
|
counterView, counterOverflowed ? counterOverflowTextAppearance : counterTextAppearance);
|
|
|
|
// Announce when the character limit is exceeded.
|
|
if (counterOverflowed) {
|
|
ViewCompat.setAccessibilityLiveRegion(
|
|
counterView, ViewCompat.ACCESSIBILITY_LIVE_REGION_POLITE);
|
|
}
|
|
}
|
|
counterView.setText(
|
|
getContext().getString(R.string.character_counter_pattern, length, counterMaxLength));
|
|
counterView.setContentDescription(
|
|
getContext()
|
|
.getString(R.string.character_counter_content_description, length, counterMaxLength));
|
|
}
|
|
if (editText != null && wasCounterOverflowed != counterOverflowed) {
|
|
updateLabelState(false);
|
|
updateEditTextBackground();
|
|
}
|
|
}
|
|
|
|
void setTextAppearanceCompatWithErrorFallback(TextView textView, @StyleRes int textAppearance) {
|
|
boolean useDefaultColor = false;
|
|
try {
|
|
TextViewCompat.setTextAppearance(textView, textAppearance);
|
|
|
|
if (VERSION.SDK_INT >= VERSION_CODES.M
|
|
&& textView.getTextColors().getDefaultColor() == Color.MAGENTA) {
|
|
// Caused by our theme not extending from Theme.Design*. On API 23 and
|
|
// above, unresolved theme attrs result in MAGENTA rather than an exception.
|
|
// Flag so that we use a decent default
|
|
useDefaultColor = true;
|
|
}
|
|
} catch (Exception e) {
|
|
// Caused by our theme not extending from Theme.Design*. Flag so that we use
|
|
// a decent default
|
|
useDefaultColor = true;
|
|
}
|
|
if (useDefaultColor) {
|
|
// Probably caused by our theme not extending from Theme.Design*. Instead
|
|
// we manually set something appropriate
|
|
TextViewCompat.setTextAppearance(textView, R.style.TextAppearance_AppCompat_Caption);
|
|
textView.setTextColor(ContextCompat.getColor(getContext(), R.color.design_error));
|
|
}
|
|
}
|
|
|
|
private void updateTextInputBoxBounds() {
|
|
if (boxBackgroundMode == BOX_BACKGROUND_NONE
|
|
|| boxBackground == null
|
|
|| editText == null
|
|
|| getRight() == 0) {
|
|
return;
|
|
}
|
|
|
|
int left = editText.getLeft();
|
|
int top = calculateBoxBackgroundTop();
|
|
int right = editText.getRight();
|
|
int bottom = editText.getBottom() + boxBottomOffsetPx;
|
|
|
|
// Create space for the wider stroke width to ensure that the outline box's stroke is not cut
|
|
// off.
|
|
if (boxBackgroundMode == BOX_BACKGROUND_OUTLINE) {
|
|
left += boxStrokeWidthFocusedPx / 2;
|
|
top -= boxStrokeWidthFocusedPx / 2;
|
|
right -= boxStrokeWidthFocusedPx / 2;
|
|
bottom += boxStrokeWidthFocusedPx / 2;
|
|
}
|
|
|
|
boxBackground.setBounds(left, top, right, bottom);
|
|
applyBoxAttributes();
|
|
updateEditTextBackgroundBounds();
|
|
}
|
|
|
|
private int calculateBoxBackgroundTop() {
|
|
if (editText == null) {
|
|
return 0;
|
|
}
|
|
|
|
switch (boxBackgroundMode) {
|
|
case BOX_BACKGROUND_FILLED:
|
|
return editText.getTop();
|
|
case BOX_BACKGROUND_OUTLINE:
|
|
return editText.getTop() + calculateLabelMarginTop();
|
|
default:
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
private int calculateLabelMarginTop() {
|
|
if (!hintEnabled) {
|
|
return 0;
|
|
}
|
|
|
|
switch (boxBackgroundMode) {
|
|
case BOX_BACKGROUND_OUTLINE:
|
|
return (int) (collapsingTextHelper.getCollapsedTextHeight() / 2);
|
|
case BOX_BACKGROUND_FILLED:
|
|
case BOX_BACKGROUND_NONE:
|
|
return (int) collapsingTextHelper.getCollapsedTextHeight();
|
|
default:
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
private int calculateCollapsedTextTopBounds() {
|
|
switch (boxBackgroundMode) {
|
|
case BOX_BACKGROUND_OUTLINE:
|
|
return getBoxBackground().getBounds().top - calculateLabelMarginTop();
|
|
case BOX_BACKGROUND_FILLED:
|
|
return getBoxBackground().getBounds().top + boxCollapsedPaddingTopPx;
|
|
default:
|
|
return getPaddingTop();
|
|
}
|
|
}
|
|
|
|
private void updateEditTextBackgroundBounds() {
|
|
if (editText == null) {
|
|
return;
|
|
}
|
|
Drawable editTextBackground = editText.getBackground();
|
|
if (editTextBackground == null) {
|
|
return;
|
|
}
|
|
|
|
if (android.support.v7.widget.DrawableUtils.canSafelyMutateDrawable(editTextBackground)) {
|
|
editTextBackground = editTextBackground.mutate();
|
|
}
|
|
|
|
final Rect editTextBounds = new Rect();
|
|
DescendantOffsetUtils.getDescendantRect(this, editText, editTextBounds);
|
|
|
|
Rect editTextBackgroundBounds = editTextBackground.getBounds();
|
|
if (editTextBackgroundBounds.left != editTextBackgroundBounds.right) {
|
|
|
|
Rect editTextBackgroundPadding = new Rect();
|
|
editTextBackground.getPadding(editTextBackgroundPadding);
|
|
|
|
final int left = editTextBackgroundBounds.left - editTextBackgroundPadding.left;
|
|
final int right = editTextBackgroundBounds.right + editTextBackgroundPadding.right * 2;
|
|
editTextBackground.setBounds(left, editTextBackgroundBounds.top, right, editText.getBottom());
|
|
}
|
|
}
|
|
|
|
private void setBoxAttributes() {
|
|
switch (boxBackgroundMode) {
|
|
case BOX_BACKGROUND_FILLED:
|
|
boxStrokeWidthPx = 0;
|
|
break;
|
|
|
|
case BOX_BACKGROUND_OUTLINE:
|
|
if (focusedStrokeColor == Color.TRANSPARENT) {
|
|
focusedStrokeColor =
|
|
focusedTextColor.getColorForState(
|
|
getDrawableState(), focusedTextColor.getDefaultColor());
|
|
}
|
|
break;
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
|
|
private void applyBoxAttributes() {
|
|
if (boxBackground == null) {
|
|
return;
|
|
}
|
|
|
|
setBoxAttributes();
|
|
|
|
if (editText != null && boxBackgroundMode == BOX_BACKGROUND_OUTLINE) {
|
|
// Store the EditText's background drawable, in case it needs to be restored later.
|
|
if (editText.getBackground() != null) {
|
|
editTextOriginalDrawable = editText.getBackground();
|
|
}
|
|
ViewCompat.setBackground(editText, null);
|
|
}
|
|
|
|
if (editText != null
|
|
&& boxBackgroundMode == BOX_BACKGROUND_FILLED
|
|
&& editTextOriginalDrawable != null) {
|
|
// Restore the EditText drawable.
|
|
ViewCompat.setBackground(editText, editTextOriginalDrawable);
|
|
}
|
|
|
|
if (boxStrokeWidthPx > -1 && boxStrokeColor != Color.TRANSPARENT) {
|
|
boxBackground.setStroke(boxStrokeWidthPx, boxStrokeColor);
|
|
}
|
|
|
|
boxBackground.setCornerRadii(getCornerRadiiAsArray());
|
|
boxBackground.setColor(boxBackgroundColor);
|
|
invalidate();
|
|
}
|
|
|
|
void updateEditTextBackground() {
|
|
if (editText == null) {
|
|
return;
|
|
}
|
|
|
|
Drawable editTextBackground = editText.getBackground();
|
|
if (editTextBackground == null) {
|
|
return;
|
|
}
|
|
|
|
ensureBackgroundDrawableStateWorkaround();
|
|
|
|
if (android.support.v7.widget.DrawableUtils.canSafelyMutateDrawable(editTextBackground)) {
|
|
editTextBackground = editTextBackground.mutate();
|
|
}
|
|
|
|
if (indicatorViewController.errorShouldBeShown()) {
|
|
// Set a color filter for the error color
|
|
editTextBackground.setColorFilter(
|
|
AppCompatDrawableManager.getPorterDuffColorFilter(
|
|
indicatorViewController.getErrorViewCurrentTextColor(), PorterDuff.Mode.SRC_IN));
|
|
} else if (counterOverflowed && counterView != null) {
|
|
// Set a color filter of the counter color
|
|
editTextBackground.setColorFilter(
|
|
AppCompatDrawableManager.getPorterDuffColorFilter(
|
|
counterView.getCurrentTextColor(), PorterDuff.Mode.SRC_IN));
|
|
} else {
|
|
// Else reset the color filter and refresh the drawable state so that the
|
|
// normal tint is used
|
|
DrawableCompat.clearColorFilter(editTextBackground);
|
|
editText.refreshDrawableState();
|
|
}
|
|
}
|
|
|
|
private void ensureBackgroundDrawableStateWorkaround() {
|
|
final int sdk = Build.VERSION.SDK_INT;
|
|
if (sdk != 21 && sdk != 22) {
|
|
// The workaround is only required on API 21-22
|
|
return;
|
|
}
|
|
final Drawable bg = editText.getBackground();
|
|
if (bg == null) {
|
|
return;
|
|
}
|
|
|
|
if (!hasReconstructedEditTextBackground) {
|
|
// This is gross. There is an issue in the platform which affects container Drawables
|
|
// where the first drawable retrieved from resources will propagate any changes
|
|
// (like color filter) to all instances from the cache. We'll try to work around it...
|
|
|
|
final Drawable newBg = bg.getConstantState().newDrawable();
|
|
|
|
if (bg instanceof DrawableContainer) {
|
|
// If we have a Drawable container, we can try and set its constant state via
|
|
// reflection from the new Drawable
|
|
hasReconstructedEditTextBackground =
|
|
DrawableUtils.setContainerConstantState(
|
|
(DrawableContainer) bg, newBg.getConstantState());
|
|
}
|
|
|
|
if (!hasReconstructedEditTextBackground) {
|
|
// If we reach here then we just need to set a brand new instance of the Drawable
|
|
// as the background. This has the unfortunate side-effect of wiping out any
|
|
// user set padding, but I'd hope that use of custom padding on an EditText
|
|
// is limited.
|
|
ViewCompat.setBackground(editText, newBg);
|
|
hasReconstructedEditTextBackground = true;
|
|
// Re-apply box background mode to set the EditText's box padding if in box mode.
|
|
onApplyBoxBackgroundMode();
|
|
}
|
|
}
|
|
}
|
|
|
|
static class SavedState extends AbsSavedState {
|
|
CharSequence error;
|
|
boolean isPasswordToggledVisible;
|
|
|
|
SavedState(Parcelable superState) {
|
|
super(superState);
|
|
}
|
|
|
|
SavedState(Parcel source, ClassLoader loader) {
|
|
super(source, loader);
|
|
error = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(source);
|
|
isPasswordToggledVisible = (source.readInt() == 1);
|
|
}
|
|
|
|
@Override
|
|
public void writeToParcel(Parcel dest, int flags) {
|
|
super.writeToParcel(dest, flags);
|
|
TextUtils.writeToParcel(error, dest, flags);
|
|
dest.writeInt(isPasswordToggledVisible ? 1 : 0);
|
|
}
|
|
|
|
@Override
|
|
public String toString() {
|
|
return "TextInputLayout.SavedState{"
|
|
+ Integer.toHexString(System.identityHashCode(this))
|
|
+ " error="
|
|
+ error
|
|
+ "}";
|
|
}
|
|
|
|
public static final Creator<SavedState> CREATOR =
|
|
new ClassLoaderCreator<SavedState>() {
|
|
@Override
|
|
public SavedState createFromParcel(Parcel in, ClassLoader loader) {
|
|
return new SavedState(in, loader);
|
|
}
|
|
|
|
@Override
|
|
public SavedState createFromParcel(Parcel in) {
|
|
return new SavedState(in, null);
|
|
}
|
|
|
|
@Override
|
|
public SavedState[] newArray(int size) {
|
|
return new SavedState[size];
|
|
}
|
|
};
|
|
}
|
|
|
|
@Override
|
|
public Parcelable onSaveInstanceState() {
|
|
Parcelable superState = super.onSaveInstanceState();
|
|
SavedState ss = new SavedState(superState);
|
|
if (indicatorViewController.errorShouldBeShown()) {
|
|
ss.error = getError();
|
|
}
|
|
ss.isPasswordToggledVisible = passwordToggledVisible;
|
|
return ss;
|
|
}
|
|
|
|
@Override
|
|
protected void onRestoreInstanceState(Parcelable state) {
|
|
if (!(state instanceof SavedState)) {
|
|
super.onRestoreInstanceState(state);
|
|
return;
|
|
}
|
|
SavedState ss = (SavedState) state;
|
|
super.onRestoreInstanceState(ss.getSuperState());
|
|
setError(ss.error);
|
|
if (ss.isPasswordToggledVisible) {
|
|
passwordVisibilityToggleRequested(true /* shouldSkipAnimations */);
|
|
}
|
|
requestLayout();
|
|
}
|
|
|
|
@Override
|
|
protected void dispatchRestoreInstanceState(SparseArray<Parcelable> container) {
|
|
restoringSavedState = true;
|
|
super.dispatchRestoreInstanceState(container);
|
|
restoringSavedState = false;
|
|
}
|
|
|
|
/**
|
|
* Returns the error message that was set to be displayed with {@link #setError(CharSequence)}, or
|
|
* <code>null</code> if no error was set or if error displaying is not enabled.
|
|
*
|
|
* @see #setError(CharSequence)
|
|
*/
|
|
@Nullable
|
|
public CharSequence getError() {
|
|
return indicatorViewController.isErrorEnabled() ? indicatorViewController.getErrorText() : null;
|
|
}
|
|
|
|
/**
|
|
* Returns the helper message that was set to be displayed with {@link
|
|
* #setHelperText(CharSequence)}, or <code>null</code> if no helper text was set or if helper text
|
|
* functionality is not enabled.
|
|
*
|
|
* @see #setHelperText(CharSequence)
|
|
*/
|
|
@Nullable
|
|
public CharSequence getHelperText() {
|
|
return indicatorViewController.isHelperTextEnabled()
|
|
? indicatorViewController.getHelperText()
|
|
: null;
|
|
}
|
|
|
|
/**
|
|
* Returns whether any hint state changes, due to being focused or non-empty text, are animated.
|
|
*
|
|
* @see #setHintAnimationEnabled(boolean)
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_hintAnimationEnabled
|
|
*/
|
|
public boolean isHintAnimationEnabled() {
|
|
return hintAnimationEnabled;
|
|
}
|
|
|
|
/**
|
|
* Set whether any hint state changes, due to being focused or non-empty text, are animated.
|
|
*
|
|
* @see #isHintAnimationEnabled()
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_hintAnimationEnabled
|
|
*/
|
|
public void setHintAnimationEnabled(boolean enabled) {
|
|
hintAnimationEnabled = enabled;
|
|
}
|
|
|
|
@Override
|
|
public void draw(Canvas canvas) {
|
|
if (boxBackground != null) {
|
|
boxBackground.draw(canvas);
|
|
}
|
|
super.draw(canvas);
|
|
if (hintEnabled) {
|
|
collapsingTextHelper.draw(canvas);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
|
|
updatePasswordToggleView();
|
|
super.onMeasure(widthMeasureSpec, heightMeasureSpec);
|
|
}
|
|
|
|
private void updatePasswordToggleView() {
|
|
if (editText == null) {
|
|
// If there is no EditText, there is nothing to update
|
|
return;
|
|
}
|
|
|
|
if (shouldShowPasswordIcon()) {
|
|
if (passwordToggleView == null) {
|
|
passwordToggleView =
|
|
(CheckableImageButton)
|
|
LayoutInflater.from(getContext())
|
|
.inflate(R.layout.design_text_input_password_icon, inputFrame, false);
|
|
passwordToggleView.setImageDrawable(passwordToggleDrawable);
|
|
passwordToggleView.setContentDescription(passwordToggleContentDesc);
|
|
inputFrame.addView(passwordToggleView);
|
|
|
|
passwordToggleView.setOnClickListener(
|
|
new View.OnClickListener() {
|
|
@Override
|
|
public void onClick(View view) {
|
|
passwordVisibilityToggleRequested(false /* shouldSkipAnimations */);
|
|
}
|
|
});
|
|
}
|
|
|
|
if (editText != null && ViewCompat.getMinimumHeight(editText) <= 0) {
|
|
// We should make sure that the EditText has the same min-height as the password toggle
|
|
// view. This ensures focus works properly, and there is no visual jump if the password
|
|
// toggle is enabled/disabled.
|
|
editText.setMinimumHeight(ViewCompat.getMinimumHeight(passwordToggleView));
|
|
}
|
|
|
|
passwordToggleView.setVisibility(VISIBLE);
|
|
passwordToggleView.setChecked(passwordToggledVisible);
|
|
|
|
// We need to add a dummy drawable as the end compound drawable so that the text is
|
|
// indented and doesn't display below the toggle view
|
|
if (passwordToggleDummyDrawable == null) {
|
|
passwordToggleDummyDrawable = new ColorDrawable();
|
|
}
|
|
passwordToggleDummyDrawable.setBounds(0, 0, passwordToggleView.getMeasuredWidth(), 1);
|
|
|
|
final Drawable[] compounds = TextViewCompat.getCompoundDrawablesRelative(editText);
|
|
// Store the user defined end compound drawable so that we can restore it later
|
|
if (compounds[2] != passwordToggleDummyDrawable) {
|
|
originalEditTextEndDrawable = compounds[2];
|
|
}
|
|
TextViewCompat.setCompoundDrawablesRelative(
|
|
editText, compounds[0], compounds[1], passwordToggleDummyDrawable, compounds[3]);
|
|
|
|
// Copy over the EditText's padding so that we match
|
|
passwordToggleView.setPadding(
|
|
editText.getPaddingLeft(),
|
|
editText.getPaddingTop(),
|
|
editText.getPaddingRight(),
|
|
editText.getPaddingBottom());
|
|
} else {
|
|
if (passwordToggleView != null && passwordToggleView.getVisibility() == VISIBLE) {
|
|
passwordToggleView.setVisibility(View.GONE);
|
|
}
|
|
|
|
if (passwordToggleDummyDrawable != null) {
|
|
// Make sure that we remove the dummy end compound drawable if it exists, and then
|
|
// clear it
|
|
final Drawable[] compounds = TextViewCompat.getCompoundDrawablesRelative(editText);
|
|
if (compounds[2] == passwordToggleDummyDrawable) {
|
|
TextViewCompat.setCompoundDrawablesRelative(
|
|
editText, compounds[0], compounds[1], originalEditTextEndDrawable, compounds[3]);
|
|
passwordToggleDummyDrawable = null;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set the icon to use for the password visibility toggle button.
|
|
*
|
|
* <p>If you use an icon you should also set a description for its action using {@link
|
|
* #setPasswordVisibilityToggleContentDescription(CharSequence)}. This is used for accessibility.
|
|
*
|
|
* @param resId resource id of the drawable to set, or 0 to clear the icon
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleDrawable
|
|
*/
|
|
public void setPasswordVisibilityToggleDrawable(@DrawableRes int resId) {
|
|
setPasswordVisibilityToggleDrawable(
|
|
resId != 0 ? AppCompatResources.getDrawable(getContext(), resId) : null);
|
|
}
|
|
|
|
/**
|
|
* Set the icon to use for the password visibility toggle button.
|
|
*
|
|
* <p>If you use an icon you should also set a description for its action using {@link
|
|
* #setPasswordVisibilityToggleContentDescription(CharSequence)}. This is used for accessibility.
|
|
*
|
|
* @param icon Drawable to set, may be null to clear the icon
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleDrawable
|
|
*/
|
|
public void setPasswordVisibilityToggleDrawable(@Nullable Drawable icon) {
|
|
passwordToggleDrawable = icon;
|
|
if (passwordToggleView != null) {
|
|
passwordToggleView.setImageDrawable(icon);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set a content description for the navigation button if one is present.
|
|
*
|
|
* <p>The content description will be read via screen readers or other accessibility systems to
|
|
* explain the action of the password visibility toggle.
|
|
*
|
|
* @param resId Resource ID of a content description string to set, or 0 to clear the description
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleContentDescription
|
|
*/
|
|
public void setPasswordVisibilityToggleContentDescription(@StringRes int resId) {
|
|
setPasswordVisibilityToggleContentDescription(
|
|
resId != 0 ? getResources().getText(resId) : null);
|
|
}
|
|
|
|
/**
|
|
* Set a content description for the navigation button if one is present.
|
|
*
|
|
* <p>The content description will be read via screen readers or other accessibility systems to
|
|
* explain the action of the password visibility toggle.
|
|
*
|
|
* @param description Content description to set, or null to clear the content description
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleContentDescription
|
|
*/
|
|
public void setPasswordVisibilityToggleContentDescription(@Nullable CharSequence description) {
|
|
passwordToggleContentDesc = description;
|
|
if (passwordToggleView != null) {
|
|
passwordToggleView.setContentDescription(description);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the icon currently used for the password visibility toggle button.
|
|
*
|
|
* @see #setPasswordVisibilityToggleDrawable(Drawable)
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleDrawable
|
|
*/
|
|
@Nullable
|
|
public Drawable getPasswordVisibilityToggleDrawable() {
|
|
return passwordToggleDrawable;
|
|
}
|
|
|
|
/**
|
|
* Returns the currently configured content description for the password visibility toggle button.
|
|
*
|
|
* <p>This will be used to describe the navigation action to users through mechanisms such as
|
|
* screen readers.
|
|
*/
|
|
@Nullable
|
|
public CharSequence getPasswordVisibilityToggleContentDescription() {
|
|
return passwordToggleContentDesc;
|
|
}
|
|
|
|
/**
|
|
* Returns whether the password visibility toggle functionality is currently enabled.
|
|
*
|
|
* @see #setPasswordVisibilityToggleEnabled(boolean)
|
|
*/
|
|
public boolean isPasswordVisibilityToggleEnabled() {
|
|
return passwordToggleEnabled;
|
|
}
|
|
|
|
/**
|
|
* Returns whether the password visibility toggle functionality is enabled or not.
|
|
*
|
|
* <p>When enabled, a button is placed at the end of the EditText which enables the user to switch
|
|
* between the field's input being visibly disguised or not.
|
|
*
|
|
* @param enabled true to enable the functionality
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleEnabled
|
|
*/
|
|
public void setPasswordVisibilityToggleEnabled(final boolean enabled) {
|
|
if (passwordToggleEnabled != enabled) {
|
|
passwordToggleEnabled = enabled;
|
|
|
|
if (!enabled && passwordToggledVisible && editText != null) {
|
|
// If the toggle is no longer enabled, but we remove the PasswordTransformation
|
|
// to make the password visible, add it back
|
|
editText.setTransformationMethod(PasswordTransformationMethod.getInstance());
|
|
}
|
|
|
|
// Reset the visibility tracking flag
|
|
passwordToggledVisible = false;
|
|
|
|
updatePasswordToggleView();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Applies a tint to the password visibility toggle drawable. Does not modify the current tint
|
|
* mode, which is {@link PorterDuff.Mode#SRC_IN} by default.
|
|
*
|
|
* <p>Subsequent calls to {@link #setPasswordVisibilityToggleDrawable(Drawable)} will
|
|
* automatically mutate the drawable and apply the specified tint and tint mode using {@link
|
|
* DrawableCompat#setTintList(Drawable, ColorStateList)}.
|
|
*
|
|
* @param tintList the tint to apply, may be null to clear tint
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleTint
|
|
*/
|
|
public void setPasswordVisibilityToggleTintList(@Nullable ColorStateList tintList) {
|
|
passwordToggleTintList = tintList;
|
|
hasPasswordToggleTintList = true;
|
|
applyPasswordToggleTint();
|
|
}
|
|
|
|
/**
|
|
* Specifies the blending mode used to apply the tint specified by {@link
|
|
* #setPasswordVisibilityToggleTintList(ColorStateList)} to the password visibility toggle
|
|
* drawable. The default mode is {@link PorterDuff.Mode#SRC_IN}.
|
|
*
|
|
* @param mode the blending mode used to apply the tint, may be null to clear tint
|
|
* @attr ref com.google.android.material.R.styleable#TextInputLayout_passwordToggleTintMode
|
|
*/
|
|
public void setPasswordVisibilityToggleTintMode(@Nullable PorterDuff.Mode mode) {
|
|
passwordToggleTintMode = mode;
|
|
hasPasswordToggleTintMode = true;
|
|
applyPasswordToggleTint();
|
|
}
|
|
|
|
/**
|
|
* Handles visiblity for a password toggle icon when changing obfuscation in a password edit text.
|
|
* Public so that clients can override this method for custom UI changes when toggling the display
|
|
* of password text
|
|
*
|
|
* @param shouldSkipAnimations true if the password toggle indicator icon should not animate
|
|
* changes
|
|
*/
|
|
public void passwordVisibilityToggleRequested(boolean shouldSkipAnimations) {
|
|
if (passwordToggleEnabled) {
|
|
// Store the current cursor position
|
|
final int selection = editText.getSelectionEnd();
|
|
|
|
if (hasPasswordTransformation()) {
|
|
editText.setTransformationMethod(null);
|
|
passwordToggledVisible = true;
|
|
} else {
|
|
editText.setTransformationMethod(PasswordTransformationMethod.getInstance());
|
|
passwordToggledVisible = false;
|
|
}
|
|
|
|
passwordToggleView.setChecked(passwordToggledVisible);
|
|
if (shouldSkipAnimations) {
|
|
passwordToggleView.jumpDrawablesToCurrentState();
|
|
}
|
|
|
|
// And restore the cursor position
|
|
editText.setSelection(selection);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Sets an {@link TextInputLayout.AccessibilityDelegate} providing an accessibility implementation
|
|
* for the {@link EditText} used by this layout.
|
|
*
|
|
* <p>Note: This method should be used in place of providing an {@link AccessibilityDelegate}
|
|
* directly on the {@link EditText}.
|
|
*/
|
|
public void setTextInputAccessibilityDelegate(TextInputLayout.AccessibilityDelegate delegate) {
|
|
if (editText != null) {
|
|
ViewCompat.setAccessibilityDelegate(editText, delegate);
|
|
}
|
|
}
|
|
|
|
private boolean hasPasswordTransformation() {
|
|
return editText != null
|
|
&& editText.getTransformationMethod() instanceof PasswordTransformationMethod;
|
|
}
|
|
|
|
private boolean shouldShowPasswordIcon() {
|
|
return passwordToggleEnabled && (hasPasswordTransformation() || passwordToggledVisible);
|
|
}
|
|
|
|
private void applyPasswordToggleTint() {
|
|
if (passwordToggleDrawable != null
|
|
&& (hasPasswordToggleTintList || hasPasswordToggleTintMode)) {
|
|
passwordToggleDrawable = DrawableCompat.wrap(passwordToggleDrawable).mutate();
|
|
|
|
if (hasPasswordToggleTintList) {
|
|
DrawableCompat.setTintList(passwordToggleDrawable, passwordToggleTintList);
|
|
}
|
|
if (hasPasswordToggleTintMode) {
|
|
DrawableCompat.setTintMode(passwordToggleDrawable, passwordToggleTintMode);
|
|
}
|
|
|
|
if (passwordToggleView != null
|
|
&& passwordToggleView.getDrawable() != passwordToggleDrawable) {
|
|
passwordToggleView.setImageDrawable(passwordToggleDrawable);
|
|
}
|
|
}
|
|
}
|
|
|
|
@Override
|
|
protected void onLayout(boolean changed, int left, int top, int right, int bottom) {
|
|
super.onLayout(changed, left, top, right, bottom);
|
|
|
|
if (boxBackground != null) {
|
|
updateTextInputBoxBounds();
|
|
}
|
|
|
|
if (hintEnabled && editText != null) {
|
|
final Rect rect = tmpRect;
|
|
DescendantOffsetUtils.getDescendantRect(this, editText, rect);
|
|
|
|
final int l = rect.left + editText.getCompoundPaddingLeft();
|
|
final int r = rect.right - editText.getCompoundPaddingRight();
|
|
final int t = calculateCollapsedTextTopBounds();
|
|
|
|
collapsingTextHelper.setExpandedBounds(
|
|
l,
|
|
rect.top + editText.getCompoundPaddingTop(),
|
|
r,
|
|
rect.bottom - editText.getCompoundPaddingBottom());
|
|
|
|
// Set the collapsed bounds to be the full height (minus padding) to match the
|
|
// EditText's editable area
|
|
collapsingTextHelper.setCollapsedBounds(l, t, r, bottom - top - getPaddingBottom());
|
|
collapsingTextHelper.recalculate();
|
|
|
|
// If the label should be collapsed, set the cutout bounds on the CutoutDrawable to make sure
|
|
// it draws with a cutout in draw().
|
|
if (cutoutEnabled() && !hintExpanded) {
|
|
openCutout();
|
|
}
|
|
}
|
|
}
|
|
|
|
private void collapseHint(boolean animate) {
|
|
if (animator != null && animator.isRunning()) {
|
|
animator.cancel();
|
|
}
|
|
if (animate && hintAnimationEnabled) {
|
|
animateToExpansionFraction(1f);
|
|
} else {
|
|
collapsingTextHelper.setExpansionFraction(1f);
|
|
}
|
|
hintExpanded = false;
|
|
if (cutoutEnabled()) {
|
|
openCutout();
|
|
}
|
|
}
|
|
|
|
private boolean cutoutEnabled() {
|
|
return hintEnabled && !TextUtils.isEmpty(hint) && boxBackground instanceof CutoutDrawable;
|
|
}
|
|
|
|
private void openCutout() {
|
|
if (!cutoutEnabled()) {
|
|
return;
|
|
}
|
|
final RectF cutoutBounds = tmpRectF;
|
|
collapsingTextHelper.getCollapsedTextActualBounds(cutoutBounds);
|
|
applyCutoutPadding(cutoutBounds);
|
|
((CutoutDrawable) boxBackground).setCutout(cutoutBounds);
|
|
}
|
|
|
|
private void closeCutout() {
|
|
if (cutoutEnabled()) {
|
|
((CutoutDrawable) boxBackground).removeCutout();
|
|
}
|
|
}
|
|
|
|
private void applyCutoutPadding(RectF cutoutBounds) {
|
|
cutoutBounds.left -= boxLabelCutoutPaddingPx;
|
|
cutoutBounds.top -= boxLabelCutoutPaddingPx;
|
|
cutoutBounds.right += boxLabelCutoutPaddingPx;
|
|
cutoutBounds.bottom += boxLabelCutoutPaddingPx;
|
|
}
|
|
|
|
@VisibleForTesting
|
|
boolean cutoutIsOpen() {
|
|
return cutoutEnabled() && ((CutoutDrawable) boxBackground).hasCutout();
|
|
}
|
|
|
|
@Override
|
|
protected void drawableStateChanged() {
|
|
if (inDrawableStateChanged) {
|
|
// Some of the calls below will update the drawable state of child views. Since we're
|
|
// using addStatesFromChildren we can get into infinite recursion, hence we'll just
|
|
// exit in this instance
|
|
return;
|
|
}
|
|
|
|
inDrawableStateChanged = true;
|
|
|
|
super.drawableStateChanged();
|
|
|
|
final int[] state = getDrawableState();
|
|
boolean changed = false;
|
|
|
|
// Drawable state has changed so see if we need to update the label
|
|
updateLabelState(ViewCompat.isLaidOut(this) && isEnabled());
|
|
|
|
updateEditTextBackground();
|
|
updateTextInputBoxBounds();
|
|
updateTextInputBoxState();
|
|
|
|
if (collapsingTextHelper != null) {
|
|
changed |= collapsingTextHelper.setState(state);
|
|
}
|
|
|
|
if (changed) {
|
|
invalidate();
|
|
}
|
|
|
|
inDrawableStateChanged = false;
|
|
}
|
|
|
|
void updateTextInputBoxState() {
|
|
if (boxBackground == null || boxBackgroundMode == BOX_BACKGROUND_NONE) {
|
|
return;
|
|
}
|
|
|
|
final boolean hasFocus = editText != null && editText.hasFocus();
|
|
final boolean isHovered = editText != null && editText.isHovered();
|
|
|
|
// Update the text box's stroke based on the current state.
|
|
if (boxBackgroundMode == BOX_BACKGROUND_OUTLINE) {
|
|
if (!isEnabled()) {
|
|
boxStrokeColor = disabledColor;
|
|
} else if (indicatorViewController.errorShouldBeShown()) {
|
|
boxStrokeColor = indicatorViewController.getErrorViewCurrentTextColor();
|
|
} else if (hasFocus) {
|
|
boxStrokeColor = focusedStrokeColor;
|
|
} else if (isHovered) {
|
|
boxStrokeColor = hoveredStrokeColor;
|
|
} else {
|
|
boxStrokeColor = defaultStrokeColor;
|
|
}
|
|
|
|
if ((isHovered || hasFocus) && isEnabled()) {
|
|
boxStrokeWidthPx = boxStrokeWidthFocusedPx;
|
|
} else {
|
|
boxStrokeWidthPx = boxStrokeWidthDefaultPx;
|
|
}
|
|
applyBoxAttributes();
|
|
}
|
|
}
|
|
|
|
private void expandHint(boolean animate) {
|
|
if (animator != null && animator.isRunning()) {
|
|
animator.cancel();
|
|
}
|
|
if (animate && hintAnimationEnabled) {
|
|
animateToExpansionFraction(0f);
|
|
} else {
|
|
collapsingTextHelper.setExpansionFraction(0f);
|
|
}
|
|
if (cutoutEnabled() && ((CutoutDrawable) boxBackground).hasCutout()) {
|
|
closeCutout();
|
|
}
|
|
hintExpanded = true;
|
|
}
|
|
|
|
@VisibleForTesting
|
|
void animateToExpansionFraction(final float target) {
|
|
if (collapsingTextHelper.getExpansionFraction() == target) {
|
|
return;
|
|
}
|
|
if (this.animator == null) {
|
|
this.animator = new ValueAnimator();
|
|
this.animator.setInterpolator(AnimationUtils.FAST_OUT_SLOW_IN_INTERPOLATOR);
|
|
this.animator.setDuration(LABEL_SCALE_ANIMATION_DURATION);
|
|
this.animator.addUpdateListener(
|
|
new ValueAnimator.AnimatorUpdateListener() {
|
|
@Override
|
|
public void onAnimationUpdate(ValueAnimator animator) {
|
|
collapsingTextHelper.setExpansionFraction((float) animator.getAnimatedValue());
|
|
}
|
|
});
|
|
}
|
|
this.animator.setFloatValues(collapsingTextHelper.getExpansionFraction(), target);
|
|
this.animator.start();
|
|
}
|
|
|
|
@VisibleForTesting
|
|
final boolean isHintExpanded() {
|
|
return hintExpanded;
|
|
}
|
|
|
|
@VisibleForTesting
|
|
final boolean isHelperTextDisplayed() {
|
|
return indicatorViewController.helperTextIsDisplayed();
|
|
}
|
|
|
|
@VisibleForTesting
|
|
final int getHintCurrentCollapsedTextColor() {
|
|
return collapsingTextHelper.getCurrentCollapsedTextColor();
|
|
}
|
|
|
|
@VisibleForTesting
|
|
final float getHintCollapsedTextHeight() {
|
|
return collapsingTextHelper.getCollapsedTextHeight();
|
|
}
|
|
|
|
@VisibleForTesting
|
|
final int getErrorTextCurrentColor() {
|
|
return indicatorViewController.getErrorViewCurrentTextColor();
|
|
}
|
|
|
|
/**
|
|
* An AccessibilityDelegate intended to be set on an {@link EditText} or {@link TextInputEditText}
|
|
* with {@link
|
|
* TextInputLayout#setTextInputAccessibilityDelegate(TextInputLayout.AccessibilityDelegate}} to
|
|
* provide attributes for accessibility that are managed by {@link TextInputLayout}.
|
|
*/
|
|
public static class AccessibilityDelegate extends AccessibilityDelegateCompat {
|
|
private final TextInputLayout layout;
|
|
|
|
public AccessibilityDelegate(TextInputLayout layout) {
|
|
this.layout = layout;
|
|
}
|
|
|
|
@Override
|
|
public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfoCompat info) {
|
|
super.onInitializeAccessibilityNodeInfo(host, info);
|
|
EditText editText = layout.getEditText();
|
|
CharSequence text = (editText != null) ? editText.getText() : null;
|
|
CharSequence hintText = layout.getHint();
|
|
CharSequence errorText = layout.getError();
|
|
boolean showingText = !TextUtils.isEmpty(text);
|
|
boolean hasHint = !TextUtils.isEmpty(hintText);
|
|
boolean showingError = !TextUtils.isEmpty(errorText);
|
|
|
|
if (showingText) {
|
|
info.setText(text);
|
|
} else if (hasHint) {
|
|
info.setText(hintText);
|
|
}
|
|
|
|
if (hasHint) {
|
|
info.setHintText(hintText);
|
|
info.setShowingHintText(!showingText && hasHint);
|
|
}
|
|
|
|
if (showingError) {
|
|
info.setError(errorText);
|
|
info.setContentInvalid(showingError);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
public void onPopulateAccessibilityEvent(View host, AccessibilityEvent event) {
|
|
super.onPopulateAccessibilityEvent(host, event);
|
|
EditText editText = layout.getEditText();
|
|
CharSequence text = (editText != null) ? editText.getText() : null;
|
|
CharSequence eventText = TextUtils.isEmpty(text) ? layout.getHint() : text;
|
|
if (!TextUtils.isEmpty(eventText)) {
|
|
event.getText().add(eventText);
|
|
}
|
|
}
|
|
}
|
|
}
|