com.xuexiang.xui.widget.edittext.materialedittext

Class MaterialEditText

java.lang.Object

AppCompatEditText

com.xuexiang.xui.widget.edittext.materialedittext.MaterialEditText

public class MaterialEditText
extends AppCompatEditText

Material Design 输入框

Since:

2019/3/20 16:47

Author:

XUE

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MaterialEditText.FloatingLabelType

Field Summary

Fields

Modifier and Type	Field and Description
static int	FLOATING_LABEL_HIGHLIGHT
static int	FLOATING_LABEL_NONE
static int	FLOATING_LABEL_NORMAL

Constructor Summary

Constructors

Constructor and Description
MaterialEditText(android.content.Context context)
MaterialEditText(android.content.Context context, android.util.AttributeSet attrs)
MaterialEditText(android.content.Context context, android.util.AttributeSet attrs, int defStyleAttr)

Method Summary

Modifier and Type	Method and Description
MaterialEditText	addValidator(METValidator validator) Adds a new validator to the View's list of validators This will be checked with the others in validate()
void	clear() 清除内容
MaterialEditText	clearValidators()
android.graphics.Typeface	getAccentTypeface()
int	getBottomTextSize()
float	getCurrentBottomLines()
java.lang.String	getEditValue() 获取输入的内容
java.lang.CharSequence	getError()
int	getErrorColor()
float	getFloatingLabelFraction()
int	getFloatingLabelPadding()
java.lang.CharSequence	getFloatingLabelText()
int	getFloatingLabelTextColor()
int	getFloatingLabelTextSize()
float	getFocusFraction()
java.lang.String	getHelperText()
int	getHelperTextColor()
int	getInnerPaddingBottom() get inner bottom padding, not the real paddingBottom
int	getInnerPaddingLeft() get inner left padding, not the real paddingLeft
int	getInnerPaddingRight() get inner right padding, not the real paddingRight
int	getInnerPaddingTop() get inner top padding, not the real paddingTop
int	getMaxCharacters()
int	getMinBottomTextLines()
int	getMinCharacters()
int	getUnderlineColor() get the color of the underline for normal state
java.util.List<METValidator>	getValidators()
boolean	hasValidators()
boolean	isAutoValidate()
boolean	isCharactersCountValid()
boolean	isEmpty() 输入的内容是否为空
boolean	isFloatingLabelAlwaysShown()
boolean	isFloatingLabelAnimating()
boolean	isHelperTextAlwaysShown()
boolean	isHideUnderline()
boolean	isNotEmpty() 输入的内容是否不为空
boolean	isShowClearButton()
boolean	isShowPasswordButton()
boolean	isValid(java.lang.String regex) Deprecated. use the new validator interface to add your own custom validator
boolean	isValidateOnFocusLost()
protected void	onAttachedToWindow()
protected void	onDraw(android.graphics.Canvas canvas)
protected void	onLayout(boolean changed, int left, int top, int right, int bottom)
boolean	onTouchEvent(android.view.MotionEvent event)
MaterialEditText	setAccentTypeface(android.graphics.Typeface accentTypeface) Set typeface used for the accent texts (floating label, error/helper text, character counter, etc.)
MaterialEditText	setAllowEmpty(boolean allowEmpty, java.lang.String errorEmpty) 设置输入框是否允许为空
MaterialEditText	setAutoValidate(boolean autoValidate)
MaterialEditText	setBaseColor(int color)
void	setBottomTextSize(int size)
MaterialEditText	setCurrentBottomLines(float currentBottomLines)
void	setEnabled(boolean enabled)
void	setError(java.lang.CharSequence errorText)
MaterialEditText	setErrorColor(int color)
MaterialEditText	setFloatingLabel(int mode)
MaterialEditText	setFloatingLabelAlwaysShown(boolean floatingLabelAlwaysShown)
MaterialEditText	setFloatingLabelAnimating(boolean animating)
MaterialEditText	setFloatingLabelFraction(float floatingLabelFraction)
MaterialEditText	setFloatingLabelPadding(int padding)
MaterialEditText	setFloatingLabelText(java.lang.CharSequence floatingLabelText) Set the floating label text.
MaterialEditText	setFloatingLabelTextColor(int color)
MaterialEditText	setFloatingLabelTextSize(int size)
MaterialEditText	setFocusFraction(float focusFraction)
MaterialEditText	setHelperText(java.lang.CharSequence helperText)
MaterialEditText	setHelperTextAlwaysShown(boolean helperTextAlwaysShown)
MaterialEditText	setHelperTextColor(int color)
MaterialEditText	setHideUnderline(boolean hideUnderline) Set whether or not to hide the underline (shown by default).
MaterialEditText	setIconLeft(android.graphics.Bitmap bitmap)
MaterialEditText	setIconLeft(android.graphics.drawable.Drawable drawable)
MaterialEditText	setIconLeft(int res)
MaterialEditText	setIconRight(android.graphics.Bitmap bitmap)
MaterialEditText	setIconRight(android.graphics.drawable.Drawable drawable)
MaterialEditText	setIconRight(int res)
MaterialEditText	setLengthChecker(METLengthChecker lengthChecker)
MaterialEditText	setMaxCharacters(int max)
MaterialEditText	setMetHintTextColor(android.content.res.ColorStateList colors) Same function as #setHintTextColor(ColorStateList).
MaterialEditText	setMetHintTextColor(int color) Same function as #setHintTextColor(int).
MaterialEditText	setMetTextColor(android.content.res.ColorStateList colors) Same function as #setTextColor(ColorStateList).
MaterialEditText	setMetTextColor(int color) Same function as #setTextColor(int).
MaterialEditText	setMinBottomTextLines(int lines)
MaterialEditText	setMinCharacters(int min)
void	setOnFocusChangeListener(OnFocusChangeListener listener)
void	setPadding(int left, int top, int right, int bottom) Deprecated.
MaterialEditText	setPaddings(int left, int top, int right, int bottom) Use this method instead of setPadding(int, int, int, int) to automatically set the paddingTop and the paddingBottom correctly.
MaterialEditText	setPasswordTransformationMethod(android.text.method.PasswordTransformationMethod transformationMethod) 设置密码输入框的样式
MaterialEditText	setPrimaryColor(int color)
MaterialEditText	setShowClearButton(boolean show)
MaterialEditText	setSingleLineEllipsis()
MaterialEditText	setSingleLineEllipsis(boolean enabled)
void	setTypeface(android.graphics.Typeface typeface)
MaterialEditText	setUnderlineColor(int color) Set the color of the underline for normal state
MaterialEditText	setValidateOnFocusLost(boolean validate)
boolean	validate() Check all validators, sets the error text if not NOTE: this stops at the first validator to report invalid.
boolean	validate(java.lang.String regex, java.lang.CharSequence errorText) Deprecated. use the new validator interface to add your own custom validator
boolean	validateWith(METValidator validator) Run validation on a single validator instance

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FLOATING_LABEL_NONE

