新控件之TextInputLayout

Design兼容包

  在Android M Preview发布后，我们获得了一个新的兼容包 —— Android Design Support Library（Android材料设计兼容包），
通过该兼容包的一些新控件，能够方便地实现材料设计风格的应用。

先看效果图：是不是很炫酷？

1. 实现 TextInputLayout

• 第一步: 创建一个新的项目

• 第二步 :导入Support Library

  要使用TextInputLayout控件，你需要导入两个Library。第一个是appcompat-v7,它确保material style可以向后兼容。第二个是Design Support Library。在你的build.gradle文件中，添加如下依赖：

dependencies {    compile 'com.android.support:design:22.2.0'    compile 'com.android.support:appcompat-v7:22.2.0'}

  如果Gradle没有自动询问同步项目，选择build菜单中的Make module ‘app’ ，或者按F9。这样Android Studio 编译系统会自动获取必要的资源，然后你就能够使用需要的类了。

• 第三步 :界面布局

  这个项目的用户界面非常简单。它显示了一个“欢迎”文字与两个EditText元素，一个是为用户名准备的，一个是为密码准备的。布局中还包含了一个触发登陆流程的按钮。背景颜色是扁平风格的灰色。

另一个重要的细节是记得正确设置EditText的inputType属性。第一个EditText的inputType应该设置成textEmail，而第二个应该设置成textPassword。下面是布局的样子：

<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:background="#e3e3e3"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:padding="@dimen/activity_horizontal_margin"    tools:context=".LoginActivity"    android:orientation="vertical">    <RelativeLayout        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:layout_weight="0.5"        android:orientation="vertical">        <TextView            android:layout_width="match_parent"            android:layout_height="wrap_content"            android:layout_centerInParent="true"            android:gravity="center"            android:text="Welcome"            android:textSize="30sp"            android:textColor="#333333"/>    </RelativeLayout>    <LinearLayout        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:layout_weight="0.5"        android:orientation="vertical">        <EditText            android:id="@+id/username"            android:layout_width="match_parent"            android:layout_height="wrap_content"            android:inputType="textEmailAddress"/>        <EditText                android:id="@+id/password"                android:layout_width="match_parent"                android:layout_height="wrap_content"                android:inputType="textPassword"/>        <Button            android:id="@+id/btn"            android:layout_marginTop="4dp"            android:layout_width="match_parent"            android:layout_height="wrap_content"            android:text="Login"/>    </LinearLayout></LinearLayout>

• 第四步: 使用TextInputLayout

  TextInputLayout控件和LinearLayout完全一样，它只是一个容器。跟ScrollView一样，TextInputLayout只接受一个子元素。子元素需要是一个EditText元素。

<android.support.design.widget.TextInputLayout    android:id="@+id/usernameWrapper"    android:layout_width="match_parent"    android:layout_height="wrap_content">    <EditText        android:id="@+id/username"        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:inputType="textEmailAddress"        android:hint="Username"/></android.support.design.widget.TextInputLayout>

  注意这里我在EditText中指定了另一个参数，hint。就如你知道的，这个属性允许你在EditText的内容为空的时候显示一个自定义的提示。一旦用户开始输入，hint会消失。这并不理想，因为用户丢失了他们输入信息的上下文提示。

  有了TextInputLayout，这将不再是问题。一个单一的EditText 在输入文字的时候会隐藏hint，而被包含在TextInputLayout中的EditText则会让hint变成一个在EditText上方的浮动标签。同时还包括一个漂亮的material动画。

接下来，我们对password输入框做同样的事情。

<android.support.design.widget.TextInputLayout    android:id="@+id/passwordWrapper"    android:layout_width="match_parent"    android:layout_height="wrap_content"    android:layout_below="@id/usernameWrapper"    android:layout_marginTop="4dp">    <EditText        android:id="@+id/password"        android:layout_width="match_parent"        android:layout_height="wrap_content"        android:inputType="textPassword"        android:hint="Password"/></android.support.design.widget.TextInputLayout>

  现在如果你运行应用，什么也不会发生。当然，EditText的hint会表现的跟预期一致。但是没有material动画也没有浮动标签。为什么会这样？我们还缺少一些代码。

• 第五步: 设置 Hints

  下面是setContentView方法，初始化对theTextInputLayout视图的引用。

final TextInputLayout usernameWrapper = (TextInputLayout) findViewById(R.id.usernameWrapper);final TextInputLayout passwordWrapper = (TextInputLayout) findViewById(R.id.passwordWrapper);

要让浮动标签动起来，你只需设置一个hint，使用setHint方法：

usernameWrapper.setHint("Username");passwordWrapper.setHint("Password");

然后你就完成了。你的登陆界面现在很好的遵循了material设计规范。运行项目查看你的登陆界面。

2. 处理错误

  TextInputLayout的另一个特色是它可以处理错误。通过验证输入，你可以防止用户输入无效的邮箱地址或者是太短的密码。如果没有验证，后台可能反馈回不正确的结果呈现给用户。对于用户来说既浪费了时间又体验不好。在发送到后台之前你应该先检查输入的正确性。

