EditText 是很常见的控件,常见属性是必须要了解的。
类似 InputType 和 imeOptions 等属性和软键盘都有很强的互动。
异常
java.lang.StringIndexOutOfBoundsException
出错堆栈:
- InputType
指定输入数据类型,这个属性会与软键盘互动。
<EditText
android:inputType=""
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
属性一览:
inputType | 说明 |
---|---|
android:inputType="textUri" | URI格式 |
android:inputType="textEmailAddress" | 电子邮件地址格式 |
android:inputType="textEmailSubject" | 邮件主题格式 |
android:inputType="textPassword" | 密码格式 |
android:inputType="number" | 数字格式 |
android:inputType="numberPassword" | 数字密码格式 |
android:inputType="textVisiblePassword" | 密码可见格式 |
android:inputType="textCapCharacters" | 前3个输入普通字符 |
android:inputType="textCapWords" | 单词首字母大小 |
android:inputType="textCapSentences" | 仅第一个字母大写 |
android:inputType="textAutoCorrect" | 前两个自动完成 |
android:inputType="textAutoComplete" | 前两个自动完成 |
android:inputType="textMultiLine" | 多行输入 |
android:inputType="textImeMultiLine" | 输入法多行(不一定支持) |
android:inputType="textNoSuggestions" | 不提示 |
android:inputType="textShortMessage" | 短消息格式 |
android:inputType="textLongMessage" | 长消息格式 |
android:inputType="textPersonName" | 人名格式 |
android:inputType="textPostalAddress" | 邮政格式 |
android:inputType="textWebEditText" | 作为网页表单的文本格式 |
android:inputType="textFilter" | 文本筛选格式 |
android:inputType="textPhonetic" | 拼音输入格式 |
android:inputType="numberSigned" | 有符号数字格式 |
android:inputType="numberDecimal" | 可以带小数点的浮点格式 |
android:inputType="phone" | 拨号键盘 |
android:inputType="datetime" | 日期时间键盘 |
android:inputType="date" | 日期键盘 |
android:inputType="time" | 时间键盘 |
以上属性会影响弹出的软键盘的属性,
比如设置为 android:inputType="number"
的时候,软键盘会自动进入到数字键盘。
设置为 android:inputType="textEmailSubject"
的时候,软键盘可能会提供一些快捷的按钮:(与系统相关)
也可以在代码中设置
mEditText.setInputType(EditorInfo.TYPE_CLASS_TEXT);
mEditText.setInputType(EditorInfo.TYPE_TEXT_VARIATION_URI);//英文键盘
- 监听函数
//输入监听
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) {
//输入过程中调用,可以获取到输入内容到长度
}
@Override
public void afterTextChanged(Editable s) {
//输入完成后调用,获取完整到输入内容
}
});
//软键盘按键监听
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
决定软键盘中 Enter 显示的内容和操作
/**
*
*actionSearch 搜索
*actionSend 发送
*actionNext 下一步
*actionDone 完成
*/
<EditText
android:imeOptions=""
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
值得一提是,在没有指定 InputType 的时候,imeOptions 属性可能不起作用。
这时候可以将 InputType 指定为 text,或者 singleLine 设置为 true。
- 屏蔽系统自带的长按复制粘贴:
//低版本可以设置长按监听为 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) {
}
});
- 关闭软键盘
//直接关闭软键盘
InputMethodManager manager = (InputMethodManager)getSystemService(Context.INPUT_METHOD_SERVICE);
manager.hideSoftInputFromWindow(edit.getWindowToken(),0);
//EditText 失去焦点,则软键盘关闭
mEditText.clearFocus();
//EditText 不弹出软键盘
mEditText.setInputType(InputType.TYPE_NULL);
- windowSoftInputMode
决定窗口与软键盘的交互模式。
在 AndroidManifest 中设置:
<activity
android:name=".main.MainActivity"
android:windowSoftInputMode="stateHidden|adjustResize" />
属性一览:
windowSoftInputMode | 说明 |
---|---|
stateAlwaysVisible | 当用户选择 Activity 时 — 也就是说,当用户确实是向前导航到 Activity,而不是因离开另一 Activity 而返回时 — 显示软键盘。 |
adjustUnspecified | 不指定 Activity 的主窗口是否调整尺寸以为软键盘腾出空间,或者窗口内容是否进行平移以在屏幕上显露当前焦点。 系统会根据窗口的内容是否存在任何可滚动其内容的布局视图来自动选择其中一种模式。 如果存在这样的视图,窗口将进行尺寸调整,前提是可通过滚动在较小区域内看到窗口的所有内容。这是对主窗口行为的默认设置。 |
adjustResize | 始终调整 Activity 主窗口的尺寸来为屏幕上的软键盘腾出空间。 |
adjustPan | 不调整 Activity 主窗口的尺寸来为软键盘腾出空间, 而是自动平移窗口的内容,使当前焦点永远不被键盘遮盖,让用户始终都能看到其输入的内容。 这通常不如尺寸调正可取,因为用户可能需要关闭软键盘以到达被遮盖的窗口部分或与这些部分进行交互。 |
stateVisible | 在正常的适宜情况下(当用户向前导航到 Activity 的主窗口时)显示软键盘。 |
stateAlwaysHidden | 当 Activity 的主窗口有输入焦点时始终隐藏软键盘。 |
stateUnspecified | 不指定软键盘的状态(隐藏还是可见)。 将由系统选择合适的状态,或依赖主题中的设置。这是对软键盘行为的默认设置。 |
stateUnchanged | 当 Activity 转至前台时保留软键盘最后所处的任何状态,无论是可见还是隐藏。 |
stateHidden | 当用户选择 Activity 时 — 也就是说,当用户确实是向前导航到 Activity,而不是因离开另一 Activity 而返回时 — 隐藏软键盘。 |
实际上关于软键盘的遮挡的问题有好几种解决的方法,比如在跟布局上加一个 ScrollView;或者监听软键盘的弹出以手动移动布局;
- 样式
因为用的主题自带的 EditText 样式和需求差的有点远,还好自定义并不麻烦:
<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 好像没办法自动弹出软键盘:
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"
在获取焦点时全选内容。