Struct Section 

pub struct Section { /* private fields */ }

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

impl Section

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

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

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

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

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

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

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

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

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

Trait Implementations

impl Clone for Section

fn clone(&self) -> Section

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Section

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

Formats the value using the given formatter.

impl Default for Section

fn default() -> Section

Returns the “default value” for a type.

impl SemanticElement for Section

fn build(&self) -> String

Render the element to an HTML string.