第一步: 实现 onClick 方法

  首先你需要处理按钮的点击。有许多方法处理按钮的点击。其中一种就是写一个自定义的方法然后在xml中通过onClick属性指定，我喜欢setOnClickListener的方式，但这只是个人喜好。

btn.setOnClickListener(new View.OnClickListener() {    @Override    public void onClick(View v) {    }});

  我们知道当这个方法调用之后，用户不再需要键盘。不幸的是，如果你不告诉它，安卓不会自动的隐藏虚拟键盘。在onClick方法体中调用hideKeyboard。

private void hideKeyboard() {    View view = getCurrentFocus();    if (view != null) {        ((InputMethodManager) getSystemService(Context.INPUT_METHOD_SERVICE)).            hideSoftInputFromWindow(view.getWindowToken(), InputMethodManager.HIDE_NOT_ALWAYS);    }}

第二步 : 输入验证

  在设置错误标签之前，我们需要定义什么是错误，什么不是。我们假设用户名必须是一个邮箱地址并且我们想阻止用户输入无效的邮箱地址。

  验证邮箱地址有点复杂。我们必须依赖正则表达式。如果你想也可以使用Apache Commons library。

我使用了Wikipedia 上关于邮箱验证的指导，写了如下的正则表达式。

/^[a-zA-Z0-9#_~!$&'()*+,;=:."(),:;<>@\[\]\\]+@[a-zA-Z0-9-]+(\.[a-zA-Z0-9-]+)*$/

注：这个正则表达式的意思我就不翻译了，如果你不熟悉正则表达式看了也没啥用。

因为我们想验证字符串，我必须依赖Pattern和Matcher两个类。includeava.util.regex 包。实现如下的方法：

private static final String EMAIL_PATTERN = "^[a-zA-Z0-9#_~!$&'()*+,;=:.\"(),:;<>@\\[\\]\\\\]+@[a-zA-Z0-9-]+(\\.[a-zA-Z0-9-]+)*$";private Pattern pattern = Pattern.compile(EMAIL_PATTERN);private Matcher matcher;public boolean validateEmail(String email) {    matcher = pattern.matcher(email);    return matcher.matches();}

密码的验证简单的多。很多组织为密码的验证采用了不同的策略，但是所有人都会限制最短长度。合理的密码应该不低于6个字符。

public boolean validatePassword(String password) {    return password.length() > 5;}

第三步: 获取数据

就如我说的，TextInputLayout只是一个容器，但是和LinearLayout和ScrollView不同，你可以使用一个特殊的方法获得子元素，getEditText，不需要使用findViewById。

public void onClick(View v) {
hideKeyboard();

String username = usernameWrapper.getEditText().getText().toString();String password = passwordWrapper.getEditText().getText().toString();// TODO: Checks// TODO: Login

}

第四步: 显示错误

  TextInputLayout的错误处理简单快速。需要的方法是setErrorEnabled和setError。

  setError设置一个红色的错误消息，显示在EditText的下面。如果传入的参数为null，错误消息将清空。并且它会改变整个EditText控件为红色。

  setErrorEnabled开启错误提醒功能。这直接影响到布局的大小，增加底部padding为错误标签让出空间。在setError设置错误消息之前开启这个功能意味着在显示错误的时候布局不会变化。你可以把这两个方法结合起来验证下我所说的。

  另一个有趣的事实是如果错误功能未开启但是你调用了传入非null参数的setError，那么setErrorEnabled(true)将自动被调用。

  现在我们定义了什么是错误的什么是正确的，也知道了如何获取EditText中的数据以及显示可能的错误，onClick方法的实现就很简单了。

public void onClick(View v) {    hideKeyboard();    String username = usernameWrapper.getEditText().getText().toString();    String password = usernameWrapper.getEditText().getText().toString();    if (!validateEmail(username)) {        usernameWrapper.setError("Not a valid email address!");    } else if (!validatePassword(password)) {        passwordWrapper.setError("Not a valid password!");    } else {        usernameWrapper.setErrorEnabled(false);        passwordWrapper.setErrorEnabled(false);        doLogin();    }}

我添加了一个doLogin方法，但是目前它是空的,在里面进行后续操作。

public void doLogin() {    Toast.makeText(getApplicationContext(), "OK! I'm performing login.", Toast.LENGTH_SHORT).show();    // TODO: login procedure; not within the scope of this tutorial.}

3. 样式

  你可能还想做最后一件事，改变TextInputLayout控件的颜色。默认AppCompact会把它设置成绿色的，但是很有可能这个颜色会和你的颜色主题（color palette）冲突。

  谷歌把Design Support Library写的很好。每一个控件的颜色都是直接通过主题颜色绘制的，在 style.xml 中指定。打开它添加colorAccent 到主题以改变表单的颜色。

<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">    <item name="colorAccent">#3498db</item></style>

总结 :

  本教程中，我们看到了如何实现新的布局元素TextInputLayout，多亏有了刚刚引入的Design Support Library。

  设计范例中，控件的实现需要让用户在输入的过程中不会丢失上下文信息，它是在去年跟Material Design一起被谷歌介绍的。在这之前，没有让开发者将这个控件应用到实际项目中的支持库。现在，如果你的应用有类似数据输入的地方，你终于可以完全遵循material design 了。