Struct malvolio::tags::a::A

pub struct A { /* private fields */ }

A link (anchor).

A::default()
    .attribute(Href::new("https://example.com/mark-read"))
    .text("Mark as read");

See the MDN Web Docs for further information.

Implementations

impl A

pub fn new() -> A

Creates a new A tag.

impl A

pub fn text<S>(self, text: S) -> Self where
    S: Into<Cow<'static, str>>, 

Adds the supplied text to this node, overwriting the previously existing text (if text has already been added to the node).

This method sanitises the input (i.e. it escapes HTML); this might not be what you want – if you are absolutely certain that the text you are providing does not come from a potentially malicious source (e.g. user-supplied text can contain script tags which will execute unwanted code) you can use text_unsanitized which is identical to this method, except for that it does not sanitise the inputted text (and is thus slightly faster).

pub fn text_unsanitized<S>(self, text: S) -> Self where
    S: Into<Cow<'static, str>>, 

Adds the supplied text to this node, overwriting the previously existing text (if text has already been added to the node).

WARNING: Do not (under any circumstances) use this method with unescaped user-supplied text. It will be rendered and poses a major security threat to your application. If in doubt, use the text method instead of this one (the risk is much lower that way).

pub fn attribute<I>(self, attribute: I) -> Self where
    I: Into<AAttr>, 

Adds an attribute to this node. This method takes one argument which must implement Into<AAttr>.

pub fn href<C>(self, href: C) -> Self where
    C: Into<Cow<'static, str>>, 

Attach a new href attribute to this tag.

A::new().href("http://example.com");

Note: this method is a shortcut for

A::new().attribute(Href::new("https://example.com"));

pub fn id<C>(self, id: C) -> Self where
    C: Into<Cow<'static, str>>, 

Attach a new id attribute to this tag.

A::new().id("some-id");

Note: this method is a shortcut for

A::new().attribute(Id::new("some-id"));

pub fn read_attribute(
    &self,
    attribute: &'static str
) -> Option<&Cow<'static, str>>

Read an attribute that has been set.

Trait Implementations

impl Clone for A

fn clone(&self) -> A

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for A

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

Formats the value using the given formatter.

impl Default for A

fn default() -> A

Returns the “default value” for a type.

impl Display for A

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

Formats the value using the given formatter.

impl From<A> for BodyNode

fn from(t: A) -> BodyNode

Converts to this type from the input type.