public static final int FLOATING_LABEL_NONE

See Also:

Constant Field Values

FLOATING_LABEL_NORMAL

public static final int FLOATING_LABEL_NORMAL

See Also:

Constant Field Values

FLOATING_LABEL_HIGHLIGHT

public static final int FLOATING_LABEL_HIGHLIGHT

See Also:

Constant Field Values

Constructor Detail

MaterialEditText

public MaterialEditText(android.content.Context context)

MaterialEditText

public MaterialEditText(android.content.Context context,
                        android.util.AttributeSet attrs)

MaterialEditText

public MaterialEditText(android.content.Context context,
                        android.util.AttributeSet attrs,
                        int defStyleAttr)

Method Detail

setIconLeft

public MaterialEditText setIconLeft(int res)

setIconLeft

public MaterialEditText setIconLeft(android.graphics.drawable.Drawable drawable)

setIconLeft

public MaterialEditText setIconLeft(android.graphics.Bitmap bitmap)

setIconRight

public MaterialEditText setIconRight(int res)

setIconRight

public MaterialEditText setIconRight(android.graphics.drawable.Drawable drawable)

setIconRight

public MaterialEditText setIconRight(android.graphics.Bitmap bitmap)

isShowClearButton

public boolean isShowClearButton()

isShowPasswordButton

public boolean isShowPasswordButton()

setShowClearButton

public MaterialEditText setShowClearButton(boolean show)

setPasswordTransformationMethod

public MaterialEditText setPasswordTransformationMethod(android.text.method.PasswordTransformationMethod transformationMethod)

设置密码输入框的样式

