Перейти к основному содержимому
Версия: Next

Interface: MayHaveContent

Expand

Тип для элементов UI, содержимое которых может быть опциональным.

Remarks

Использование:

  • Когда содержимое требуется, используйте HasContent
  • Когда содержимое может быть пустым или отсутствовать, используйте MayHaveContent

Примеры:

  • Текстовый блок может быть без содержимого (будет пустой)
  • Кнопка может не иметь описания

Properties

content?

readonly optional content: string

Содержимое элемента, предназначенное для отображения пользователю.

Remarks

Формат:

  • Если contentType = 'plain/text' — обычная строка текста
  • Если contentType = 'html' — строка с HTML разметкой

Ограничения:

  • Не должна быть пустой (может вызвать проблемы отображения)
  • Максимальный размер зависит от браузера (обычно несколько MB)
  • HTML содержимое фильтруется в целях безопасности

Example

// Обычный текст
{
content: 'Это простой текст',
contentType: 'plain/text'
}

// HTML
{
content: '<h2>Заголовок</h2><p>Абзац текста</p>',
contentType: 'html'
}

contentType?

readonly optional contentType: UiContentType

Тип содержимого, определяющий как интерпретировать поле content.

Remarks

Значения:

  • 'plain/text' — содержимое это обычный текст

    • Все символы отображаются как есть
  • 'html' — содержимое это HTML разметка

    • HTML теги интерпретируются и отображаются
    • Небезопасные теги и атрибуты удаляются

Default

'plain/text'

Example

// HTML — теги интерпретируются
{
content: 'Текст с <strong>жирным</strong> словом',
contentType: 'html'
}
// Отобразится: "Текст с жирным словом" (жирное)

// Без указания — используется plain/text
{
content: 'Простое содержимое'
// Эквивалент: contentType: 'plain/text'
}

See

UiContentType — возможные значения