UIFeedbackGenerator
UIFeedbackGenerator 表示一个触感反馈的生成器。触感反馈是手机配合界面变化发出的一次短促震动,比如按钮按下、开关拨动、操作成功或失败。震动的力度和节奏由系统预设,App 只选择用哪一种,不能指定震多久、震多强的波形。
UIFeedbackGenerator 是基类,不能直接用。触感反馈由它的三个子类提供,每个类对应一类场合:
| 类 | 表示什么 | 触发的方法 |
|---|---|---|
UIImpactFeedbackGenerator | 撞击:两个东西碰到一起 | impactOccurred() |
UISelectionFeedbackGenerator | 选择变了:从一项换到另一项 | selectionChanged() |
UINotificationFeedbackGenerator | 通知:一件事成功了、需要注意、失败了 | notificationOccurred() |
生成器只能用子类上的静态方法创建,创建时必须给出一个视图,表示这次反馈和界面上的哪个视图有关。生成器创建之后可以反复触发。调用触发的方法就发出一次震动。方法没有返回值,也没有「震完了」的通知。
继承关系:EventTarget → NSObject → UIFeedbackGenerator
按场合选哪个类、什么时候调 prepare(),见指南让手机震一下。
构造函数
不能用 new 创建。new UIFeedbackGenerator() 抛 TypeError: Illegal constructor: UIFeedbackGenerator has no public initializer; use one of its subclasses, e.g. UIImpactFeedbackGenerator.feedbackGeneratorWithStyle(style, { forView: view })。
用三个子类的静态方法创建。
实例方法
还继承 NSObject 的方法。
| 方法 | 说明 |
|---|---|
prepare() | 让系统的震动部件提前就绪,减小触发时的延迟。可以不调 |
什么时候没有震动
以下情况下调用触发的方法不报错,只是没有震动:
- 在模拟器上。 模拟器没有震动部件。创建生成器、调用各个方法、写错参数时的报错,在模拟器上都和真机一样,只是感受不到震动。
- 用户在系统设置里关掉了触感反馈。 App 查不到这个设置,也不需要查:照常调用即可。这一条未在模拟器验证,来自 iOS 的定义。
所以触感反馈只能作为补充。操作的结果必须同时在界面上表现出来,不能只靠震动告诉用户。
这一组页面里描述震感的句子(轻重、节奏的差别)都未在模拟器验证:真机(iPhone 14)上核对过的是调用被执行、没有报错,震感本身没有记录。
示例
下面的代码从空白 App 开始,在屏幕上放一个按钮。按下时震一下,松手时再给一个「成功」的震动。
application.addEventListener('sceneconnect', (e) => {
const win = new UIWindow(e.scene);
const page = new UIViewController();
page.view.backgroundColor = 'systemBackground';
win.rootViewController = page;
win.makeKeyAndVisible();
const button = UIButton.buttonWithType('system');
button.setTitle('提交', { forState: ['normal'] });
button.frame = new CGRect(40, 120, 200, 44);
page.view.addSubview(button);
const tap = UIImpactFeedbackGenerator.feedbackGeneratorWithStyle('medium', { forView: button });
const done = UINotificationFeedbackGenerator.feedbackGeneratorForView(button);
button.addEventListener('touchdown', () => {
tap.impactOccurred();
});
button.addEventListener('touchupinside', () => {
done.notificationOccurred('success');
});
});效果
- 屏幕左上方出现一个文字按钮「提交」。
- 手指按下时,手机短促地震一下。
- 在按钮上松手时,手机按系统给「成功」规定的节奏震动。
这段代码没有作为一个整体在模拟器运行过。在模拟器上运行时按钮照常出现,按下和松手都没有震动。
对应的 iOS API
| ObjC | JS |
|---|---|
[UIImpactFeedbackGenerator feedbackGeneratorWithStyle:UIImpactFeedbackStyleMedium forView:view] | UIImpactFeedbackGenerator.feedbackGeneratorWithStyle('medium', { forView: view }) |
[UISelectionFeedbackGenerator feedbackGeneratorForView:view] | UISelectionFeedbackGenerator.feedbackGeneratorForView(view) |
[[UIImpactFeedbackGenerator alloc] initWithStyle:UIImpactFeedbackStyleMedium] | 没有对应的写法。这个初始化方法已被 Apple 标为将废弃,用上面绑定视图的写法 |
[generator prepare] | generator.prepare() |
与浏览器的对照:
| 浏览器 | Nacre |
|---|---|
navigator.vibrate(200),指定震动的毫秒数 | 没有对应。只能从系统预设的几种震感里选 |
参见
- 让手机震一下:按场合选类、复用生成器、减小延迟
UIImpactFeedbackGenerator、UISelectionFeedbackGenerator、UINotificationFeedbackGenerator:三个子类UIControl:touchdown、touchupinside,触发震动的时机