blitz-traits 0.2.0

Shared traits and types for Blitz
Documentation
//! Abstractions allow embedders to handle link clicks and form submissions

use http::{HeaderMap, Method};
use url::Url;

use crate::net::{Body, Request};

/// An abstraction to allow embedders to hook into "navigation events" such as clicking a link
/// or submitting a form.
pub trait NavigationProvider: Send + Sync + 'static {
    fn navigate_to(&self, options: NavigationOptions);
}

pub struct DummyNavigationProvider;

impl NavigationProvider for DummyNavigationProvider {
    fn navigate_to(&self, _options: NavigationOptions) {
        // Default impl: do nothing
    }
}

#[non_exhaustive]
#[derive(Debug, Clone)]
pub struct NavigationOptions {
    /// The URL to navigate to
    pub url: Url,

    pub content_type: String,

    /// Source document for the navigation
    pub source_document: usize,

    pub method: Method,

    pub document_resource: Body,
}

impl NavigationOptions {
    pub fn new(url: Url, content_type: String, source_document: usize) -> Self {
        Self {
            url,
            content_type,
            source_document,
            method: Method::GET,
            document_resource: Body::Empty,
        }
    }
    pub fn set_document_resource(mut self, document_resource: Body) -> Self {
        self.document_resource = document_resource;
        self
    }

    pub fn set_method(mut self, method: Method) -> Self {
        self.method = method;
        self
    }

    pub fn into_request(self) -> Request {
        Request {
            url: self.url,
            method: self.method,
            content_type: self.content_type,
            headers: HeaderMap::new(),
            body: self.document_resource,
        }
    }
}