WebEvent 是 iOS 平台專有的類,負責封裝並承載從 UIKit 取得的系統事件,再由 WebKit 層的 WAKResponder 子類一路傳遞到 WebCore 的 EventHandler。理解這條鏈路,是讀懂 UIWebView 事件機制的關鍵。
源碼中的聲明如下:
typedef enum {
WebEventMouseDown,
WebEventMouseUp,
WebEventMouseMoved,
WebEventScrollWheel,
WebEventKeyDown,
WebEventKeyUp,
WebEventTouchBegin,
WebEventTouchChange,
WebEventTouchEnd,
WebEventTouchCancel
} WebEventType;
typedef enum {
WebEventTouchPhaseBegan,
WebEventTouchPhaseMoved,
WebEventTouchPhaseStationary,
WebEventTouchPhaseEnded,
WebEventTouchPhaseCancelled
} WebEventTouchPhaseType;
// 以下枚舉值直接複製自 GSEvent,以保持兼容
typedef enum {
WebEventFlagMaskAlphaShift = 0x00010000,
WebEventFlagMaskShift = 0x00020000,
WebEventFlagMaskControl = 0x00040000,
WebEventFlagMaskAlternate = 0x00080000,
WebEventFlagMaskCommand = 0x00100000,
} WebEventFlagValues;
typedef unsigned WebEventFlags;
typedef enum {
WebEventCharacterSetASCII = 0,
WebEventCharacterSetSymbol = 1,
WebEventCharacterSetDingbats = 2,
WebEventCharacterSetUnicode = 253,
WebEventCharacterSetFunctionKeys = 254,
} WebEventCharacterSet;
@interface WebEvent : NSObject {
@private
WebEventType _type;
CFTimeInterval _timestamp;
CGPoint _locationInWindow;
NSString *_characters;
NSString *_charactersIgnoringModifiers;
WebEventFlags _modifierFlags;
BOOL _keyRepeating;
BOOL _popupVariant;
uint16_t _keyCode;
BOOL _tabKey;
WebEventCharacterSet _characterSet;
float _deltaX;
float _deltaY;
unsigned _touchCount;
NSArray *_touchLocations;
NSArray *_touchIdentifiers;
NSArray *_touchPhases;
BOOL _isGesture;
float _gestureScale;
float _gestureRotation;
}
- (WebEvent *)initWithMouseEventType:(WebEventType)type
timeStamp:(CFTimeInterval)timeStamp
location:(CGPoint)point;
- (WebEvent *)initWithScrollWheelEventWithTimeStamp:(CFTimeInterval)timeStamp
location:(CGPoint)point
deltaX:(float)deltaX
deltaY:(float)deltaY;
- (WebEvent *)initWithTouchEventType:(WebEventType)type
timeStamp:(CFTimeInterval)timeStamp
location:(CGPoint)point
modifiers:(WebEventFlags)modifiers
touchCount:(unsigned)touchCount
touchLocations:(NSArray *)touchLocations
touchIdentifiers:(NSArray *)touchIdentifiers
touchPhases:(NSArray *)touchPhases
isGesture:(BOOL)isGesture
gestureScale:(float)gestureScale
gestureRotation:(float)gestureRotation;
- (WebEvent *)initWithKeyEventType:(WebEventType)type
timeStamp:(CFTimeInterval)timeStamp
characters:(NSString *)characters
charactersIgnoringModifiers:(NSString *)charactersIgnoringModifiers
modifiers:(WebEventFlags)modifiers
isRepeating:(BOOL)repeating
isPopupVariant:(BOOL)popupVariant
keyCode:(uint16_t)keyCode
isTabKey:(BOOL)tabKey
characterSet:(WebEventCharacterSet)characterSet;
@property(nonatomic, readonly) WebEventType type;
@property(nonatomic, readonly) CFTimeInterval timestamp;
// Mouse
@property(nonatomic, readonly) CGPoint locationInWindow;
// Keyboard
@property(nonatomic, readonly, retain) NSString *characters;
@property(nonatomic, readonly, retain) NSString *charactersIgnoringModifiers;
@property(nonatomic, readonly) WebEventFlags modifierFlags;
@property(nonatomic, readonly, getter=isKeyRepeating) BOOL keyRepeating;
@property(nonatomic, readonly, getter=isPopupVariant) BOOL popupVariant;
@property(nonatomic, readonly) uint16_t keyCode;
@property(nonatomic, readonly, getter=isTabKey) BOOL tabKey;
@property(nonatomic, readonly) WebEventCharacterSet characterSet;
// Scroll Wheel
@property(nonatomic, readonly) float deltaX;
@property(nonatomic, readonly) float deltaY;
// Touch
@property(nonatomic, readonly) unsigned touchCount;
@property(nonatomic, readonly, retain) NSArray *touchLocations;
@property(nonatomic, readonly, retain) NSArray *touchIdentifiers;
@property(nonatomic, readonly, retain) NSArray *touchPhases;
// Gesture
@property(nonatomic, readonly) BOOL isGesture;
@property(nonatomic, readonly) float gestureScale;
@property(nonatomic, readonly) float gestureRotation;
@end
WebEvent 封裝了四種事件,通過 WebEventType 區分:
UIWebTouchEventsGestureRecognizer 計算得出。這些事件觸發後,都會在主線程創建 WebEvent 對象,然後借助 GCD 切換到 WebThread 執行。
源碼的 EventHandler.h 中有這麼一段:
#if PLATFORM(MAC) && defined(__OBJC__)
void mouseDown(WebEvent *);
void mouseUp(WebEvent *);
void mouseMoved(WebEvent *);
bool keyEvent(WebEvent *);
bool wheelEvent(WebEvent *);
void touchEvent(WebEvent *);
static WebEvent *currentEvent();
#endif
用 xdb 也能找到同樣的聲明,但在 EventHandler 的實現文件裡卻遍尋不著——可見 Apple 並未完全公開 iOS 的源碼。
另一個文件 PlatformEventFactoryIOS.h 給出了這樣的聲明:
class PlatformEventFactory {
public:
static PlatformMouseEvent createPlatformMouseEvent(WebEvent *);
static PlatformWheelEvent createPlatformWheelEvent(WebEvent *);
static PlatformKeyboardEvent createPlatformKeyboardEvent(WebEvent *);
static PlatformTouchEvent createPlatformTouchEvent(WebEvent *);
};
這些函數的作用,是把 Objective-C 封裝的 WebEvent 轉換成 WebCore 中的 C++ PlatformEvent。由此可以合理推測:EventHandler 那些接收 WebEvent 的函數,做的事也不過是完成這層轉換,然後直接調用通用實現即可:
bool handleMousePressEvent(const PlatformMouseEvent &);
bool handleMouseMoveEvent(const PlatformMouseEvent &, HitTestResult *hoveredNode = 0, bool onlyUpdateScrollbars = false);
bool handleMouseReleaseEvent(const PlatformMouseEvent &);
bool handleWheelEvent(const PlatformWheelEvent &);
void defaultWheelEventHandler(Node *, WheelEvent *);
#if ENABLE(GESTURE_EVENTS)
bool handleGestureEvent(const PlatformGestureEvent &);
bool handleGestureTap(const PlatformGestureEvent &, Node *preTargetedNode = 0);
bool handleGestureScrollUpdate(const PlatformGestureEvent &);
#endif
Thread 4 WebThread, Queue : (null) #0 0x03385790 in WebCore::EventHandler::mouseMoved(WebCore::PlatformMouseEvent const&) () #1 0x0338ae0f in WebCore::EventHandler::mouseMoved(WebEvent*) () #2 0x02efd822 in -[WebHTMLView(WebPrivate) mouseMoved:] () #3 0x03f6c6ac in -[WAKView _selfHandleEvent:] () #4 0x03f6c603 in -[WAKView handleEvent:] () #5 0x03f6f94d in -[WAKWindow sendEventSynchronously:] () #6 0x03f6f75b in __23-[WAKWindow sendEvent:]_block_invoke () #7 0x03f83fe2 in _WebThreadRun () #8 0x03f83ee0 in WebThreadRun () #9 0x03f6f71c in -[WAKWindow sendEvent:] () #10 0x03f6fa0c in __46-[WAKWindow sendMouseMoveEvent:contentChange:]_block_invoke () #11 0x03f83fe2 in _WebThreadRun () #12 0x03f83ee0 in WebThreadRun () #13 0x03f6f9d2 in -[WAKWindow sendMouseMoveEvent:contentChange:] () #14 0x0023609d in __64-[UIWebDocumentView(Interaction) _sendMouseMoveAndAttemptClick:]_block_invoke () #15 0x03f844ea in HandleRunSource () #16 0x0226e33f in __CFRUNLOOP_IS_CALLING_OUT_TO_A_SOURCE0_PERFORM_FUNCTION__ () #17 0x0226dd95 in __CFRunLoopDoSources0 () #18 0x0228b124 in __CFRunLoopRun () #19 0x0228a59f in CFRunLoopRunSpecific () #20 0x0228a3eb in CFRunLoopRunInMode () #21 0x03f83c30 in RunWebThread(void*) () #22 0x05a5c65c in _pthread_body () #23 0x05a5c4e6 in _pthread_start ()
從棧上能清楚看到兩次 _WebThreadRun:一次是 UIWebDocumentView 主動把事件轉發給 WebThread,另一次是 WAKWindow 在 WebThread 內同步派發。整条鏈路是「UIKit 手勢 → UIWebDocumentView → WAKWindow → WAKView → WebHTMLView → EventHandler(C++) → WebCore」,中間隔著 Objective-C 與 C++ 兩套世界,PlatformEventFactory 正是那塊橋板。需要提醒的是,UIWebView 自 iOS 12 起已被蘋果標記為廢棄,新項目應改用 WKWebView,其事件處理同樣沿用 WebCore 這套機制。