您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS WebCore 中的 WebEvent 與 EventHandler 剖析

編輯:iOS 開發綜合

WebEvent 是 iOS 平台專有的類,負責封裝並承載從 UIKit 取得的系統事件,再由 WebKit 層的 WAKResponder 子類一路傳遞到 WebCore 的 EventHandler。理解這條鏈路,是讀懂 UIWebView 事件機制的關鍵。

WebEvent 的定義

源碼中的聲明如下:

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 區分:

  • 鼠標事件:由單擊手勢觸發,產生 mouseup / mousemove / mousedown。單擊的定義是同一個 RunLoop 內連貫的 mousedown 與 mouseup,而 mousemove 屬模擬事件,用於觸發 mouseover。
  • 鍵盤事件:發生在編輯框內,按下 iOS 虛擬鍵盤的按鍵時觸發。
  • 滾輪事件:由雙指平移手勢觸發,在輸入框內有效。
  • 觸摸事件:特指 JavaScript 監聽的 touchstart、gesturestart 等消息,由 UIWebTouchEventsGestureRecognizer 計算得出。

這些事件觸發後,都會在主線程創建 WebEvent 對象,然後借助 GCD 切換到 WebThread 執行。

EventHandler 的接口

源碼的 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

另一個文件 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 這套機制。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved