autumn-plugin-vanilla 0.3.0

Autumn plugin: declarative vanilla JS behaviors for Maud + htmx apps. No npm, no bundler.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

use super::{Behavior, marker};
use crate::markup::{Attributes, common};

/// Asks the user before a form submits, a link opens, or an htmx element
/// sends a request.
///
/// It listens in the capture phase. When the user cancels, it stops the
/// event before htmx or other handlers see it. A nested confirm asks for
/// its own content only.
///
/// ```rust
/// use autumn_plugin_vanilla::Confirm;
/// use autumn_web::html;
///
/// let html = Confirm::new("Delete this post?").wrap(html! {
///     form method="post" action="/posts/1/delete" { button { "Delete" } }
/// });
/// assert!(html.into_string().contains(r#"data-vanilla-confirm="Delete this post?""#));
/// ```
#[derive(Debug, Clone, Default, PartialEq, Eq)]
#[must_use]
pub struct Confirm {
    message: Option<String>,
    extra: Attributes,
}

impl Confirm {
    /// Asks with this message. [`Confirm::default`] uses "Are you sure?".
    pub fn new(message: impl Into<String>) -> Self {
        Self {
            message: Some(message.into()),
            extra: Vec::new(),
        }
    }

    /// The attributes, in render order.
    #[must_use]
    pub fn attributes(&self) -> Attributes {
        let mut attributes = vec![marker(Behavior::Confirm)];
        if let Some(message) = &self.message {
            attributes.push(("data-vanilla-confirm", message.clone()));
        }
        attributes.extend(self.extra.iter().cloned());
        attributes
    }
}

common!(Confirm, wrap);