Struct WebView 

pub struct WebView<Engine, Message>
where
    Engine: Engine,
{ /* private fields */ }

The Advanced WebView widget that creates and shows webview(s).

Important: You must drive the webview with a periodic Action::Update / Action::UpdateAll subscription (e.g. via iced::time::every). Without it the webview will never render and the screen stays blank.

fn subscription(&self) -> iced::Subscription<Message> {
    iced::time::every(std::time::Duration::from_millis(16))
        .map(|_| Message::WebView(Action::UpdateAll))
}

Implementations

impl<Engine: Engine + Default, Message: Send + Clone + 'static> WebView<Engine, Message>

pub fn new() -> Self

Create new Advanced Webview widget

pub fn set_scale_factor(&mut self, scale: f32)

Set the display scale factor for HiDPI rendering.

pub fn on_create_view( self, on_create_view: impl Fn(usize) -> Message + 'static, ) -> Self

Subscribe to create view events

pub fn on_close_view( self, on_close_view: impl Fn(usize) -> Message + 'static, ) -> Self

Subscribe to close view events

pub fn on_url_change( self, on_url_change: impl Fn(ViewId, String) -> Message + 'static, ) -> Self

Subscribe to url change events

pub fn on_title_change( self, on_title_change: impl Fn(ViewId, String) -> Message + 'static, ) -> Self

Subscribe to title change events

pub fn on_copy(self, on_copy: impl Fn(String) -> Message + 'static) -> Self

Subscribe to copy events (text selection copied via Ctrl+C / Cmd+C)

pub fn on_action( self, mapper: impl Fn(Action) -> Message + Send + Sync + 'static, ) -> Self

Provide a mapper from Action to Message so the webview can spawn async tasks that route back through the iced update loop. Required for litehtml and blitz engines — without it, URL navigation and image loading will not work.

pub fn with_initial_size(self, size: Size<u32>) -> Self

Set the initial viewport size used before the first resize event. Defaults to 1920x1080.

pub fn update(&mut self, action: Action) -> Task<Message>

Passes update to webview

pub fn url_for(&self, id: ViewId) -> Option<&str>

Get the URL for a specific view

pub fn title_for(&self, id: ViewId) -> Option<&str>

Get the title for a specific view

pub fn view<'a, T: 'a>(&'a self, id: usize) -> Element<'a, Action, T>

Like a normal view() method in iced, but takes an id of the desired view

Trait Implementations

impl<Engine: Engine + Default, Message: Send + Clone + 'static> Default for WebView<Engine, Message>

fn default() -> Self

Returns the “default value” for a type.