UIScrollContainer
class UIScrollContainer
extends
UIContainer
Represents a UI component that contains other components and allows scrolling horizontally and/or vertically, and emits throttled scroll events (Scroll
and ScrollEnd
, see UIScrollEvent
).
Constructor
(...content:
UIRenderable
[]): UIScrollContainer
.verticalSnap
"start" | "end" | "center"
Vertical scroll snap mode: start
(snap to start of first ‘mostly’ visible component), center
(snap container center to center of component closest to the center), or end
(snap to end of last ‘mostly’ visible component).
.horizontalSnap
"start" | "end" | "center"
Horizontal scroll snap mode: start
(snap to start of first ‘mostly’ visible component), center
(snap container center to center of component closest to the center), or end
(snap to end of last ‘mostly’ visible component).
.topThreshold
number
Vertical threshold (in pixels) until which UIScrollEvent.atTop
is set, defaults to 0.
.bottomThreshold
number
Vertical threshold (in pixels) until which UIScrollEvent.atBottom
is set, defaults to 0.
.leftThreshold
number
Horizontal threshold (in pixels) until which UIScrollEvent.atLeft
is set, defaults to 0.
.rightThreshold
number
Horizontal threshold (in pixels) until which UIScrollEvent.atRight
is set, defaults to 0.
.verticalScrollEnabled
boolean
True if vertical scrolling should be enabled, defaults to true.
.horizontalScrollEnabled
boolean
True if horizontal scrolling should be enabled, defaults to true.
.handleScrollSnap()
(e:
UIScrollEvent
): void
Handle given scroll event to snap scroll position to content components; called automatically when the container is scrolled, but may be overridden.
.applyStyle() protected
(style?:
UIStyle
): void
Inherited from UIContainer.applyStyle
.
.isFocusable()
(): boolean
Inherited from UIContainer.isFocusable
.
.isKeyboardFocusable()
(): boolean
Inherited from UIContainer.isKeyboardFocusable
.
.allowFocus
boolean
Inherited from UIContainer.allowFocus
.
.allowKeyboardFocus
boolean
Inherited from UIContainer.allowKeyboardFocus
.
.layout
Readonly<ContainerLayout>
Inherited from UIContainer.layout
.
.asyncContentRendering
boolean
Inherited from UIContainer.asyncContentRendering
.
.animatedContentRenderingDuration
number
Inherited from UIContainer.animatedContentRenderingDuration
.
.animatedContentRenderingVelocity
number
Inherited from UIContainer.animatedContentRenderingVelocity
.
.content
Inherited from UIContainer.content
.
.propagateComponentEvent() deprecated
(name: string, inner?:
ManagedEvent
, event?: any): void
Inherited from UIComponent.propagateComponentEvent
.
.delegateEvent() protected
(e:
ManagedEvent
, propertyName: string): true
Inherited from UIComponent.delegateEvent
.
.render()
(callback: RenderCallback<Output<
UIRenderable
, any>>): void
Inherited from UIComponent.render
.
.requestFocus()
(): void
Inherited from UIComponent.requestFocus
.
.requestFocusNext()
(): void
Inherited from UIComponent.requestFocusNext
.
.requestFocusPrevious()
(): void
Inherited from UIComponent.requestFocusPrevious
.
.style
Inherited from UIComponent.style
.
.hidden
boolean
Inherited from UIComponent.hidden
.
.dimensions
Readonly<Dimensions>
Inherited from UIComponent.dimensions
.
.position
Readonly<Position>
Inherited from UIComponent.position
.
.accessibleRole
string
Inherited from UIComponent.accessibleRole
.
.accessibleLabel
string
Inherited from UIComponent.accessibleLabel
.
.lastRenderOutput
Output<this, any>
Inherited from UIComponent.lastRenderOutput
.
.isPresetComponent() protected
(): boolean
Inherited from Component.isPresetComponent
.
.getParentComponent()
<TParent extends Component = Component>(ParentClass?:
ComponentConstructor
<TParent>): TParent
Inherited from Component.getParentComponent
.
.getBoundParentComponent()
<TParent extends Component>(ParentClass?:
ComponentConstructor
<TParent>): TParent
Inherited from Component.getBoundParentComponent
.
.emitAction()
(name: string, inner?:
ManagedEvent
, context?:
ManagedObject
): void
Inherited from Component.emitAction
.
.managedId
number
Inherited from ManagedObject.managedId
.
.managedState
Inherited from ManagedObject.managedState
.
.getReferenceCount() protected
(): number
Inherited from ManagedObject.getReferenceCount
.
.getManagedReferrers() protected
():
ManagedObject
[]
Inherited from ManagedObject.getManagedReferrers
.
.getManagedParent() protected
<TParent extends ManagedObject = ManagedObject>(ParentClass?:
ManagedObjectConstructor
<TParent>): TParent
Inherited from ManagedObject.getManagedParent
.
.emit()
<TEvent extends ManagedEvent = ManagedEvent, TConstructorArgs extends any[] = any[]>(e: string | TEvent | (new (...args: TConstructorArgs) => TEvent), ...constructorArgs: TConstructorArgs): this
Inherited from ManagedObject.emit
.
.emitChange()
(name?: string): void
Inherited from ManagedObject.emitChange
.
.propagateChildEvents() protected deprecated
(...types: ((new (...args: any[]) =>
ManagedEvent
) | ((e:
ManagedEvent
) => any))[]): this
Inherited from ManagedObject.propagateChildEvents
.
.activateManagedAsync() protected
(): Promise<any>
Inherited from ManagedObject.activateManagedAsync
.
.deactivateManagedAsync() protected
(): Promise<void>
Inherited from ManagedObject.deactivateManagedAsync
.
.destroyManagedAsync() protected
(): Promise<void>
Inherited from ManagedObject.destroyManagedAsync
.
.onManagedStateActivatingAsync() protected
(): Promise<void>
Inherited from ManagedObject.onManagedStateActivatingAsync
.
.onManagedStateActiveAsync() protected
(): Promise<void>
Inherited from ManagedObject.onManagedStateActiveAsync
.
.onManagedStateDeactivatingAsync() protected
(): Promise<void>
Inherited from ManagedObject.onManagedStateDeactivatingAsync
.
.onManagedStateInactiveAsync() protected
(): Promise<void>
Inherited from ManagedObject.onManagedStateInactiveAsync
.
.onManagedStateDestroyingAsync() protected
(): Promise<void>
Inherited from ManagedObject.onManagedStateDestroyingAsync
.
UIScrollContainer.Presets
extends
UIContainer.Presets
UIScrollContainer presets type, for use with Component.with
.
.verticalScrollEnabled
boolean
True if vertical scrolling should be enabled, defaults to true.
.horizontalScrollEnabled
boolean
True if horizontal scrolling should be enabled, defaults to true.
.verticalSnap
"start" | "end" | "center"
Vertical scroll snap mode: start
(snap to start of first ‘mostly’ visible component), center
(snap container center to center of component closest to the center), or end
(snap to end of last ‘mostly’ visible component).
.horizontalSnap
"start" | "end" | "center"
Horizontal scroll snap mode: start
(snap to start of first ‘mostly’ visible component), center
(snap container center to center of component closest to the center), or end
(snap to end of last ‘mostly’ visible component).
.topThreshold
number
Vertical threshold (in pixels) until which UIScrollEvent.atTop
is set, defaults to 0.
.bottomThreshold
number
Vertical threshold (in pixels) until which UIScrollEvent.atBottom
is set, defaults to 0.
.leftThreshold
number
Horizontal threshold (in pixels) until which UIScrollEvent.atLeft
is set, defaults to 0.
.rightThreshold
number
Horizontal threshold (in pixels) until which UIScrollEvent.atRight
is set, defaults to 0.
.onScroll
UIComponentEventHandler
<
UIComponent
,
UIComponentEvent
<
UIComponent
>>
Event handler for Scroll events.
.onScrollEnd
UIComponentEventHandler
<
UIComponent
,
UIComponentEvent
<
UIComponent
>>
Event handler for ScrollEnd events.
.content
Iterable<
UIRenderable
>
Inherited from UIContainer.Presets.content
.
.layout
Partial<{} | ContainerLayout>
Inherited from UIContainer.Presets.layout
.
.allowFocus
boolean
Inherited from UIContainer.Presets.allowFocus
.
.allowKeyboardFocus
boolean
Inherited from UIContainer.Presets.allowKeyboardFocus
.
.asyncContentRendering
boolean
Inherited from UIContainer.Presets.asyncContentRendering
.
.animatedContentRenderingDuration
number
Inherited from UIContainer.Presets.animatedContentRenderingDuration
.
.animatedContentRenderingVelocity
number
Inherited from UIContainer.Presets.animatedContentRenderingVelocity
.
.style
string |
UIStyle
Inherited from UIComponent.Presets.style
.
.hidden
boolean
Inherited from UIComponent.Presets.hidden
.
.dimensions
Partial<{} | Dimensions>
Inherited from UIComponent.Presets.dimensions
.
.position
Partial<{} | Position>
Inherited from UIComponent.Presets.position
.
.accessibleRole
string
Inherited from UIComponent.Presets.accessibleRole
.
.accessibleLabel
string
Inherited from UIComponent.Presets.accessibleLabel
.
.requestFocus
boolean
Inherited from UIComponent.Presets.requestFocus
.