UiText

Creates a dynamic text node with optional icon and auto-resizing.

UiText is designed for displaying static or dynamically updated text, supporting icons, custom fonts, and automatic layout resizing based on the text content.

UiText(text = "", style = {}, props = {})

🧩 Description

UiText is a simple and efficient UI element that renders text within the UniqueUI system. It can automatically resize itself based on the rendered string or track a dynamic value through a valueGetter callback, making it suitable for labels, counters, or real-time indicators.

If an icon is provided, it will be drawn next to the text with proper spacing.

Properties

Property	Type	Default	Description
`text`	`string`	`""`	The text displayed by the node.
`autoResize`	`bool`	`true` (if no width/height in style)	Automatically adjusts node size to match text content.
`halign`	`constant`	`fa_left`	Horizontal alignment (left, center, right).
`valign`	`constant`	`fa_top`	Vertical alignment (top, middle, bottom).
`valueGetter`	`function`	`undefined`	Optional function returning the current text value (used for dynamic updates).
`icon`	`sprite`	`undefined`	Optional sprite drawn before the text.
`color`	`color`	`c_white`	Text color.
`font`	`font`	`fText`	Font used to draw the text.

🔄 Methods

Method	Description
`computeSize()`	Calculates and updates the node's width and height based on the text and optional icon. Used for auto-resizing.
`onStep()`	Called every frame. If a `valueGetter` is defined, updates the text when the value changes.
`onDraw()`	Handles the rendering of both icon and text, applying alignment, font, and color settings.

🧠 Behavior

If autoResize is true, the node automatically adjusts its size when the text changes.
When a valueGetter is provided, the node automatically refreshes every frame to display up-to-date values.
Supports both static and reactive UI text.

Example

// Create a static text label
var label = new UiText("Hello World!", { x: 20, y: 20 });

// Create a dynamic label that displays the current FPS
var fpsText = new UiText("", {}, {
    valueGetter: function() { return "FPS: " + string(fps); }
});

// Add an icon before the text
var iconText = new UiText("Settings", {}, { icon: spr_settings });