EditText 集锦 - 开发中常用的用法及遇到的各种坑

系统管理员 2022-03-19 03:36 371阅读 0赞

## 前言 ##

EditText ，文本输入框，一个再熟悉不过的的控件，在开发当中，我们需要经常用到。这边文章，主要是记录 EditText 的常用用法，需要的时候可以直接复制张贴，提高效率。同时，本文章会持续更新，建议收藏起来。

--------------------

## 常用的基本属性 ##

该片段的内容来自于

[重拾Android之路之EditText][Android_EditText]

EditText属性(API 24)

android:hint //设置hint提示文本

android:textColorHint //设置hint提示文字颜色

android:textColor //设置文字颜色

android:textSize //设置文本字体大小

android:textStyle //设置文本字体样式,bold(加粗),italic(倾斜),normal(默认是正常字体).

android:numeric //控制EditText输入数字的类型 decimal(浮点数),integer(正整数),signed(带+ -号的整数).注意:该属性在使用时提示已过时,建议使用android:inputType属性替代.

android:singleLine //设置是否单行输入 true(单行输入),false(会自动换行).注意:该属性在使用时提示已过时,建议使用android:maxLines="1"属性替代.

android:password=“true” //以密文的形式显示输入的文本.注意:该属性在使用时提示已过时,建议使用android:inputType属性替代.

android:textAlignment //设置EditText中文本显示的位置,center(居中),inherit(默认,居左边显示),viewStart(居左显示),viewEnd(居右显示),textStart(居左显示),textEnd(居右显示).这里需要注意的是最低支持的API版本是17,前两个可以在API14中使用,而后面使用就会报红线…

android:textColorHighlight //设置被选中字体的颜色.默认为 Theme 主题中的 “colorAccent”的颜色.

textCursorDrawable //设置被光标的颜色.默认为 Theme 主题中的 “colorAccent”的颜色.

android:textScaleX //设置文本的水平缩放系数.

android:typeface //设置hint提示文本的字体.normal(默认),monospace,sans,serif.这里就不解释了,大家试一下就能看出效果.

android:background //设置EditText背景."@null"设置背景为透明.当我们设置背景后,EditText的那条线就会消失.

android:textAppearance //设置文本的颜色,字体,大小和样式.

android:digits //设置只接收指定的文本内容.

android:phoneNumber=“true” //设置输入电话号码.注意:该属性在使用时提示已过时,建议使用android:inputType属性替代.

android:editable //设置EditText是否可以编辑.当你设置为true,会提示你该EditText已经是可编辑的.设置为false时会提示使用inputType替代.

android:inputType //设置文本的类型，用于帮助输入法显示合适的键盘类型.

android:maxLength //设置EditText最多接受的文本的个数.

android:lines //设置EditText显示的行数,设置两行就显示两行，即使第二行没有数据.

android:lineSpacingExtra //设置行间距.

android:lineSpacingMultiplier //设置行间距的倍数. 如设置成1.5倍.

--------------------

## 输入法相关 ##

**设置默认输入法**

有时候为了提高用户体验，在弹出输入法时需要设置默认的输入状态，比如单词应用弹出输入法时，输入法最好是在英文输入状态下。如果是字典应用，弹出输入法时最好是在中文输入状态下，Android 并没有提供设置默认的输入状态的接口，但我们可以通过如下方法一样能够达到想要的效果：

默认中文：

**mEditText.setInputType(EditorInfo.TYPE\_CLASS\_TEXT);**

默认英文：

**mEditText.setInputType(EditorInfo.TYPE\_TEXT\_VARIATION\_URI)**

**EditText 默认获取焦点**

EditText 默认获取焦点，并弹出键盘，这本来是默认的行为。但有些情况，会因为焦点被别的控件获取了，我们又想让它自动获取焦点，并自动弹出键盘。这时候，可以采用下面的方法

