Class RichContentModule

java.lang.Object

io.mindspice.simplypages.core.HtmlTag

io.mindspice.simplypages.core.Module

io.mindspice.simplypages.modules.RichContentModule

All Implemented Interfaces:

Component, Editable<RichContentModule>

public class RichContentModule
extends Module
implements Editable<RichContentModule>

Editable module that renders heterogeneous content items (paragraphs, images, links, headers).

Mutability and thread-safety: mutable and not thread-safe. Child component list is mutable and reused directly during rendering; mutate within a request-scoped flow. For reuse, stop mutating and render as a stable structure with per-request slot/context values.

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
RichContentModule(String title)

Method Summary

Modifier and Type	Method	Description
RichContentModule	addHeader(Header header)
RichContentModule	addImage(Image image)
RichContentModule	addLink(Link link)
RichContentModule	addParagraph(Paragraph paragraph)
RichContentModule	applyEdits(Map<String,String> formData)	Applies form data to this module instance.
protected void	buildContent()	Composes module structure.
Component	buildEditView()	Builds the main-property edit view for this module.
static RichContentModule	create(String title)
List<EditableChild>	getEditableChildren()	Returns editable child handles for nested editing UIs.
String	getModuleId()	Returns the configured module id, or null.
RichContentModule	setModuleId(String id)	Deprecated. Use Module.withModuleId(String) for fluent configuration.
ValidationResult	validate(Map<String,String> formData)	Validates form data before mutation.
RichContentModule	withTitle(String title)	Sets optional title consumed by Module.buildContent() implementations.

Methods inherited from class Module

build, getTitle, invalidateContent, rebuildContent, render, render, withClass, withMaxWidth, withMinWidth, withModuleId, 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

RichContentModule

public RichContentModule(String title)

Method Details

create

public static RichContentModule create(String title)

withTitle

public RichContentModule withTitle(String title)

Description copied from class: Module

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

Overrides:

withTitle in class Module

setModuleId

@Deprecated
public RichContentModule setModuleId(String id)

Deprecated.

Use Module.withModuleId(String) for fluent configuration.

getModuleId

public String getModuleId()

Description copied from class: Module

Returns the configured module id, or null.

Overrides:

getModuleId in class Module

addParagraph

public RichContentModule addParagraph(Paragraph paragraph)

addImage

public RichContentModule addImage(Image image)

addLink

public RichContentModule addLink(Link link)

addHeader

public RichContentModule addHeader(Header header)

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

buildEditView

public Component buildEditView()

Description copied from interface: Editable

Builds the main-property edit view for this module.

Specified by:

buildEditView in interface Editable<RichContentModule>

Returns:

component containing form controls

validate

public ValidationResult validate(Map<String,String> formData)

Description copied from interface: Editable

Validates form data before mutation.

Specified by:

validate in interface Editable<RichContentModule>

Parameters:

formData - form field name to value map

Returns:

validation result; default is success

applyEdits

public RichContentModule applyEdits(Map<String,String> formData)

Description copied from interface: Editable

Applies form data to this module instance.

Side effect: mutates this module. Implementations should rebuild cached/built structure when required by module lifecycle semantics.

Specified by:

applyEdits in interface Editable<RichContentModule>

Parameters:

formData - form field name to value map

Returns:

this module instance

getEditableChildren

public List<EditableChild> getEditableChildren()

Description copied from interface: Editable

Returns editable child handles for nested editing UIs.

Specified by:

getEditableChildren in interface Editable<RichContentModule>

Returns:

editable children in UI/display order; default is empty