Struct Article

Source

pub struct Article { /* private fields */ }

Expand description

Builder for <article> elements.

Represents a self-contained composition in a document, such as a blog post, news article, or forum post.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new()
    .id("post-1")
    .aria_label("Latest post")
    .child("<h1>Title</h1>")
    .build();
assert!(html.starts_with("<article"));
assert!(html.contains(r#"id="post-1""#));

Implementations§

Source §

impl Article

Source

pub fn new() -> Self

Creates a new builder with default values.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().build();
assert!(html.contains("<article"));

Source

pub fn id(self, id: &str) -> Self

Sets the id attribute.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().id("post-1").build();
assert!(html.contains(r#"id="post-1""#));

Source

pub fn class(self, class: &str) -> Self

Sets the class attribute.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().class("post").build();
assert!(html.contains(r#"class="post""#));

Source

pub fn aria_label(self, label: &str) -> Self

Sets the aria-label attribute.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().aria_label("Latest post").build();
assert!(html.contains(r#"aria-label="Latest post""#));

Source

pub fn aria_labelledby(self, id: &str) -> Self

Sets the aria-labelledby attribute.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().aria_labelledby("title-1").build();
assert!(html.contains(r#"aria-labelledby="title-1""#));

Source

pub fn attr(self, key: &str, value: &str) -> Self

Adds a custom attribute.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().attr("data-id", "42").build();
assert!(html.contains(r#"data-id="42""#));

Source

pub fn child(self, html: &str) -> Self

Appends child HTML content.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().child("<p>Body</p>").build();
assert!(html.contains("<p>Body</p>"));

Source

pub fn children(self, items: &[&str]) -> Self

Appends multiple child HTML content strings.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new()
    .children(&["<h1>T</h1>", "<p>B</p>"])
    .build();
assert!(html.contains("<h1>T</h1><p>B</p>"));

Source

pub fn build(&self) -> String

Renders the element to an HTML string.

§Examples

use html_generator::elements::{Article, SemanticElement};

let html = Article::new().id("a").build();
assert!(html.starts_with("<article"));
assert!(html.ends_with("</article>"));