Struct Section

Source

pub struct Section { /* private fields */ }

Expand description

Builder for <section> elements.

Represents a standalone section of a document, typically with a heading.

§Examples

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

let html = Section::new().id("intro").child("<h2>Intro</h2>").build();
assert!(html.contains("<section"));
assert!(html.contains(r#"id="intro""#));

Implementations§

Source §

impl Section

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>"));