Struct Attribute 

pub struct Attribute { /* private fields */ }

A single HTML attribute.

Values are escaped when the attribute is built, not when it is rendered — see crate::core::escape.

Examples

use molt::core::Attribute;
assert_eq!(Attribute::new("href", "/a?x=1&y=2").to_string(), r#" href="/a?x=1&y=2""#);
assert_eq!(Attribute::boolean("required").to_string(), " required");

Implementations

impl Attribute

pub fn new(key: impl Into<String>, value: impl AsRef<str>) -> Self

Creates an attribute, escaping the value.

pub fn trusted_url(key: impl Into<String>, value: impl AsRef<str>) -> Self

A URL attribute rendered as given, even when the value is a script URL.

href, src, action and the other URL attributes render as # when the value would run script. Use this only for a URL you wrote yourself. The value is still attribute-escaped.

Examples

use molt::prelude::*;
let link = a().add_attribute(Attribute::trusted_url("href", "javascript:print()"));
assert_eq!(link.render(), "<a href=\"javascript:print()\"></a>");

pub fn raw(key: impl Into<String>, value: impl Into<String>) -> Self

Creates an attribute without escaping the value.

One of the three escape hatches, with Node::raw and Element::raw_text — grep for the three to audit a codebase. Use it for a value you wrote yourself and have already escaped. Never pass user data: a " in the value closes the attribute and what follows is markup.

The URL policy still runs on the stored value, so a raw javascript: URL in href is rendered as #; only Self::trusted_url skips that.

The meta_* helpers do not use it: they are pub and take &str, so they escape.

Examples

use molt::core::Attribute;
// Already escaped by the caller, so it must not be escaped again.
assert_eq!(Attribute::raw("title", "a & b").to_string(), r#" title="a & b""#);

pub fn boolean(key: impl Into<String>) -> Self

Creates a boolean attribute, which renders as a bare key.

hidden, checked, required, open, controls, autoplay, muted.

pub fn key(&self) -> &str

The attribute name.

pub fn value(&self) -> &str

The escaped attribute value. Empty for boolean attributes.

pub fn is_boolean(&self) -> bool

Whether this attribute renders as a bare key.

Trait Implementations

impl Clone for Attribute

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Attribute

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Attribute

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Attribute

impl Hash for Attribute

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Attribute

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Attribute