EditText 是很常見(jiàn)的控件,常見(jiàn)屬性是必須要了解的氏捞。
類(lèi)似 InputType 和 imeOptions 等屬性和軟鍵盤(pán)都有很強(qiáng)的互動(dòng)吃沪。
異常
java.lang.StringIndexOutOfBoundsException
出錯(cuò)堆棧:
- InputType
指定輸入數(shù)據(jù)類(lèi)型翠储,這個(gè)屬性會(huì)與軟鍵盤(pán)互動(dòng)爆哑。
<EditText
android:inputType=""
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
屬性一覽:
inputType | 說(shuō)明 |
---|---|
android:inputType="textUri" | URI格式 |
android:inputType="textEmailAddress" | 電子郵件地址格式 |
android:inputType="textEmailSubject" | 郵件主題格式 |
android:inputType="textPassword" | 密碼格式 |
android:inputType="number" | 數(shù)字格式 |
android:inputType="numberPassword" | 數(shù)字密碼格式 |
android:inputType="textVisiblePassword" | 密碼可見(jiàn)格式 |
android:inputType="textCapCharacters" | 前3個(gè)輸入普通字符 |
android:inputType="textCapWords" | 單詞首字母大小 |
android:inputType="textCapSentences" | 僅第一個(gè)字母大寫(xiě) |
android:inputType="textAutoCorrect" | 前兩個(gè)自動(dòng)完成 |
android:inputType="textAutoComplete" | 前兩個(gè)自動(dòng)完成 |
android:inputType="textMultiLine" | 多行輸入 |
android:inputType="textImeMultiLine" | 輸入法多行(不一定支持) |
android:inputType="textNoSuggestions" | 不提示 |
android:inputType="textShortMessage" | 短消息格式 |
android:inputType="textLongMessage" | 長(zhǎng)消息格式 |
android:inputType="textPersonName" | 人名格式 |
android:inputType="textPostalAddress" | 郵政格式 |
android:inputType="textWebEditText" | 作為網(wǎng)頁(yè)表單的文本格式 |
android:inputType="textFilter" | 文本篩選格式 |
android:inputType="textPhonetic" | 拼音輸入格式 |
android:inputType="numberSigned" | 有符號(hào)數(shù)字格式 |
android:inputType="numberDecimal" | 可以帶小數(shù)點(diǎn)的浮點(diǎn)格式 |
android:inputType="phone" | 撥號(hào)鍵盤(pán) |
android:inputType="datetime" | 日期時(shí)間鍵盤(pán) |
android:inputType="date" | 日期鍵盤(pán) |
android:inputType="time" | 時(shí)間鍵盤(pán) |
以上屬性會(huì)影響彈出的軟鍵盤(pán)的屬性洞难,
比如設(shè)置為 android:inputType="number"
的時(shí)候,軟鍵盤(pán)會(huì)自動(dòng)進(jìn)入到數(shù)字鍵盤(pán)揭朝。
設(shè)置為 android:inputType="textEmailSubject"
的時(shí)候队贱,軟鍵盤(pán)可能會(huì)提供一些快捷的按鈕:(與系統(tǒng)相關(guān))
inputType
也可以在代碼中設(shè)置
mEditText.setInputType(EditorInfo.TYPE_CLASS_TEXT);
mEditText.setInputType(EditorInfo.TYPE_TEXT_VARIATION_URI);//英文鍵盤(pán)
- 監(jiān)聽(tīng)函數(shù)
//輸入監(jiān)聽(tīng)
mEditText.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) {
//輸入過(guò)程中調(diào)用,可以獲取到輸入內(nèi)容到長(zhǎng)度
}
@Override
public void afterTextChanged(Editable s) {
//輸入完成后調(diào)用潭袱,獲取完整到輸入內(nèi)容
}
});
//軟鍵盤(pán)按鍵監(jiān)聽(tīng)
mEditText.setOnKeyListener(new OnKeyListener() {
@Override
public boolean onKey(View v, int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_ENTER && event.getAction() == KeyEvent.ACTION_UP) {
//按下 Enter 鍵
return true;
}
return false;
}
});
- imeOptions
決定軟鍵盤(pán)中 Enter 顯示的內(nèi)容和操作
/**
*
*actionSearch 搜索
*actionSend 發(fā)送
*actionNext 下一步
*actionDone 完成
*/
<EditText
android:imeOptions=""
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
值得一提是柱嫌,在沒(méi)有指定 InputType 的時(shí)候,imeOptions 屬性可能不起作用屯换。
這時(shí)候可以將 InputType 指定為 text编丘,或者 singleLine 設(shè)置為 true。
- 屏蔽系統(tǒng)自帶的長(zhǎng)按復(fù)制粘貼:
//低版本可以設(shè)置長(zhǎng)按監(jiān)聽(tīng)為 false 即可
mEditTxt.setLongClickable(false);
mEditTxt.setCustomSelectionActionModeCallback(new ActionMode.Callback() {
public boolean onCreateActionMode(ActionMode actionMode, Menu menu) {
return false;
}
public boolean onPrepareActionMode(ActionMode actionMode, Menu menu) {
return false;
}
public boolean onActionItemClicked(ActionMode actionMode, MenuItem menuItem) {
return false;
}
@Override
public void onDestroyActionMode(ActionMode mode) {
}
});
- 關(guān)閉軟鍵盤(pán)
//直接關(guān)閉軟鍵盤(pán)
InputMethodManager manager = (InputMethodManager)getSystemService(Context.INPUT_METHOD_SERVICE);
manager.hideSoftInputFromWindow(edit.getWindowToken(),0);
//EditText 失去焦點(diǎn)趟径,則軟鍵盤(pán)關(guān)閉
mEditText.clearFocus();
//EditText 不彈出軟鍵盤(pán)
mEditText.setInputType(InputType.TYPE_NULL);
- windowSoftInputMode
決定窗口與軟鍵盤(pán)的交互模式瘪吏。
在 AndroidManifest 中設(shè)置:
<activity
android:name=".main.MainActivity"
android:windowSoftInputMode="stateHidden|adjustResize" />
屬性一覽:
windowSoftInputMode | 說(shuō)明 |
---|---|
stateAlwaysVisible | 當(dāng)用戶選擇 Activity 時(shí) — 也就是說(shuō),當(dāng)用戶確實(shí)是向前導(dǎo)航到 Activity蜗巧,而不是因離開(kāi)另一 Activity 而返回時(shí) — 顯示軟鍵盤(pán)。 |
adjustUnspecified | 不指定 Activity 的主窗口是否調(diào)整尺寸以為軟鍵盤(pán)騰出空間蕾盯,或者窗口內(nèi)容是否進(jìn)行平移以在屏幕上顯露當(dāng)前焦點(diǎn)幕屹。 系統(tǒng)會(huì)根據(jù)窗口的內(nèi)容是否存在任何可滾動(dòng)其內(nèi)容的布局視圖來(lái)自動(dòng)選擇其中一種模式。 如果存在這樣的視圖级遭,窗口將進(jìn)行尺寸調(diào)整望拖,前提是可通過(guò)滾動(dòng)在較小區(qū)域內(nèi)看到窗口的所有內(nèi)容。這是對(duì)主窗口行為的默認(rèn)設(shè)置挫鸽。 |
adjustResize | 始終調(diào)整 Activity 主窗口的尺寸來(lái)為屏幕上的軟鍵盤(pán)騰出空間说敏。 |
adjustPan | 不調(diào)整 Activity 主窗口的尺寸來(lái)為軟鍵盤(pán)騰出空間, 而是自動(dòng)平移窗口的內(nèi)容丢郊,使當(dāng)前焦點(diǎn)永遠(yuǎn)不被鍵盤(pán)遮蓋盔沫,讓用戶始終都能看到其輸入的內(nèi)容。 這通常不如尺寸調(diào)正可取枫匾,因?yàn)橛脩艨赡苄枰P(guān)閉軟鍵盤(pán)以到達(dá)被遮蓋的窗口部分或與這些部分進(jìn)行交互架诞。 |
stateVisible | 在正常的適宜情況下(當(dāng)用戶向前導(dǎo)航到 Activity 的主窗口時(shí))顯示軟鍵盤(pán)。 |
stateAlwaysHidden | 當(dāng) Activity 的主窗口有輸入焦點(diǎn)時(shí)始終隱藏軟鍵盤(pán)干茉。 |
stateUnspecified | 不指定軟鍵盤(pán)的狀態(tài)(隱藏還是可見(jiàn))谴忧。 將由系統(tǒng)選擇合適的狀態(tài),或依賴主題中的設(shè)置。這是對(duì)軟鍵盤(pán)行為的默認(rèn)設(shè)置沾谓。 |
stateUnchanged | 當(dāng) Activity 轉(zhuǎn)至前臺(tái)時(shí)保留軟鍵盤(pán)最后所處的任何狀態(tài)委造,無(wú)論是可見(jiàn)還是隱藏。 |
stateHidden | 當(dāng)用戶選擇 Activity 時(shí) — 也就是說(shuō)均驶,當(dāng)用戶確實(shí)是向前導(dǎo)航到 Activity昏兆,而不是因離開(kāi)另一 Activity 而返回時(shí) — 隱藏軟鍵盤(pán)。 |
實(shí)際上關(guān)于軟鍵盤(pán)的遮擋的問(wèn)題有好幾種解決的方法辣恋,比如在跟布局上加一個(gè) ScrollView亮垫;或者監(jiān)聽(tīng)軟鍵盤(pán)的彈出以手動(dòng)移動(dòng)布局;
- 樣式
因?yàn)橛玫闹黝}自帶的 EditText 樣式和需求差的有點(diǎn)遠(yuǎn)伟骨,還好自定義并不麻煩:
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<item android:state_enabled="false">
<shape>
<stroke android:width="1.5px" android:color="@color/grayBg"></stroke>
<solid android:color="#efefef"></solid>
<corners android:radius="4dp"></corners>
</shape>
</item>
<item android:state_pressed="true">
<shape>
<stroke android:width="1.5px" android:color="@color/grayBg"></stroke>
<solid android:color="#efefef"></solid>
<corners android:radius="4dp"></corners>
</shape>
</item>
<item android:state_focused="true">
<shape>
<stroke android:width="1.5px" android:color="@color/colorPrimary"></stroke>
<solid android:color="@color/white"></solid>
<corners android:radius="4dp"></corners>
</shape>
</item>
<item >
<shape>
<stroke android:width="1.5px" android:color="@color/grayBg"></stroke>
<solid android:color="@color/white"></solid>
<corners android:radius="4dp"></corners>
</shape>
</item>
</selector>
- Dialog 中的 EditText 好像沒(méi)辦法自動(dòng)彈出軟鍵盤(pán):
dialog.setOnShowListener(new DialogInterface.OnShowListener() {
@Override
public void onShow(DialogInterface dialog) {
((InputMethodManager)getActivity().getSystemService(Context.INPUT_METHOD_SERVICE))
.showSoftInput(receiptEdit,InputMethodManager.SHOW_FORCED);
}
});
- android:selectAllOnFocus="true"
在獲取焦點(diǎn)時(shí)全選內(nèi)容饮潦。