Parameters:

transformationMethod -

Returns:

getFloatingLabelFraction

public float getFloatingLabelFraction()

setFloatingLabelFraction

public MaterialEditText setFloatingLabelFraction(float floatingLabelFraction)

getFocusFraction

public float getFocusFraction()

setFocusFraction

public MaterialEditText setFocusFraction(float focusFraction)

getCurrentBottomLines

public float getCurrentBottomLines()

setCurrentBottomLines

public MaterialEditText setCurrentBottomLines(float currentBottomLines)

isFloatingLabelAlwaysShown

public boolean isFloatingLabelAlwaysShown()

setFloatingLabelAlwaysShown

public MaterialEditText setFloatingLabelAlwaysShown(boolean floatingLabelAlwaysShown)

isHelperTextAlwaysShown

public boolean isHelperTextAlwaysShown()

setHelperTextAlwaysShown

public MaterialEditText setHelperTextAlwaysShown(boolean helperTextAlwaysShown)

getAccentTypeface

public android.graphics.Typeface getAccentTypeface()

setAccentTypeface

public MaterialEditText setAccentTypeface(android.graphics.Typeface accentTypeface)

Set typeface used for the accent texts (floating label, error/helper text, character counter, etc.)

isHideUnderline

public boolean isHideUnderline()

setHideUnderline

public MaterialEditText setHideUnderline(boolean hideUnderline)

Set whether or not to hide the underline (shown by default).

The positions of text below will be adjusted accordingly (error/helper text, character counter, ellipses, etc.)

NOTE: You probably don't want to hide this if you have any subtext features of this enabled, as it can look weird to not have a dividing line between them.

getUnderlineColor

public int getUnderlineColor()

get the color of the underline for normal state

setUnderlineColor

public MaterialEditText setUnderlineColor(int color)

Set the color of the underline for normal state

Parameters:

color -

getFloatingLabelText

public java.lang.CharSequence getFloatingLabelText()

setFloatingLabelText

public MaterialEditText setFloatingLabelText(java.lang.CharSequence floatingLabelText)

Set the floating label text.

Pass null to force fallback to use hint's value.

Parameters:

floatingLabelText -

getFloatingLabelTextSize

public int getFloatingLabelTextSize()

setFloatingLabelTextSize

public MaterialEditText setFloatingLabelTextSize(int size)

getFloatingLabelTextColor

public int getFloatingLabelTextColor()

setFloatingLabelTextColor

public MaterialEditText setFloatingLabelTextColor(int color)

getBottomTextSize

public int getBottomTextSize()

setBottomTextSize

public void setBottomTextSize(int size)

setPadding

@Deprecated
public final void setPadding(int left,
                                         int top,
                                         int right,
                                         int bottom)

Deprecated.

use setPaddings(int, int, int, int) instead, or the paddingTop and the paddingBottom may be set incorrectly.

setPaddings

public MaterialEditText setPaddings(int left,
                                    int top,
                                    int right,
                                    int bottom)

Use this method instead of setPadding(int, int, int, int) to automatically set the paddingTop and the paddingBottom correctly.

onAttachedToWindow

protected void onAttachedToWindow()

onLayout

protected void onLayout(boolean changed,
                        int left,
                        int top,
                        int right,
                        int bottom)

getInnerPaddingTop

public int getInnerPaddingTop()

get inner top padding, not the real paddingTop

getInnerPaddingBottom

public int getInnerPaddingBottom()

get inner bottom padding, not the real paddingBottom

getInnerPaddingLeft

public int getInnerPaddingLeft()

get inner left padding, not the real paddingLeft

getInnerPaddingRight

public int getInnerPaddingRight()

get inner right padding, not the real paddingRight

isValidateOnFocusLost

public boolean isValidateOnFocusLost()

setValidateOnFocusLost

public MaterialEditText setValidateOnFocusLost(boolean validate)

setBaseColor

public MaterialEditText setBaseColor(int color)

setPrimaryColor

public MaterialEditText setPrimaryColor(int color)

setMetTextColor

public MaterialEditText setMetTextColor(int color)

Same function as #setTextColor(int). (Directly overriding the built-in one could cause some error, so use this method instead.)

setMetTextColor

public MaterialEditText setMetTextColor(android.content.res.ColorStateList colors)

