在设计 Android App 的时候,常常会需要让用户输入一些文字,但又不想要让用户输入太多文字,要怎么样才可以让文字输入框能够限制用户输入的长度呢?如果用户输入的文字不是只有半角字,而是还有全角字的话,又该怎么去计算文字长度呢?

以 EditText 这个 View 为例,如果要限制 EditText 输入文字的最大长度,可以设置它的「maxLength」属性。在 XML 下,可以替 EditText 加入这个属性,并指定最大的文字长度。如下面的 XML 语法,将 EditText 的可输入的最大字符数量限制在 10 个:

<EditText
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:maxLength="10" />

如果要用 Android SDK 的 Java 程序来写,会比较麻烦一点,可以写成这样:

editText.setFilters(new InputFilter[]{new InputFilter.LengthFilter(10)});

用以上的方式虽然可以快速地限制 EditText 的文字长度,但是却会发生半角字和全角字虽然数量一样,长度看起来却差很多的问题。如下图:

半角字与全角字长度差很多的 EditText

此时可以使用以下的解决方案。

MagicTextLengthWatcher

import android.text.Editable;
import android.text.TextWatcher;

/**
 * 限制文字输入的长度
 *
 * @author magiclen
 *
 */
public class MagicTextLengthWatcher implements TextWatcher {

    private int maxLength; // 保存最大的字符串长度
    private int currentEnd = 0; // 保存目前字符串改变的结束位置,例如:abcdefg变成abcd1234efg,变化的结束位置就在索引8

    public MagicTextLengthWatcher(final int maxLength) {
        setMaxLength(maxLength);
    }

    public final void setMaxLength(final int maxLength) {
        if (maxLength >= 0) {
            this.maxLength = maxLength;
        } else {
            this.maxLength = 0;
        }
    }

    public int getMaxLength() {
        return this.maxLength;
    }

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

    }

    @Override
    public void onTextChanged(final CharSequence s, final int start, final int before, final int count) {
        currentEnd = start + count; // 取得变化的结束位置
    }

    @Override
    public void afterTextChanged(final Editable s) {
        while (calculateLength(s) > maxLength) { // 若变化后的长度超过最大长度
            // 删除最后变化的字符
            currentEnd--;
            s.delete(currentEnd, currentEnd + 1);
        }
    }

    /**
     * 计算字符串的长度
     *
     * @param c 传入字符串
     *
     * @return 传回字符串长度
     */
    protected int calculateLength(final CharSequence c) {
        int len = 0;
        final int l = c.length();
        for (int i = 0; i < l; i++) {
            final char tmp = c.charAt(i);
            if (tmp >= 0x20 && tmp <= 0x7E) {
                // 字符值 32~126 是 ASCII 半角字符的范围
                len++;
            } else {
                // 非半角字符
                len += 2;
            }
        }
        return len;
    }
}

使用 MagicTextLengthWatcher 这个 TextWatcher,可以很轻易地限制 EditText 的文字长度。预设将一个半角字符的长度用 1 计算,一个全角字符的长度用 2 计算(一个全角字的长度等于两个半角字的意思)。使用方式如下:

editText.addTextChangedListener(new MagicTextLengthWatcher(10));