iOS WebCore的WebEvent和EventHandler

WebEvent是iOS专有的类，负责封装和携带从UIKit得到的系统事件信息，并由WebKit层的WAKResponder子类传递到WebCore的EventHandler。

UIKit层的逻辑可参考《iOS私有API（三） UIWebView下的手势识别器gestureRecognizer》，WebKit层的相关类可参考《WebCore::Widget浅探》。

开源码中WebEvent的声明为：

 

typedef enum {

    WebEventMouseDown,

    WebEventMouseUp,

    WebEventMouseMoved,

    

    WebEventScrollWheel,

    

    WebEventKeyDown,

    WebEventKeyUp,

    

    WebEventTouchBegin,

    WebEventTouchChange,

    WebEventTouchEnd,

    WebEventTouchCancel

} WebEventType;



typedef enum {

    WebEventTouchPhaseBegan,

    WebEventTouchPhaseMoved,

    WebEventTouchPhaseStationary,

    WebEventTouchPhaseEnded,

    WebEventTouchPhaseCancelled

} WebEventTouchPhaseType;



// These enum values are copied directly from GSEvent for compatibility.

typedef enum

{

    WebEventFlagMaskAlphaShift = 0x00010000,

    WebEventFlagMaskShift      = 0x00020000,

    WebEventFlagMaskControl    = 0x00040000,

    WebEventFlagMaskAlternate  = 0x00080000,

    WebEventFlagMaskCommand    = 0x00100000,

} WebEventFlagValues;

typedef unsigned WebEventFlags;



// These enum values are copied directly from GSEvent for compatibility.

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封装了4种事件：鼠标（手指）、键盘、滚轮、触摸，主要通过属性WebEventType type来区分。

 

鼠标事件主要由单击手势来触发，会产生mouseup，mousemove和mousedown事件。其中单击就是同一RunLoop内连贯的mousedown和mouseup，而mousemove是模拟事件，可触发mouseover消息。

键盘事件发生在编辑框内，按下iOS虚拟键盘的按键就会触发。

滚轮由双指平移手势触发，在输入框内有效。

触摸特指JavaScript监听的touchstart、gesturestart等消息，由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。可以猜测，接受WebEvent型参数的EventHandler函数也就只是简单做这个工作，转换后再直接调用通用的函数就ok了。如：

 

 

    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 ()

 

 

其它的Event都差不多，不再赘述了。