/* * Copyright (c) 2020, Andreas Kling * Copyright (c) 2026, Jelle Raaijmakers * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web { class WEB_API EventHandler { friend class AutoScrollHandler; public: explicit EventHandler(Badge, HTML::Navigable&); ~EventHandler(); void clear_mousedown_tracking(); void stop_updating_selection(); EventResult handle_mouseup(CSSPixelPoint, CSSPixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers); bool initiate_character_selection(DOM::Document&, Painting::HitTestResult const&, CSS::UserSelect, bool shift_held); bool initiate_word_selection(DOM::Document&, Painting::HitTestResult const&, CSS::UserSelect); bool initiate_paragraph_selection(DOM::Document&, Painting::HitTestResult const&, CSS::UserSelect); EventResult handle_mousedown(CSSPixelPoint, CSSPixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers, int click_count); EventResult handle_mousemove(CSSPixelPoint, CSSPixelPoint screen_position, unsigned buttons, unsigned modifiers); EventResult handle_mouseleave(); EventResult handle_mousewheel(CSSPixelPoint, CSSPixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers, int wheel_delta_x, int wheel_delta_y); EventResult handle_drag_and_drop_event(DragEvent::Type, CSSPixelPoint, CSSPixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers, Vector files); EventResult handle_pinch_event(CSSPixelPoint, double scale_delta); EventResult handle_keydown(UIEvents::KeyCode, unsigned modifiers, u32 code_point, bool repeat); EventResult handle_keyup(UIEvents::KeyCode, unsigned modifiers, u32 code_point, bool repeat); void process_auto_scroll(); EventResult handle_paste(Utf16String const& text); void handle_sdl_input_events(); void visit_edges(JS::Cell::Visitor& visitor) const; Unicode::Segmenter& word_segmenter(); enum class SelectionMode : u8 { None, Character, Word, Paragraph, }; bool is_handling_mouse_selection() const { return m_selection_mode != SelectionMode::None; } private: EventResult focus_next_element(); EventResult focus_previous_element(); GC::Ptr focus_candidate_for_position(CSSPixelPoint) const; EventResult fire_keyboard_event(FlyString const& event_name, HTML::Navigable&, UIEvents::KeyCode, unsigned modifiers, u32 code_point, bool repeat); [[nodiscard]] EventResult input_event(FlyString const& event_name, FlyString const& input_type, HTML::Navigable&, Variant code_point_or_string); CSSPixelPoint compute_mouse_event_client_offset(CSSPixelPoint event_page_position) const; CSSPixelPoint compute_mouse_event_page_offset(CSSPixelPoint event_client_offset) const; CSSPixelPoint compute_mouse_event_movement(CSSPixelPoint screen_position) const; struct Target { GC::Ptr paintable; GC::Ptr chrome_widget; Optional index_in_node; }; Optional target_for_mouse_position(CSSPixelPoint position); struct MouseEventCoordinates { CSSPixelPoint page_offset; CSSPixelPoint visual_viewport_position; CSSPixelPoint viewport_position; CSSPixelPoint offset; }; MouseEventCoordinates compute_mouse_event_coordinates(CSSPixelPoint visual_viewport_position, CSSPixelPoint viewport_position, Painting::Paintable const& paintable, Layout::Node const& layout_node) const; enum class PointerEventType : u8 { PointerDown, PointerUp, PointerMove, PointerCancel }; bool dispatch_a_pointer_event_for_a_device_that_supports_hover(PointerEventType, GC::Ptr, GC::Ptr, MouseEventCoordinates const&, CSSPixelPoint screen_position, CSSPixelPoint movement, unsigned button, unsigned buttons, unsigned modifiers, int click_count = 0); void track_the_effective_position_of_the_legacy_mouse_pointer(GC::Ptr); void update_cursor(GC::Ptr paintable, GC::Ptr host_element, GC::Ptr chrome_widget); bool dispatch_chrome_widget_pointer_event(GC::Ptr, FlyString const& type, unsigned button, CSSPixelPoint visual_viewport_position); void update_hovered_chrome_widget(GC::Ptr); bool fire_click_events(GC::Ref, MouseEventCoordinates const&, CSSPixelPoint screen_position, unsigned button, unsigned buttons, unsigned modifiers, int click_count); void run_activation_behavior(GC::Ref, unsigned button, unsigned modifiers); void maybe_show_context_menu(GC::Ref, MouseEventCoordinates const&, CSSPixelPoint screen_position, CSSPixelPoint viewport_position, unsigned buttons, unsigned modifiers); void run_mousedown_default_actions(DOM::Document&, CSSPixelPoint visual_viewport_position, CSSPixelPoint viewport_position, unsigned button, unsigned modifiers, int click_count); void update_mouse_selection(CSSPixelPoint visual_viewport_position); void apply_mouse_selection(CSSPixelPoint visual_viewport_position); GC::Ptr paint_root(); GC::Ptr paint_root() const; bool should_ignore_device_input_event() const; bool is_dragging_element() const; void handle_gamepad_connected(SDL_JoystickID); void handle_gamepad_updated(SDL_JoystickID); void handle_gamepad_disconnected(SDL_JoystickID); GC::Ref m_navigable; SelectionMode m_selection_mode { SelectionMode::None }; InputEventsTarget* m_mouse_selection_target { nullptr }; GC::Ptr m_selection_origin; GC::Ptr m_hovered_chrome_widget; GC::Ptr m_captured_chrome_widget; NonnullOwnPtr m_drag_and_drop_event_handler; GC::Weak m_effective_legacy_mouse_pointer_position; Optional m_mousedown_button; GC::Weak m_mousedown_target; Optional m_mousedown_visual_viewport_position; int m_mousedown_click_count { 0 }; // https://w3c.github.io/pointerevents/#the-pointerdown-event // The PREVENT MOUSE EVENT flag. // FIXME: This should be per-pointer, of which there can be multiple. Move it once multiple simultaneous pointer // inputs are supported. bool m_prevent_mouse_event { false }; Optional m_mousemove_previous_screen_position; OwnPtr m_word_segmenter; OwnPtr m_auto_scroll_handler; }; }