/** * EditText获取焦点并显示软键盘 */
        public static void showSoftInputFromWindow(Activity activity, EditText editText) { 
            editText.setFocusable(true);
            editText.setFocusableInTouchMode(true);
            editText.requestFocus();
            //显示软键盘
            activity.getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE);
            //如果上面的代码没有弹出软键盘 可以使用下面另一种方式
            //InputMethodManager imm = (InputMethodManager) activity.getSystemService(Context.INPUT_METHOD_SERVICE);
           // imm.showSoftInput(editText, 0); 
        }

**取消 EditText 默认获取焦点的行为**

在EditText的父级控件中找一个，添加这两个属性：

android:focusable="true" 
    android:focusableInTouchMode="true"

**监听输入法中的回车按钮**

比如， QQ， 讯飞，搜狗输入法下面有个回车按钮，有时候我们按下按钮，希望立即提交内容。这时候，可以通过监听输入法按下的 key 来实现

mEt.setOnKeyListener(new View.OnKeyListener() {
        @Override
        public boolean onKey(View v, int keyCode, KeyEvent event) {
            if (keyCode == KeyEvent.KEYCODE_ENTER && event.getAction() == KeyEvent.ACTION_UP) {
                Log.i(TAG, "手指弹起时执行确认功能");
                return true;
            }
    
            return false;
        }
    });

--------------------

## 限制输入框的输入内容 ##

**监听 EditText 的输入状态**

*  像新浪微博一样，提醒还可以输入多少字
 *  限制最多可以输入多少字

这些都可以通过监听 EditText TextChangedListener 实现

mInputEditTxt.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) { 
    			Log.i(TAG, "监听EditText输入内容的变化，在这里可以监听输入内容的长度。");
    		}
    
    		@Override
    		public void afterTextChanged(Editable s) { 
    				Log.i(TAG, "这里可以实现所输即所得，用户输入的同时可以立即在这里根据输入内容执行操作，显示搜索结果！");
    		}
    	});

**限制输入多少字符**

在开发当中，我们通常需要对 text 的输入字符进行限制输入，比如限制输入 30 个字符，虽然我们可以直接调用 setMaxLength  
方法来限制输入，但是这样会有一个问题，就是当你的 text 超过 30 个字符的时候，你调用 mEtText.setText ，这时候会报错。因此，最好，还是采用如下的方法， addTextChangedListener 监听文本变化，在字符串变化的时候对文本长度进行截取，

public static final int MAX_LEN = 30;
    
    if (!TextUtils.isEmpty(mValue)) { 
        int len = Math.min(mValue.length(), MAX_LEN);
        mValue = mValue.substring(0, len);
        mEtText.setText(mValue);
        mEtText.setSelection(mValue.length());
    }
    
    mEtText.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) { 
            Editable text = mEtText.getText();
            if (TextUtils.isEmpty(text)) { 
                return;
            }
    
            if (text.length() > MAX_LEN) { 
                mEtText.setText(text.subSequence(0, MAX_LEN));
                mEtText.setSelection(mEtText.getText().length());
            }
        }
    
        @Override
        public void afterTextChanged(Editable s) { 
    
        }
    });

**限制输入内容**

有时候，输入框中，我们想限制输入内容，比如禁止输入表情，禁止输入中文等，这时候，可以使用 editText.setFilters(filters) 的方法。下面，列举了一些常用的限制。

public class InputTxtFilter{ 
    	public static final int INPUT_TYPE_EN = 0x01;
    	public static final int INPUT_TYPE_CH = 0x02;
        private static final String[] SPELL = new String[]{ 
        	"a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z",
        	"ā","á","ǎ","à","ō","ó","ǒ","ò","ē","é","ě","è","ī","í","ǐ","ì","ū","ú","ǔ","ù","ǖ","ǘ","ǚ","ǜ","ü"
        };
        private static char[] chineseParam = new char[]{ '」','，','。','？','…','：','～','【','＃','、','％','＊','＆','＄','（','‘','’','“','”','『','〔','｛','【'
        	,'￥','￡','‖','〖','《','「','》','〗','】','｝','〕','』','”','）','！','；','—'};
        
        private InputTxtFilter( ){ 
        	
        }
        
