Введение в богатые текстовые теги

Богатые текстовые теги — это теги, которые можно поместить внутрь текстовой строки для стилизации текста между тегами.

Примечание: В текущем выпуске, богатые текстовые теги не поддерживаются для TextField.

Синтаксис Rich Text

Богатые текстовые теги похожи на теги HTML или XML, но имеют менее строгий синтаксис.

Простой тег может иметь только свое имя и не иметь дополнительных значений или атрибутов. Например, тег <b> делает текст жирным.

Некоторые теги имеют дополнительные значения или атрибуты, например:

<tag="value">
<tag attribute="value">

Например:

<color=”red”>: Текст становится красным
<sprite index=3>: Вставляет четвертый спрайт из стандартного Sprite Asset.

Примечание: В а UXML файл, вы должны использовать HTML код для следующих символов:

<: (<)
>: (>)
": (")

В следующей таблице перечислены возможные типы значений атрибутов и примеры значений.

Тип значения	Пример значения
Десятичные знаки	`0.5`
Процентная доля	`25%`
Значения пикселей	`5px`
Шрифтовые единицы	`1.5em`
Шестнадцатеричные значения цветов	`#FFFFFF` (RGB) `#FFFFFFFF` (RGBA) `#FF` (A)
Имена	И `<link=”ID”>`, и `<link=ID>` действительны.

Область тегов и вложенные теги

Метки имеют сферу действия, которая определяет, на какую часть текста они влияют. Большинство тегов влияют на весь текст с момента их появления.

Например, если вы добавите тег <color="red"> в начало текста, это повлияет на весь блок текста: <color="red">This text is red.

Если вы добавите тот же тег в середине текстового блока, это повлияет только на текст между теги и конца блока: This text turns<color="red"> red.

Если вы используете один и тот же тег более одного раза в текстовом блоке, последний тег заменяет все предыдущие теги того же типа: <color="red">This text goes from red<color="green"> to green.

Вы также можете использовать закрывающий тег, чтобы ограничить область применения тега, и использовать вложенный тег внутри другого тега: <color=red>This text is <color=green>mostly </color>red.

Область действия первого тега <color> — это весь текстовый блок. Второй тег <color> имеет закрывающий тег, который ограничивает его область действия одним словом.

При вложении тегов не нужно закрывать их области в том же порядке, в котором они были начаты.

Включение и отключение тегов с богатым текстом

По умолчанию теги Rich Text включены.

Чтобы отключить тег Rich Text, выполните одно из следующих действий:

В UI Builder выберите контроллер и снимите флажок Enable Rich Text в окне Inspector.
В UXML установите атрибут enable-rich-text на false.