Struct lignin::Attribute

pub struct Attribute<'a> {
    pub name: &'a str,
    pub value: &'a str,
}

Vdom Represents a single HTML Attr with name and value.

Fields

name: &'a str

The name.

Implementation Contract

Security

While applications should generally avoid it, Attribute::name may contain characters that are unexpected in this position.

Renderers may only process these verbatim iff they can expect this to not cause security issues.

For example: Passing an invalid attribute name to a DOM API isolated in a dedicated parameter is probably okay, as long as something along the way validates it doesn’t contain '\0'.

Serializing an invalid attribute name to HTML is a very bad idea, so renderers must never do so.

value: &'a str

The unescaped value.

Implementations

impl<'a> Attribute<'a>

#[must_use]

pub fn deanonymize(self) -> Self

👎 Deprecated:

Call of .deanonymize() on named type.

When called on an opaque type, deanonymizes it into the underlying named type.

Both AutoSafe and Deanonymize must be in scope and the method must be called without qualification for this to work.

Calling this method on a named type returns the value and type unchanged and produces a deprecation warning.

#[must_use]

pub fn prefer_thread_safe(self) -> Self

👎 Deprecated:

Call of .prefer_thread_safe() on Attribute.

Gently nudges the compiler to choose the ThreadSafe version of a value if both are possible.

This method is by value, so it will resolve with higher priority than the by-reference method on the ThreadBound type.

Note that not all tooling will show the correct overload here, but the compiler knows which to pick.

Calling this method on Attribute produces a deprecation warning since the type is always ThreadSafe.

#[must_use]

pub fn prefer_thread_safe_ref(&self) -> &Self

👎 Deprecated:

Call of .prefer_thread_safe_ref() on Attribute.

Gently nudges the compiler to choose the ThreadSafe version of a reference if both are possible.

This method is once by single reference, so it will resolve with higher priority than the twice-by-reference method on the ThreadBound type.

Note that not all tooling will show the correct overload here, but the compiler knows which to pick.

Calling this method on Attribute produces a deprecation warning since the type is always ThreadSafe.

Trait Implementations

impl<'a> Clone for Attribute<'a>

fn clone(&self) -> Attribute<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Attribute<'a>

impl<'a> Debug for Attribute<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Attribute<'a>

impl<'a> Hash for Attribute<'a>

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<'a> Ord for Attribute<'a>

fn cmp(&self, other: &Attribute<'a>) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<'a> PartialEq<Attribute<'a>> for Attribute<'a>

fn eq(&self, other: &Attribute<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Attribute<'a>) -> bool

This method tests for !=.

impl<'a> PartialOrd<Attribute<'a>> for Attribute<'a>

fn partial_cmp(&self, other: &Attribute<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

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

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

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

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> StructuralEq for Attribute<'a>

impl<'a> StructuralPartialEq for Attribute<'a>

impl<'a> Vdom for Attribute<'a>

type ThreadSafety = ThreadSafe

The ThreadSafety of the Vdom type, either ThreadSafe or ThreadBound.