Same function as #setTextColor(ColorStateList). (Directly overriding the built-in one could cause some error, so use this method instead.)

setMetHintTextColor

public MaterialEditText setMetHintTextColor(int color)

Same function as #setHintTextColor(int). (The built-in one is a final method that can't be overridden, so use this method instead.)

setMetHintTextColor

public MaterialEditText setMetHintTextColor(android.content.res.ColorStateList colors)

Same function as #setHintTextColor(ColorStateList). (The built-in one is a final method that can't be overridden, so use this method instead.)

setFloatingLabel

public MaterialEditText setFloatingLabel(int mode)

getFloatingLabelPadding

public int getFloatingLabelPadding()

setFloatingLabelPadding

public MaterialEditText setFloatingLabelPadding(int padding)

isFloatingLabelAnimating

public boolean isFloatingLabelAnimating()

setFloatingLabelAnimating

public MaterialEditText setFloatingLabelAnimating(boolean animating)

setSingleLineEllipsis

public MaterialEditText setSingleLineEllipsis()

setSingleLineEllipsis

public MaterialEditText setSingleLineEllipsis(boolean enabled)

getMaxCharacters

public int getMaxCharacters()

setMaxCharacters

public MaterialEditText setMaxCharacters(int max)

getMinCharacters

public int getMinCharacters()

setMinCharacters

public MaterialEditText setMinCharacters(int min)

getMinBottomTextLines

public int getMinBottomTextLines()

setMinBottomTextLines

public MaterialEditText setMinBottomTextLines(int lines)

isAutoValidate

public boolean isAutoValidate()

setAutoValidate

public MaterialEditText setAutoValidate(boolean autoValidate)

getErrorColor

public int getErrorColor()

setErrorColor

public MaterialEditText setErrorColor(int color)

setHelperText

public MaterialEditText setHelperText(java.lang.CharSequence helperText)

getHelperText

public java.lang.String getHelperText()

getHelperTextColor

public int getHelperTextColor()

setHelperTextColor

public MaterialEditText setHelperTextColor(int color)

setAllowEmpty

public MaterialEditText setAllowEmpty(boolean allowEmpty,
                                      java.lang.String errorEmpty)

设置输入框是否允许为空

Parameters:

allowEmpty -

errorEmpty -

Returns:

setError

public void setError(java.lang.CharSequence errorText)

getError

public java.lang.CharSequence getError()

isValid

@Deprecated
public boolean isValid(java.lang.String regex)

Deprecated. use the new validator interface to add your own custom validator

if the main text matches the regex

validate

@Deprecated
public boolean validate(java.lang.String regex,
                                    java.lang.CharSequence errorText)

Deprecated. use the new validator interface to add your own custom validator

check if the main text matches the regex, and set the error text if not.

Returns:

true if it matches the regex, false if not.

validateWith

public boolean validateWith(METValidator validator)

Run validation on a single validator instance

Parameters:

validator - Validator to check

Returns:

True if valid, false if not

validate

public boolean validate()

Check all validators, sets the error text if not

NOTE: this stops at the first validator to report invalid.

Returns:

True if all validators pass, false if not

hasValidators

public boolean hasValidators()

addValidator

public MaterialEditText addValidator(METValidator validator)

Adds a new validator to the View's list of validators

This will be checked with the others in validate()

Parameters:

validator - Validator to add

Returns:

This instance, for easy chaining

clearValidators

public MaterialEditText clearValidators()

getValidators

public java.util.List<METValidator> getValidators()

setLengthChecker

public MaterialEditText setLengthChecker(METLengthChecker lengthChecker)

clear

public void clear()

清除内容

getEditValue

public java.lang.String getEditValue()

获取输入的内容

Returns:

setEnabled

public void setEnabled(boolean enabled)

isEmpty

public boolean isEmpty()

输入的内容是否为空

Returns:

isNotEmpty

public boolean isNotEmpty()

输入的内容是否不为空

Returns:

setOnFocusChangeListener

public void setOnFocusChangeListener(OnFocusChangeListener listener)

onDraw

protected void onDraw(android.graphics.Canvas canvas)

isCharactersCountValid

public boolean isCharactersCountValid()

onTouchEvent

public boolean onTouchEvent(android.view.MotionEvent event)

setTypeface

public void setTypeface(android.graphics.Typeface typeface)