Content Creators
UI Text

UI Text

Ad text to your UI by creating a Label entity.

A Label entity has the following fields that can be configured:

  • value: The string to display
  • fontSize: The size of the text, as a number.

    NOTE: The fontSize is not affected by the size of its entity or parent entities.

  • color: The color of the text, as a Color4 .
  • font: The font to use, taking a value from the Font enum. Supported values are:
    • serif
    • sans-serif (default)
    • monospace
  • textAlign: How the text will align with its parent. It takes a value from the TextAlingType type. TextAlignType = ’top-left’ | ’top-center’ | ’top-right’ | ‘middle-left’ | ‘middle-center’ | ‘middle-right’ | ‘bottom-left’ | ‘bottom-center’ | ‘bottom-right’;
📔 Note: The fontSize is not affected by the size of its entity or parent entities.

A Label entity can also have other common components found on other types of UI entities, like uiTransform and uiBackground.

import { ReactEcsRenderer} from '@dcl/sdk/react-ecs'

ReactEcsRenderer.setUiRenderer(() => (
  <UiEntity uiTransform={{ width: 700, height: 400 }} >
    <Label
      value="This is a label"
      color={Color4.Red()}
      fontSize={29}
      font="serif"
      textAlign="top-left"
    />
  </UiEntity>
))

For multi-line text, you can add line breaks into the string, using \n.

import { ReactEcsRenderer} from '@dcl/sdk/react-ecs'

ReactEcsRenderer.setUiRenderer(() => (
  <UiEntity uiTransform={{ width: 700, height: 400 }}>
    <Label
      value="Hello World,\nthis message is quite long and won't fit in a single line.\nI hope that's not a problem."
    />
  </UiEntity>
))