Class StatsModule

java.lang.Object

io.mindspice.simplypages.core.HtmlTag

io.mindspice.simplypages.core.Module

io.mindspice.simplypages.modules.StatsModule

All Implemented Interfaces:

Component

public class StatsModule
extends Module

Module for rendering metric/value cards in a simple grid.

Mutability and thread-safety: mutable and not thread-safe. Stats list and column count are mutable configuration state; mutate within a request-scoped flow. For reuse, stop mutating and render as a stable structure with per-request slot/context values.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	StatsModule.Stat

Field Summary

Fields inherited from class Module

moduleId, title

Fields inherited from class HtmlTag

attributes, children, id, innerText, innerTextSlot, selfClosing, tagName, trustedHtml

Constructor Summary

Constructors

Constructor	Description
StatsModule()

Method Summary

Modifier and Type	Method	Description
StatsModule	addStat(String value, String label)	Adds a statistic with value and label.
StatsModule	addStat(String value, String label, String description)	Adds a statistic with value, label, and description.
protected void	buildContent()	Composes module structure.
static StatsModule	create()
StatsModule	withColumns(int columns)	Sets the number of columns for the stats grid.
StatsModule	withModuleId(String moduleId)	Sets module id and synchronizes the underlying id attribute.
StatsModule	withTitle(String title)	Sets optional title consumed by Module.buildContent() implementations.

Methods inherited from class Module

build, getModuleId, getTitle, invalidateContent, rebuildContent, render, render, withClass, withMaxWidth, withMinWidth, withWidth

Methods inherited from class HtmlTag

addClass, addStyle, addTrustedStyle, getChildrenStream, getId, hxDelete, hxGet, hxInclude, hxPatch, hxPost, hxPushUrl, hxPut, hxScrollTargetTop, hxSwap, hxTarget, hxTrigger, withAttribute, withChild, withId, withInnerText, withInnerText, withUnsafeHtml

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface Component

compile, render

Constructor Details

StatsModule

public StatsModule()

Method Details

create

public static StatsModule create()

withTitle

public StatsModule withTitle(String title)

Description copied from class: Module

Sets optional title consumed by Module.buildContent() implementations.

Overrides:

withTitle in class Module

withModuleId

public StatsModule withModuleId(String moduleId)

Description copied from class: Module

Sets module id and synchronizes the underlying id attribute.

Overrides:

withModuleId in class Module

addStat

public StatsModule addStat(String value,
 String label)

Adds a statistic with value and label.

Parameters:

value - the numeric or text value to display

label - the label describing the statistic

addStat

public StatsModule addStat(String value,
 String label,
 String description)

Adds a statistic with value, label, and description.

Parameters:

value - the numeric or text value to display

label - the label describing the statistic

description - additional context or description

withColumns

public StatsModule withColumns(int columns)

Sets the number of columns for the stats grid.

Parameters:

columns - number of columns (1-6)

buildContent

protected void buildContent()

Description copied from class: Module

Composes module structure.

Called at most once by Module.build() unless Module.rebuildContent() is invoked. Do not rely on this method for per-request mutation.

Specified by:

buildContent in class Module