Material Design 控件知识梳理(9) - TextInputLayout

Material Design 控件知识梳理(1) - Android Design Support Library 是什么
Material Design 控件知识梳理(2) - AppBarLayout & CollapsingToolbarLayout
Material Design 控件知识梳理(3) - BottomSheet && BottomSheetDialog && BottomSheetDialogFragment
Material Design 控件知识梳理(4) - FloatingActionButton
Material Design 控件知识梳理(5) - DrawerLayout && NavigationView
Material Design 控件知识梳理(6) - Snackbar
Material Design 控件知识梳理(7) - BottomNavigationBar
Material Design 控件知识梳理(8) - TabLayout
Material Design 控件知识梳理(9) - TextInputLayout

一、概述

TextInputLayout通过对EditText进行包装，扩展了EditText的功能，今天，我们就来介绍一下和TextInputLayout相关的知识：

• 输入检查
• 输入计数
• 密码隐藏

二、TextInputLayout

2.1 基本用法

• 首先，导入TextInputLayout的依赖包：

compile 'com.android.support:design:25.3.1'

• 之后，我们需要将TextInputLayout作为EditText的父容器以实现相关的功能，例如下面这样，我们的布局中有两个EditText，都使用TextInputLayout把它们包裹起来。

当EditText获得焦点的时候，android:hint所指定的字符串会以高亮的颜色显示在EditText的上方，而当EditText失去焦点时，hint会以灰显的方式显示在EditText中，这就是TextInputLayout最基本的使用，它让我们在输入的过程当中仍然可以获得当前EditText所关联的提示。

input_1.gif

2.2 输入检查

除了在EditText上面的提示之外，TextInputLayout还支持在EditText下方显示提示，这种一般用于用户在输入过程中，输入了不符合要求的文本，用来给予用户错误提示。

private void checkError() {
        mPasswordEditText.addTextChangedListener(new TextWatcher() {

            @Override public void beforeTextChanged(CharSequence s, int start, int count, int after) {}

            @Override public void onTextChanged(CharSequence s, int start, int before, int count) {}

            @Override public void afterTextChanged(Editable s) {
                int len = s.length();
                if (len > MAX_PASSWORD_LEN) {
                    mPasswordTextInput.setError("Max Password len is " + MAX_PASSWORD_LEN);
                } else {
                    mPasswordTextInput.setErrorEnabled(false);
                }
            }
        });
}

效果如下图所示：

在上面的例子中，我们通过监听 EditText的输入，然后在某个条件被触发时，调用 TextInputLayout的 setError方法，以提示用户，与 setError相关的方法有：

• public void setError(@Nullable final CharSequence error)
  设置错误提示的文字，它会被显示在EditText的下方
• public void setErrorTextAppearance(@StyleRes int resId)
  设置错误提示的文字颜色和大小
• public void setErrorEnabled(boolean enabled)
  设置错误提示是否可用

2.3 输入计数

TextInputLayout还支持对于输入框内字符的实时统计，并在字符数超过阈值之后，改变输入框及提示文字的颜色。

private void checkCount() {
        mPasswordTextInput.setCounterEnabled(true);
        mPasswordTextInput.setCounterMaxLength(MAX_PASSWORD_LEN);
}

与输入计数有关的方法有：

• public void setCounterEnabled(boolean enabled)
  设置计数功能是否可用
• public void setCounterMaxLength(int maxLength)
  设置计数功能的阈值

2.4 输入时隐藏密码

相信大家都有见到过这样的输入框，在输入框的右边有一个开关，可以让用户来决定输入过程中的字符是否隐藏（以*号显示），TextInputLayout也提供了这样的功能：
EditText的inputType为textPassword/textWebPassword/numberPassword时，通过下面的设置：

mPasswordTextInput.setPasswordVisibilityToggleEnabled(true);

同时，我们也可以通过上面的方法来定义切换的图标以及它的着色。

---

更多文章，欢迎访问我的 Android 知识梳理系列：

• Android 知识梳理目录：http://www.jianshu.com/p/fd82d18994ce
• 个人主页：http://lizejun.cn
• 个人知识总结目录：http://lizejun.cn/categories/