Struct CardBuilder 

pub struct CardBuilder { /* private fields */ }

Fluent builder for fully custom Lark interactive cards.

Produces a GenericCardTemplate via CardBuilder::build.

Example

use lark_webhook_notify::{CardBuilder, ColorTheme, TextAlign, TextSize};

let card = CardBuilder::new()
    .header("Deploy Complete", Some("success"), Some(ColorTheme::Green), None)
    .markdown("**Service:** api v1.4", TextAlign::Left, TextSize::Normal)
    .columns()
        .column("Env", Some("prod"), "auto", 1)
        .column("Region", Some("us-east-1"), "weighted", 1)
    .end_columns()
    .collapsible("Logs", "Deploy OK", false)
    .build();

Panics

build panics if columns was called without a matching end_columns.

Implementations

impl CardBuilder

pub fn new() -> Self

pub fn language(self, lang: LanguageCode) -> Self

Override the language carried by this builder (default: Zh).

pub fn header( self, title: &str, status: Option<&str>, color: Option<ColorTheme>, subtitle: Option<&str>, ) -> Self

Set the card header. Status auto-detects color if color is None: “running”|“submitted” → Wathet, “success”|“completed” → Green, “failed”|“error” → Red, “warning” → Orange, _ → Blue

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

Add a single **Label:** value metadata line as a markdown block.

pub fn metadata_block(self, fields: &[(&str, &str)]) -> Self

Add multiple **Label:** value lines as a single markdown block.

pub fn markdown( self, content: &str, text_align: TextAlign, text_size: TextSize, ) -> Self

Add a markdown text block with explicit alignment and size.

pub fn columns(self) -> Self

Begin a column group. Must be closed with end_columns.

pub fn column( self, label: &str, value: Option<&str>, width: &str, weight: u32, ) -> Self

Add a column to the current column group.

width: "auto" for content-sized or "weighted" for proportional. weight is only used when width = "weighted".

pub fn end_columns(self) -> Self

Close the current column group and add a column_set block to the card body.

pub fn collapsible(self, title: &str, content: &str, expanded: bool) -> Self

Add a collapsible panel with a markdown body.

expanded = true renders the panel open by default.

pub fn divider(self) -> Self

Add a horizontal divider (---).

pub fn add_block(self, block: impl Into<Value>) -> Self

Add any block that implements Into<serde_json::Value> directly.

Use this to insert raw block structs from the blocks module or hand-crafted JSON values.

pub fn build(self) -> GenericCardTemplate

Finalize and return the card as a GenericCardTemplate.

Panics

Panics if any column group opened with columns was not closed with end_columns.

Trait Implementations

impl Default for CardBuilder

fn default() -> Self

Returns the “default value” for a type.