UITextField:inputAccessoryView 属性
inputAccessoryView 属性是键盘弹出时贴在键盘上面的视图。它跟着键盘一起出现和消失。最常见的是放一条 UIToolbar,上面一个「完成」按钮。
值
UIView,或者 null。
- 可读,可写。
- 默认值是
null。 - 读回来的是写进去的那个对象。
- 写
null或undefined是去掉。 - 它的宽度由系统拉到和键盘一样宽,高度用它自己的。工具条要先调
sizeToFit()量出自己的高度,新建的工具条高度是 0,不调它不占位置。未在模拟器验证。 - 同一个视图可以写给几个输入框,也可以同时写给搜索框和多行输入。
- 输入框正在输入时写入,当场生效;写
null当场去掉。输入框不会因此失去焦点。未在模拟器验证。 - 写进去的视图不要再用
addSubview()放进页面:键盘弹出时系统把它放到键盘上方,它在页面里原来的位置就没有了。未在模拟器验证。 - 没有变化事件:改它的只有 App 自己的代码。
写错时
- 写了不是视图的原生对象:抛
TypeError: inputAccessoryView needs a UIView or null。 - 写了数、字符串等普通值:抛
TypeError: inputAccessoryView needs a native object or null, got 5。
两种情况下原值不变。
示例
js
const field = new UITextField();
field.keyboardType = 'decimalPad';
const bar = new UIToolbar();
const done = UIBarButtonItem.systemItem('done');
done.addEventListener('click', () => field.resignFirstResponder());
bar.items = [UIBarButtonItem.flexibleSpace(), done];
bar.sizeToFit();
field.inputAccessoryView = bar;效果:点输入框弹出数字键盘,键盘上面多一条工具条,右端是「完成」。点它,键盘收起,工具条跟着消失。未在模拟器验证;验收用例里有「输入框聚焦之后这个视图出现在屏幕上」的断言,它们写完之后还没有运行过。
对应的 iOS API
UITextField.inputAccessoryView。换了之后不需要调 reloadInputViews,写入当场生效。