Struct darwin_webkit::helpers::dwk_webview::DarwinWKWebView

pub struct DarwinWKWebView { /* private fields */ }

Wraps a WKWebView, WKWebViewConfiguration & WKUserContentController

Can be used from a cocoa application with get_native_handle or with DWKApp.

Example

extern crate cocoa;
use cocoa::base::id;
use darwin_webkit::helpers::dwk_app::DarwinWKApp;
use std::sync::Arc;

unsafe {
    let app = DarwinWKApp::new("Host an app");
    let webview = Arc::new(app.create_webview());
     
    let callback_webview = webview.clone();
    let callback = Box::into_raw(Box::new(Box::new(|_: id, _: id| {
        println!("JavaScript called rust!");
        callback_webview.evaluate_javascript(
            "document.body.innerHTML += ' -> response from rust<br />';"
        );
    })));

    webview.add_message_handler("hello", callback);
    webview.load_html_string("
        <script>
            document.body.innerHTML += 'start';
            window.webkit.messageHandlers.hello.postMessage('hello');
        </script>
    ", "", );
}

Implementations

impl DarwinWKWebView

pub unsafe fn new(frame: NSRect) -> DarwinWKWebView

Create a webview with the given frame rect. Also creates the supporting configuration and content controller.

Thee view is resizable other options are empty.

Safety

All the FFI functions are unsafe.

pub fn get_native_handle(&self) -> id

Get the WKWebView instance

pub fn get_user_content_controller_handle(&self) -> id

Get the WKUserContentController instance

pub fn get_configuration_handle(&self) -> id

Get the WKWebViewConfiguration instance

pub unsafe fn load_url(&self, url: &str)

Load an URL onto the WebView.

Safety

All the FFI functions are unsafe.

pub unsafe fn load_html_string(&self, html: &str, base_url: &str)

Load an HTML string onto the WebView.

Safety

All the FFI functions are unsafe.

pub unsafe fn evaluate_javascript(&self, javascript: &str)

Evaluate a JavaScript string on the WebView

Safety

All the FFI functions are unsafe.

pub unsafe fn add_message_handler<Func>(&self, name: &str, callback: *mut Func)where Func: FnMut(id, id),

Register a callback into the WebView.

Calls make_new_handler under the hood. The callback should have form:

FnMut(id /* WKUserContentController */, id /* WKScriptMessage */)

The handler will be available from JavaScript through:

window.webkit.messageHandlers.name.postMessage('some message');

Safety

All the FFI functions are unsafe.

Your callback will be called from WebKit. If the WebView outlives it: 💥.

Trait Implementations

impl Send for DarwinWKWebView

impl Sync for DarwinWKWebView