Struct Attributes 

pub struct Attributes { /* private fields */ }

A runtime collection of HTML attributes with unique keys.

Attributes is map-like: each key appears at most once, and inserting the same key again replaces the previous value. Do not rely on render order. Prefer constructing Attributes with the attributes! macro.

Implementations

impl Attributes

pub fn new() -> Self

Creates an empty attribute collection.

Prefer the attributes! macro when writing attributes directly. Use this constructor when the collection must be populated incrementally.

pub fn with_capacity(capacity: usize) -> Self

Creates an empty attribute collection with space for at least capacity attributes.

Prefer the attributes! macro when writing attributes directly. This is mainly useful for generated code or manual builders that already know how many attributes they will insert.

pub fn contains_key(&self, k: impl AsRef<str>) -> bool

Returns true if this collection contains an attribute with key k.

pub fn get(&self, k: impl AsRef<str>) -> Option<&ViewPart>

Returns the view parts stored for attribute key k, if present.

pub fn insert( &mut self, cx: &Cx, k: impl Into<String>, v: impl AttributeValueViewParts, ) -> Option<ViewPart>

Inserts or replaces an attribute.

The value is converted with AttributeValueViewParts. If the key was already present, the previous rendered value is returned. If the implementation of AttributeValueViewParts for v signals that the attribute should not be present, ViewPart::empty will be used as the value instead, which call cause the previous value to be removed and the attribute will not be rendered in a view!.

pub fn remove(&mut self, k: impl AsRef<str>) -> Option<ViewPart>

Removes an attribute, returning its rendered value if the key was present.

pub fn clear(&mut self)

Removes all attributes from the collection.

pub fn extend(&mut self, iter: impl IntoIterator<Item = (String, ViewPart)>)

Inserts every (key, value) entry from iter, replacing any keys already present.

pub fn iter(&self) -> <&Self as IntoIterator>::IntoIter

Returns an iterator over attribute keys and rendered values.

Trait Implementations

impl AttributeViewParts for Attributes

fn into_view_parts(self, cx: &Cx, parts: &mut PartsWriter<'_>)

Appends zero or more attributes to the view being built.

impl Clone for Attributes

fn clone(&self) -> Attributes

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Attributes

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

Formats the value using the given formatter.

impl Default for Attributes

fn default() -> Attributes

Returns the “default value” for a type.

impl IntoIterator for Attributes

type Item = (String, ViewPart)

The type of the elements being iterated over.

type IntoIter = IntoIter<String, ViewPart>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a> IntoIterator for &'a Attributes

type Item = (&'a String, &'a ViewPart)

The type of the elements being iterated over.

type IntoIter = Iter<'a, String, ViewPart>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.