mirror of
https://github.com/servo/servo.git
synced 2025-10-04 02:29:12 +01:00
19e41ab9f9
Add a `ClipboardDelegate` to the `WebView` API and a default implementation in libservo for this delegate that works on Mac, Windows, and Linux. Support for Android will be added in the future. This means that embedders do not need to do anything special to get clipboard support, but can choose to override it or implement it for other platforms. In addition, this adds support for handling fetches of clipboard contents and renames things to reflect that eventually other types of clipboard content will be supported. Part of this is removing the string argument from the `ClipboardEventType::Paste` enum because script will need to get other types of content from the clipboard than just a string. It now talks to the embedder to get this information directly. Signed-off-by: Martin Robinson <mrobinson@igalia.com>
75 lines
3.3 KiB
Rust
75 lines
3.3 KiB
Rust
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at https://mozilla.org/MPL/2.0/. */
|
|
|
|
use servo::webrender_api::units::DeviceIntRect;
|
|
use servo::{InputMethodType, LoadStatus, MediaSessionPlaybackState, PromptResult};
|
|
|
|
/// Callbacks. Implemented by embedder. Called by Servo.
|
|
pub trait HostTrait {
|
|
/// Show alert.
|
|
fn prompt_alert(&self, msg: String, trusted: bool);
|
|
/// Ask Yes/No question.
|
|
fn prompt_yes_no(&self, msg: String, trusted: bool) -> PromptResult;
|
|
/// Ask Ok/Cancel question.
|
|
fn prompt_ok_cancel(&self, msg: String, trusted: bool) -> PromptResult;
|
|
/// Ask for string
|
|
fn prompt_input(&self, msg: String, default: String, trusted: bool) -> Option<String>;
|
|
/// Show context menu
|
|
fn show_context_menu(&self, title: Option<String>, items: Vec<String>);
|
|
/// Notify that the load status of the page has changed.
|
|
/// Started:
|
|
/// - "Reload button" should be disabled.
|
|
/// - "Stop button" should be enabled.
|
|
/// - Throbber starts spinning.
|
|
/// Complete:
|
|
/// - "Reload button" should be enabled.
|
|
/// - "Stop button" should be disabled.
|
|
/// - Throbber stops spinning.
|
|
fn notify_load_status_changed(&self, load_status: LoadStatus);
|
|
/// Page title has changed.
|
|
fn on_title_changed(&self, title: Option<String>);
|
|
/// Allow Navigation.
|
|
fn on_allow_navigation(&self, url: String) -> bool;
|
|
/// Page URL has changed.
|
|
fn on_url_changed(&self, url: String);
|
|
/// Back/forward state has changed.
|
|
/// Back/forward buttons need to be disabled/enabled.
|
|
fn on_history_changed(&self, can_go_back: bool, can_go_forward: bool);
|
|
/// Page animation state has changed. If animating, it's recommended
|
|
/// that the embedder doesn't wait for the wake function to be called
|
|
/// to call perform_updates. Usually, it means doing:
|
|
/// ```rust
|
|
/// while true {
|
|
/// servo.perform_updates();
|
|
/// servo.present_if_needed();
|
|
/// }
|
|
/// ```
|
|
/// . This will end up calling flush
|
|
/// which will call swap_buffer which will be blocking long enough to limit
|
|
/// drawing at 60 FPS.
|
|
/// If not animating, call perform_updates only when needed (when the embedder
|
|
/// has events for Servo, or Servo has woken up the embedder event loop via
|
|
/// EventLoopWaker).
|
|
fn on_animating_changed(&self, animating: bool);
|
|
/// Servo finished shutting down.
|
|
fn on_shutdown_complete(&self);
|
|
/// A text input is focused.
|
|
fn on_ime_show(
|
|
&self,
|
|
input_type: InputMethodType,
|
|
text: Option<(String, i32)>,
|
|
multiline: bool,
|
|
bounds: DeviceIntRect,
|
|
);
|
|
/// Input lost focus
|
|
fn on_ime_hide(&self);
|
|
/// Called when we get the media session metadata/
|
|
fn on_media_session_metadata(&self, title: String, artist: String, album: String);
|
|
/// Called when the media session playback state changes.
|
|
fn on_media_session_playback_state_change(&self, state: MediaSessionPlaybackState);
|
|
/// Called when the media session position state is set.
|
|
fn on_media_session_set_position_state(&self, duration: f64, position: f64, playback_rate: f64);
|
|
/// Called when we get a panic message from constellation
|
|
fn on_panic(&self, reason: String, backtrace: Option<String>);
|
|
}
|