Most visited

Recently visited

TextInputLayout

public class TextInputLayout
extends LinearLayout

java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.widget.LinearLayout
         ↳ android.support.design.widget.TextInputLayout


包含 EditText (或后代)以在由于用户输入文本而隐藏提示时显示浮动标签的布局。

还支持经由示出的误差 setErrorEnabled(boolean)setError(CharSequence) ,并且经由字符计数器 setCounterEnabled(boolean)

The 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:
 <android.support.design.widget.TextInputLayout
         android:layout_width="match_parent"
         android:layout_height="wrap_content">

     <android.support.design.widget.TextInputEditText
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:hint="@string/form_username"/>

 </android.support.design.widget.TextInputLayout>
 

Summary

XML attributes

android.support.design:counterEnabled Whether the layout is laid out as if the character counter will be displayed

可能是布尔值,如“ true ”或“ false ”。

android.support.design:counterMaxLength The max length to display in the character counter

可能是一个整数值,如“ 100 ”。

android.support.design:errorEnabled Whether the layout is laid out as if an error will be displayed

可能是布尔值,如“ true ”或“ false ”。

android.support.design:hintAnimationEnabled Whether to animate hint state changes. 
android.support.design:hintEnabled Whether the layout's floating label functionality is enabled

可能是布尔值,如“ true ”或“ false ”。

android.support.design:hintTextAppearance  
android:hint The hint to display in the floating label

可能是一个字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符;

Inherited XML attributes

From class android.widget.LinearLayout
From class android.view.ViewGroup
From class android.view.View

Inherited constants

From class android.widget.LinearLayout
From class android.view.ViewGroup
From class android.view.View

Inherited fields

From class android.view.View

Public constructors

TextInputLayout(Context context)
TextInputLayout(Context context, AttributeSet attrs)
TextInputLayout(Context context, AttributeSet attrs, int defStyleAttr)

Public methods

void addView(View child, int index, ViewGroup.LayoutParams params)

添加具有指定布局参数的子视图。

void draw(Canvas canvas)

手动将此视图(及其所有子项)呈现给定的Canvas。

int getCounterMaxLength()

返回字符计数器显示的最大长度。

EditText getEditText()

返回用于文本输入的 EditText

CharSequence getError()

如果未设置错误或未启用错误显示,则返回设置为与 setError(CharSequence)null一起显示的错误消息。

CharSequence getHint()

返回浮动标签中显示的提示(如果启用)。

Typeface getTypeface()

返回用于展开和浮动提示的字体。

boolean isCounterEnabled()

返回此布局中是否启用字符计数器功能。

boolean isErrorEnabled()

返回此布局中是否启用错误功能。

boolean isHintAnimationEnabled()

返回是否有任何提示状态由于焦点文本或非空文本而发生更改,都会生成动画。

boolean isHintEnabled()

返回此布局中是否启用浮动标签功能。

Parcelable onSaveInstanceState()

钩子允许视图生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。

void refreshDrawableState()

调用它来强制视图更新其可绘制状态。

void setCounterEnabled(boolean enabled)

在此布局中是否启用字符计数器功能。

void setCounterMaxLength(int maxLength)

设置字符计数器显示的最大长度。

void setError(CharSequence error)

设置将显示在我们的 EditText下方的错误消息。

void setErrorEnabled(boolean enabled)

在此布局中是否启用错误功能。

void setHint(CharSequence hint)

设置提示显示在浮动标签中(如果启用)。

void setHintAnimationEnabled(boolean enabled)

设置是否有任何提示状态由于聚焦或非空文本而发生变化,都会生成动画。

void setHintEnabled(boolean enabled)

设置此布局中是否启用浮动标签功能。

void setHintTextAppearance(int resId)

设置来自指定TextAppearance资源的提示文本颜色,大小,样式。

void setTypeface(Typeface typeface)

设置用于展开和浮动提示的字体。

Protected methods

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

当这个视图为每个孩子分配一个大小和位置时,从布局调用。

void onRestoreInstanceState(Parcelable state)

吊钩允许视图重新应用先前由 onSaveInstanceState()生成的其内部状态的表示。

Inherited methods

From class android.widget.LinearLayout
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.view.ViewParent
From interface android.view.ViewManager
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource

XML attributes

android.support.design:counterEnabled

布局是否按照字符计数器的显示布置

可能是布尔值,如“ true ”或“ false ”。

相关方法:

android.support.design:counterMaxLength

字符计数器中显示的最大长度

可能是一个整数值,如“ 100 ”。

相关方法:

android.support.design:errorEnabled

是否显示布局,就像显示错误一样

可能是布尔值,如“ true ”或“ false ”。

相关方法:

android.support.design:hintAnimationEnabled

是否动画提示状态更改。

可能是布尔值,例如“ true ”或“ false ”。

相关方法:

android.support.design:hintEnabled

是否启用布局的浮动标签功能

可能是一个布尔值,如“ true ”或“ false ”。

相关方法:

android.support.design:hintTextAppearance

相关方法:

android:hint

提示在浮动标签中显示

可能是一个字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符;

相关方法:

Public constructors

TextInputLayout

TextInputLayout (Context context)

Parameters
context Context

TextInputLayout

