components.HTMLOverlay

компоненты : HTMLOverlay

Наследуется от ScrollLayer, и включает в себя все его свойства.

HTMLOverlay - компонент, позволяющий отобразить HTML содержимое на сцене.

HTMLOverlay не встраивает HTML содержимое напрямую в сцену. А лишь размещает HTML поверх всей сцены. При этом размеры и положение HTML блока соответствуют размерам и положению HTMLOverlay объекта на игровом экране.

Наиболее подходящее применение для HTMLOverlay - отображение описания игры во всплывающем окне.

В режиме редактирования сцены, HTML содержимое не отображается на экране. HTML содержимое отображается только при запуске сцены на выполнение.

Редактируемые свойства:

innerHTML

Тип: String

HTML текст, который требуется отобразить на экране.

Удобнее присваивать значение этому полю из javascript кода, так как редактор свойств не приспособлен для редактирования больших текстов.

Любые теги этого поля не экранируются, поэтому будьте осторожны при присвоении этому полю непроверенных данных. Подробнее об уязвимости Cross Site Scripting

handleScroll

Тип: Boolean

По умолчанию, HTMLOverlay берет на себя ответственность за прокрутку текста игроком, именно для этого HTMLOverlay наследует свойства ScrollLayer.

Если по каким-то причинам вам требуется отключить встроенную прокрутку HTMLOverlay, задайте полю handleScroll значение false.

mouseHandler

Тип: data-path

Текстовый путь, указывающий на объект, который будет использоваться для захвата жестов скролла или колеса мыши. Подробнее о путях к переменным: Data-Path редактор. При этом свойство interactive указанного объекта должно быть установлено в true, иначе пользователь не сможет скроллить эту область прокрутки.

Если поле mouseHandler оставить пустым, то прокрутка будет работать для жестов на всем игровом экране. Это полезно для областей прокрутки, занимающих весь экран.

zIndex

Тип: Number

Задает CSS z-index, который будет присвоен отображаемому HTML блоку. При помощи этого свойства невозможно перемещать блок внутри игровой сцены. Поле добавлено для решения возможных конфликтов с другими HTML элементами, которые разработчик, возможно, добавляет на страницу сторонними способами.