    	public static void inputFilter( final Context context, final EditText editText, final int type, final int inputLimit){ 
    		InputFilter[] filters = new InputFilter[1];
    		filters[0] = new InputFilter.LengthFilter(inputLimit){ 
    			public CharSequence filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend){ 
    				boolean isRightCharater = false;
    				if(type == INPUT_TYPE_EN){ 
    					isRightCharater = isLetter(source.toString());
    				}else if(type == INPUT_TYPE_CH){ 
    					isRightCharater = isChineseWord(source.toString());
    				}
    				
    				if ( !isRightCharater|| dest.toString( ).length( )>=inputLimit ){ 
    					return "";
    				}
    
    				return source;
    			}
    		};
    		editText.setFilters(filters);
    	}
    	
    	/** * 检测String是否全是中文 * */
    	public static boolean isChineseWord( String name ){ 
    		boolean res=true;
    		char[] cTemp = name.toCharArray( );
    		
    		for( int i = 0; i < name.length( ); i++ ){ 
    			if( !isChinese( cTemp[ i ] ) ){ 
    				res=false;
    				break;
    			}
    		}
    		
    		return res;
    	}
    	
    	/** * 是否为英文字母 * * */
    	public static boolean isLetter( String inputStr ){ 
    		char[] inputArray = inputStr.toCharArray( );
    		List<String> spellList = Arrays.asList( SPELL );
    		
    		for( char input : inputArray ){ 
    			if( !spellList.contains( input + "" ) ){ 
    				return false;
    			}
    		}
    		
    		return true;
    	}
    	
    	/** * 判定输入汉字 * @param c */
        public static boolean isChinese( char c ){ 
        	for( char param : chineseParam ){ 
            	if( param == c ){ 
            		return false;
            	}
            }
        	
            Character.UnicodeBlock ub = Character.UnicodeBlock.of( c );
            if ( ub == Character.UnicodeBlock.CJK_UNIFIED_IDEOGRAPHS
                || ub == Character.UnicodeBlock.CJK_COMPATIBILITY_IDEOGRAPHS
                || ub == Character.UnicodeBlock.CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A
                || ub == Character.UnicodeBlock.GENERAL_PUNCTUATION
                || ub == Character.UnicodeBlock.CJK_SYMBOLS_AND_PUNCTUATION
                || ub == Character.UnicodeBlock.HALFWIDTH_AND_FULLWIDTH_FORMS ){ 
                return true;
            }
            
            return false;
        }
    }

**InputTxtFilter.inputFilter(this, mInputEditTxt, InputTxtFilter.INPUT_TYPE_EN, 5);**

--------------------

## 常见的坑 ##

### Android:EditText设置密码可见与不可见 ###

//从密码不可见模式变为密码可见模式（行得通）
    et_password.setInputType(InputType.TYPE_TEXT_VARIATION_VISIBLE_PASSWORD);
    //从密码可见模式变为密码不可见模式（行不通）
     et_password.setInputType(InputType.TYPE_TEXT_VARIATION_PASSWORD);

解决方法 ：动态修改TransformationMethod

//从密码不可见模式变为密码可见模式
    et_password.setTransformationMethod(HideReturnsTransformationMethod.getInstance());
     //从密码可见模式变为密码不可见模式
    et_password.setTransformationMethod(PasswordTransformationMethod.getInstance())

--------------------

## 题外话 ##

今天 214 情人节，你有对象了吗？如果碰到心仪的人，大胆去追求吧。不要一直藏着掖着，这样，在将来的某一天，你肯定会后悔的。

--------------------

**Android 技术人，希望让你看到程序猿不同的一面，除了分享 Coding，，还有职场心得，面试经验，学习心得，人生感悟等等。希望通过该公众号，让大家看到，我们不只会敲代码，我们还会。。。。。。**

![Android 技术人][Android]

[Android_EditText]: https://www.jianshu.com/p/30f8cd810e75
[Android]: /images/20220319/70ec4d4d2c014dbc8441e28838c1ab70.png