Skip to content

Label

Combines an icon and title in a standard platform label.

<Label ... />

Overview

This component is backed by the platform control or container. Prefer its XML tag in an .etlua template; keep view-tree construction out of controllers.

Topics

Properties

Name Type Required Description
accessibilityLabel value optional Component-specific setting passed to the native control.
alignment value optional Component-specific setting passed to the native control.
color color optional Component-specific setting passed to the native control.
iconSize number optional Component-specific setting passed to the native control.
iconWeight value optional System symbol weight for the label icon.
italic boolean optional Component-specific setting passed to the native control.
lineLimit number optional Maximum number of visible text lines.
lines number optional Maximum number of visible text lines.
reservesSpace boolean optional Always as tall as lines lines, so shorter text never moves siblings (SwiftUI .lineLimit(n, reservesSpace: true)).
size number optional Component-specific setting passed to the native control.
spacing number optional Component-specific setting passed to the native control.
systemImage string optional Component-specific setting passed to the native control.
symbolSize number optional SF Symbol point size for an image-only button.
truncation string optional Text truncation position: head, middle, or tail.
minimumScaleFactor number optional Smallest fraction of size the text shrinks to when space is short.
weight value optional Component-specific setting passed to the native control.
wrapping boolean optional Component-specific setting passed to the native control.

Platform notes

  • UIKit uses the UIKit implementation.

Source: lua/embedded/UIKit.lua:915 (UIKit.Label)