UITextField:keyboardType 属性
keyboardType 属性决定用户点输入框时弹出哪种键盘。
值
字符串,下面 13 个之一:
| 取值 | 弹出的键盘 |
|---|---|
'default' | 当前输入法的标准键盘 |
'asciiCapable' | 只能输入英文字母、数字和符号的键盘 |
'numbersAndPunctuation' | 标准键盘,打开时显示数字和标点那一页 |
'url' | 输入网址用:有 .、/、.com 键,没有空格键 |
'numberPad' | 只有 0 到 9 |
'phonePad' | 电话拨号键盘:0 到 9、*、# |
'namePhonePad' | 输入人名或电话号码用:字母键盘,可以切到拨号键盘 |
'emailAddress' | 输入邮箱用:有 @ 和 . 键 |
'decimalPad' | 0 到 9 加一个小数点 |
'twitter' | 标准键盘加上 @ 和 # 键 |
'webSearch' | 输入搜索词或网址用:有空格键和 . 键 |
'asciiCapableNumberPad' | 只有 0 到 9,并且只输出 ASCII 数字 |
'alphabet' | 'asciiCapable' 的旧名字,效果相同 |
- 可读,可写。
- 默认值是
'default'。 - 各取值弹出的键盘未在模拟器验证。验收用例验证的是:每个取值能写入并读回,写错时属性保持原值并输出一条警告。
- 它只决定弹出哪种键盘,不校验内容。用户仍然可以粘贴别的字符进来,连着硬件键盘时也能打任何字符。需要校验时监听
beforeinput,或者在input里检查text。 'numberPad'、'decimalPad'、'phonePad'这几种键盘上没有回车键,用户没法按回车收起键盘。未在模拟器验证。 要另外提供收起键盘的方式,见收起键盘。- 没有变化事件:改它的只有 App 自己的代码。
写错时
写入不在取值表里的值:不抛异常,控制台输出一条警告,列出全部可用的值,属性保持原来的值。
[Nacre] keyboardType has no value "x"; expected one of: …, ignored示例
js
const field = new UITextField();
field.keyboardType = 'numberPad';
// @ts-expect-error 故意写错
field.keyboardType = 'numeric';
console.log(field.keyboardType);效果
- 点输入框时弹出只有 0 到 9 的数字键盘。未在模拟器验证。
- 控制台先输出警告
[Nacre] keyboardType has no value "numeric"; expected one of: …, ignored,省略号处是 13 个可用的值。 - 接着输出
numberPad:写错的赋值没有生效。
对应的 iOS API
UITextField.keyboardType。UIKeyboardTypeNumberPad 写成 'numberPad',其余同理。