Struct Attributes 

pub struct Attributes { /* private fields */ }

A runtime collection of HTML attributes with unique keys.

Each key appears at most once. Inserting the same key again replaces its value. Attribute order is unspecified. Prefer constructing Attributes with the attributes! macro.

Keys and values are captured when inserted. The collection can be built separately from the element that renders it.

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.

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<&AttributeValue>

Returns the captured value stored for attribute key k, if present.

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

Inserts or replaces an attribute.

Returns the previous value if the key was present. If v reports that its attribute should be omitted, stores AttributeValue::Absent. This still replaces the previous value and retains the key, but renders no attribute.

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

Removes an attribute, returning its captured 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 = (AttributeKey, AttributeValue)>, )

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 captured 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) -> Self

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() -> Self

Returns the “default value” for a type.

impl IntoIterator for Attributes

type Item = (AttributeKey, AttributeValue)

The type of the elements being iterated over.

type IntoIter = IntoIter<AttributeKey, AttributeValue>

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 AttributeKey, &'a AttributeValue)

The type of the elements being iterated over.

type IntoIter = Iter<'a, AttributeKey, AttributeValue>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.