Struct Attribute

pub struct Attribute(/* private fields */);

An attribute

It can be created via Self::new, Self::new_flag or by converting from ither (&'static str, &'static str) or (&'static str, String).

See attr for a collection of common attributes

Example

assert_eq!(
  id("foo").to_string(),
  r#"id="foo""#,
)

Implementations

impl Attribute

pub fn new(name: &'static str, value: impl Into<Cow<'static, str>>) -> Self

Create a new attribute

pub fn new_int(name: &'static str, value: i32) -> Self

Create attribute with an integer value

pub fn new_flag(name: &'static str) -> Self

Create a new flag attribute (that doesn’t take a value)

pub fn new_unsafe_name( name: impl Into<Cow<'static, str>>, value: impl Into<Cow<'static, str>>, ) -> Self

Create a new attribute with a name generated at runtime

This IS NOT SAFE as the attribute name is not escaped. It is necessary to control or validate the attribute name to avoid being vulnerable to XSS attacks.

The attribute value is escaped normally.

Trait Implementations

impl Clone for Attribute

fn clone(&self) -> Attribute

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 Default for Attribute

fn default() -> Attribute

Returns the “default value” for a type.

impl Display for Attribute

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

Formats the value using the given formatter.

impl<T: Into<Cow<'static, str>>> From<(&'static str, T)> for Attribute

fn from((key, value): (&'static str, T)) -> Self

Converts to this type from the input type.