mosaic-server/dev.catbit.mosaic.server.builder.tile.builders.text/SimpleText

SimpleText

fun TileSchemaBuilderScope.SimpleText(text: String, id: String = randomId(), events: EventSchemaBuilderScope.() -> Unit = {}, style: StyleSchemaBuilderScope.() -> Unit = { size( width = wrapHorizontally(), height = wrapVertically() ) }, visibility: TileSchema.Visibility = visible(), searchableTerms: List<String>? = null, color: ColorSchema? = null, typography: TypographySchema? = null, autoSize: AutoSizeSchema? = null, fontSize: Float? = null, fontStyle: FontStyleSchema? = null, fontWeight: FontWeightSchema? = null, fontFamily: FontFamilySchema? = null, letterSpacing: Float? = null, textDecoration: TextDecorationSchema? = null, textAlign: TextAlignSchema? = null, lineHeight: Float? = null, overflow: TextOverflowSchema? = null, softWrap: Boolean? = null, maxLines: Int? = null, minLines: Int? = null)

Renders plain text showing text. typography provides the base text style, falling back to the ambient default when null; every other styling field overrides one property on top of that base and is ignored when null: color, autoSize, fontSize (sp), fontStyle, fontWeight, fontFamily, letterSpacing (sp), textDecoration, textAlign and lineHeight (sp). overflow defaults to clipping, softWrap to true, maxLines to unbounded and minLines to 1. Dispatches no triggers and is not clickable — wrap it in a Box or Card for tap handling. Renders plain text only — no inline annotations, links or markdown; wrap it in a SelectionContainer to make the text selectable.

Parameters

text

Text content displayed.

Unique identifier of the tile. Defaults to a random id.

events

Events owned by this tile. Never fired, since the tile dispatches no triggers.

style

Layout/appearance modifiers (size, padding, background, etc). Defaults to wrapping its content.

visibility

Whether the tile is shown, hidden but occupies space, or removed from layout. Defaults to visible.

searchableTerms

Terms used by an ancestor's search/filter to decide whether this tile matches. Defaults to none.

color

Text color override. Defaults to none (uses the base style's color).

typography

Base text style (size, weight, line height, etc as a set). Defaults to none (uses the ambient default).

autoSize

Automatic font-size scaling to fit the available space. Defaults to none (disabled).

fontSize

Font size override, in sp. Defaults to none (uses the base style's size).

fontStyle

Font style override (e.g. italic). Defaults to none (uses the base style's).

fontWeight

Font weight override. Defaults to none (uses the base style's).

fontFamily

Font family override. Defaults to none (uses the base style's).

letterSpacing

Letter spacing override, in sp. Defaults to none (uses the base style's).

textDecoration

Text decoration override (e.g. underline). Defaults to none (uses the base style's).

textAlign

Text alignment override. Defaults to none (uses the base style's).

lineHeight

Line height override, in sp. Defaults to none (uses the base style's).

overflow

How overflowing text is handled. Defaults to clipping.

softWrap

Whether the text wraps at soft line breaks. Defaults to true.

maxLines

Maximum number of lines shown. Defaults to unbounded.

minLines

Minimum number of lines reserved. Defaults to 1.