Skip to content

components.ScrollLayer

vasili.kostin edited this page Aug 21, 2021 · 15 revisions

компоненты : Иконка компонента ScrollLayer

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

ScrollLayer - компонент, позволяющий добавить в игру область прокрутки. Текущее абсолютное положение области прокрутки определяется текущими координатами x, y ScrollLayer объекта, поэтому при редактировании сцены он может находиться только в 0, 0 координатах. Для перемещения ScrollLayer объекта по сцене, необходимо обернуть его в контейнер и перемещать этот контейнер вместо самого ScrollLayer объекта.

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

visibleArea

Тип: rect

Прямоугольная область, определяющая размеры "видимой" части области прокрутки. ScrollLayer не обеспечивает реального обрезания видимой области, поэтому дополнительно может понадобиться оборачивание области прокрутки в Scissors или Mask объект.


fullArea

Тип: rect

Прямоугольная область, определяющая полные размеры области прокрутки.


mouseHandler

Тип: data-path

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

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


desktopInertia

Тип: Number

Позволяет настроить силу инерции для области прокрутки на Desktop платформе. Значение по умолчанию соответствует наиболее комфортному поведению.


mobileInertia

Тип: Number

Позволяет настроить силу инерции для области прокрутки на Мобильных платформах. Значение по умолчанию соответствует наиболее комфортному поведению.


bouncingBounds

Тип: Boolean

Включает либо отключает эффект "мягкого отскока" при достижении края области прокрутки.


Свойства доступные из Javascript:

relativeScrollX

Тип: Number

Текущее положение прокрутки по оси x относительно полной ширины области прокрутки.


relativeScrollY

Тип: Number

Текущее положение прокрутки по оси y относительно полной высоты области прокрутки.


isXScrollAvailable

Тип: Boolean

Свойство доступное только для чтения.

Возвращает true, если полная ширина области прокрутки больше чем видимая ширина. Иначе, прокрутка по оси x невозможна.


isYScrollAvailable

Тип: Boolean

Свойство доступное только для чтения.

Возвращает true, если полная высота области прокрутки больше чем видимая высота. Иначе, прокрутка по оси y невозможна.


Методы:

scrollRight (pow : Number = 16)

Прокручивает область прокрутки вправо с заданной силой. Для прокрутки влево необходимо передать отрицательное значение параметру pow.


scrollDown (pow : Number = 16)

Прокручивает область прокрутки вниз с заданной силой. Для прокрутки вверх необходимо передать отрицательное значение параметру pow.


scrollTo (object : DisplayObject, callback : Function, instantly : Boolean)

Прокручивает область прокрутки к указанному объекту object, который должен быть дочерним объектом области прокрутки. callback - функция, которая будет вызвана при завершении прокрутки. Параметр instantly - указывает должна ли прокрутка произойти моментально, без эффекта анимации.

<- Предыдущая страница Следующая страница ->

Связанные темы:

Свойства, унаследованные от Container

Компоненты

Clone this wiki locally