TextInputLayout (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

TextInputLayout

TextInputLayout (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

Public methods

addView

void addView (View child, 
                int index, 
                ViewGroup.LayoutParams params)

添加具有指定布局参数的子视图。

注意:不要调用此方法 draw(android.graphics.Canvas)onDraw(android.graphics.Canvas)dispatchDraw(android.graphics.Canvas)或任何相关方法。

Parameters
child View: the child view to add
index int: the position at which to add the child or -1 to add last
params ViewGroup.LayoutParams: the layout parameters to set on the child

draw

void draw (Canvas canvas)

手动将此视图(及其所有子项)呈现给定的Canvas。 在调用这个函数之前,视图必须已经完成了一个完整的布局。 在实现视图时,实现onDraw(android.graphics.Canvas)而不是重写此方法。 如果您确实需要重写此方法,请调用超类版本。

Parameters
canvas Canvas: The Canvas to which the View is rendered.

getCounterMaxLength

int getCounterMaxLength ()

返回字符计数器显示的最大长度。

相关XML属性:

Returns
int

getEditText

EditText getEditText ()

返回用于文本输入的 EditText

Returns
EditText

getError

CharSequence getError ()

如果未设置错误或未启用错误显示,则返回设置为 setError(CharSequence)null显示的错误消息。

Returns
CharSequence

也可以看看:

getHint

CharSequence getHint ()

返回浮动标签中显示的提示(如果启用)。

相关XML属性:

Returns
CharSequence the hint, or null if there isn't one set, or the hint is not enabled.

getTypeface

Typeface getTypeface ()

返回用于展开和浮动提示的字体。

Returns
Typeface

isCounterEnabled

boolean isCounterEnabled ()

返回此布局中是否启用字符计数器功能。

相关XML属性:

Returns
boolean

也可以看看:

isErrorEnabled

boolean isErrorEnabled ()

返回此布局中是否启用错误功能。

相关XML属性:

Returns
boolean

也可以看看:

isHintAnimationEnabled

boolean isHintAnimationEnabled ()

返回是否有任何提示状态由于焦点文本或非空文本而发生更改,都会生成动画。

相关XML属性:

Returns
boolean

也可以看看:

isHintEnabled

boolean isHintEnabled ()

返回此布局中是否启用浮动标签功能。

相关XML属性:

Returns
boolean

也可以看看:

onSaveInstanceState

Parcelable onSaveInstanceState ()

钩子允许视图生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。 此状态应仅包含不持久或以后不能重建的信息。 例如,您永远不会将当前位置存储在屏幕上,因为当视图的新实例放置在其视图层次结构中时会再次计算该位置。

您可能在此处存储的某些示例:文本视图中的当前光标位置(但通常不是文本本身,因为它存储在内容提供程序或其他永久性存储中),即当前在列表视图中选择的项目。

Returns
Parcelable Returns a Parcelable object containing the view's current dynamic state, or null if there is nothing interesting to save. The default implementation returns null.

refreshDrawableState

void refreshDrawableState ()

调用它来强制视图更新其可绘制状态。 这将导致在此视图上调用drawableStateChanged。 对新状态感兴趣的视图应该调用getDrawableState。

setCounterEnabled

void setCounterEnabled (boolean enabled)

在此布局中是否启用字符计数器功能。

相关XML属性:

Parameters
enabled boolean

setCounterMaxLength

void setCounterMaxLength (int maxLength)

设置字符计数器显示的最大长度。

相关XML属性:

Parameters
maxLength int: maxLength to display. Any value less than or equal to 0 will not be shown.

setError

void setError (CharSequence error)

设置将显示在我们的EditText下方的错误消息。 如果errornull ,则会清除错误消息。

如果错误功能尚未通过 setErrorEnabled(boolean)启用,则 error不为空时它将自动启用。

Parameters
error CharSequence: Error message to display, or null to clear

也可以看看:

setErrorEnabled

void setErrorEnabled (boolean enabled)

在此布局中是否启用错误功能。 在通过setError(CharSequence)设置错误消息之前启用此功能,将意味着此布局在显示错误时不会更改大小。

相关XML属性:

Parameters
enabled boolean

setHint

void setHint (CharSequence hint)

设置提示显示在浮动标签中(如果启用)。

相关XML属性:

Parameters
hint CharSequence

也可以看看:

setHintAnimationEnabled

void setHintAnimationEnabled (boolean enabled)

设置是否有任何提示状态由于聚焦或非空文本而发生变化,都会生成动画。

相关XML属性:

Parameters
enabled boolean

也可以看看:

setHintEnabled

void setHintEnabled (boolean enabled)

设置此布局中是否启用浮动标签功能。

如果启用,子EditText中的任何非空提示将被移到浮动提示中,并且其现有提示将被清除。 如果禁用,则此布局中的任何非空浮动提示都将移至EditText中,并且此布局的提示将被清除。

相关XML属性:

Parameters
enabled boolean

也可以看看:

setHintTextAppearance

void setHintTextAppearance (int resId)

设置来自指定TextAppearance资源的提示文本颜色,大小,样式。

相关XML属性:

Parameters
resId int

setTypeface

void setTypeface (Typeface typeface)

设置用于展开和浮动提示的字体。

Parameters
typeface Typeface: typeface to use, or null to use the default.

Protected methods

onLayout

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

当这个视图为每个孩子分配一个大小和位置时,从布局调用。 带孩子的派生类应该覆盖这个方法,并调用他们每个孩子的布局。

Parameters
changed boolean: This is a new size or position for this view
left int: Left position, relative to parent
top int: Top position, relative to parent
right int: Right position, relative to parent
bottom int: Bottom position, relative to parent

onRestoreInstanceState

void onRestoreInstanceState (Parcelable state)

吊钩允许视图重新应用先前由onSaveInstanceState()生成的内部状态的表示。 这个函数永远不会被调用为null状态。

Parameters
state Parcelable: The frozen state that had previously been returned by onSaveInstanceState().

Hooray!