Class ProgressPreloader<StaticProps, ChangeableProps, CallbacksTypes>

Page preloader that calculates the loading progress of page resources such as images, videos, and custom elements. Provides smooth progress calculation using an animation frame and optionally a timeline for forced completion.

Requires

Requires styles: @import '~vevet/lib/styles/components/Preloader';

Hierarchy

Preloader<StaticProps, ChangeableProps, CallbacksTypes>
- ProgressPreloader

Constructors

constructor

new ProgressPreloader<StaticProps, ChangeableProps, CallbacksTypes>(initialProps?, canInit?): ProgressPreloader<StaticProps, ChangeableProps, CallbacksTypes>
Type Parameters
- StaticProps extends NProgressPreloader.IStaticProps = NProgressPreloader.IStaticProps
- ChangeableProps extends NProgressPreloader.IChangeableProps = NProgressPreloader.IChangeableProps
- CallbacksTypes extends NProgressPreloader.ICallbacksTypes = NProgressPreloader.ICallbacksTypes
Parameters
- Optional initialProps: StaticProps & ChangeableProps
- canInit: boolean = true
Returns ProgressPreloader<StaticProps, ChangeableProps, CallbacksTypes>
Overrides Preloader.constructor
- Defined in src/components/ProgressPreloader/index.ts:151

Accessors

callbacks

get callbacks(): Callbacks<CallbacksTypes>
Retrieves the module's registered callbacks.

Returns Callbacks<CallbacksTypes>
Inherited from Preloader.callbacks
- Defined in src/base/Module/index.ts:79

container

get container(): undefined | false | HTMLElement
Returns the preloader container element.

Returns undefined | false | HTMLElement
Inherited from Preloader.container
- Defined in src/components/Preloader/index.ts:47

customResources

get customResources(): ICustomResourceData[]
Returns the list of custom resources to be preloaded.

Returns ICustomResourceData[]
- Defined in src/components/ProgressPreloader/index.ts:78

images

get images(): HTMLImageElement[]
Returns the list of images to be preloaded.

Returns HTMLImageElement[]
- Defined in src/components/ProgressPreloader/index.ts:54

isDestroyed

get isDestroyed(): boolean
Checks if the module has been destroyed.

Returns boolean
Inherited from Preloader.isDestroyed
- Defined in src/base/Module/index.ts:118

isHidden

get isHidden(): boolean
Returns whether the preloader is hidden.

Returns boolean
Inherited from Preloader.isHidden
- Defined in src/components/Preloader/index.ts:64

isInitialized

get isInitialized(): boolean
Checks if the module has been initialized.

Returns boolean
Inherited from Preloader.isInitialized
- Defined in src/base/Module/index.ts:108

loadProgress

get loadProgress(): number
The current loading progress as a fraction between 0 and 1.

Returns number
- Defined in src/components/ProgressPreloader/index.ts:116

loadedResourcesQuantity

get loadedResourcesQuantity(): number
Returns the number of resources that have been successfully loaded.

Returns number
- Defined in src/components/ProgressPreloader/index.ts:109

name

get name(): string
The name of the module, derived from the class name

Returns string
Inherited from Preloader.name
- Defined in src/base/Module/index.ts:93

prefix

get prefix(): string
Optional prefix for class names used by the module

Returns string
Inherited from Preloader.prefix
- Defined in src/components/Preloader/index.ts:35

progress

get progress(): number
Returns the current preloader progress value.

Returns number
- Defined in src/components/ProgressPreloader/index.ts:128
set progress(val): void
Sets the preloader's progress value and triggers progress change handling.
Parameters
- val: number
Returns void
- Defined in src/components/ProgressPreloader/index.ts:135

props

get props(): TRequiredModuleProp<StaticProps & ChangeableProps>
The current properties of the module, which include both static and changeable properties. These can be retrieved dynamically during the module's lifecycle.

Returns TRequiredModuleProp<StaticProps & ChangeableProps>
Inherited from Preloader.props
- Defined in src/base/Module/index.ts:64

resourcesQuantity

get resourcesQuantity(): number
Returns the total number of resources to be preloaded, accounting for user-defined resources and automatic resources.

Returns number
- Defined in src/components/ProgressPreloader/index.ts:90

videos

get videos(): HTMLVideoElement[]
Returns the list of videos to be preloaded.

Returns HTMLVideoElement[]
- Defined in src/components/ProgressPreloader/index.ts:66

Methods

addCallback

addCallback<T>(target, action, settings?): IAddedCallback
Adds a custom callback to the module.
Type Parameters
- T extends string | number | symbol
Parameters
- target: T
  
  The event type to listen for (e.g., 'propsChange', 'destroy').
- action: TAction<CallbacksTypes[T]>
  
  The function to execute when the event is triggered.
- settings: ISettings = {}
  
  Additional settings for the callback.
Returns IAddedCallback
Inherited from Preloader.addCallback
- Defined in src/base/Module/index.ts:245

addEventListener

addEventListener<Target, Listener>(element, target, callback, options?): (() => void)
Adds a DOM event listener that will be automatically removed when the module is destroyed.
Type Parameters
- Target extends keyof HTMLElementEventMap
- Listener extends ((event) => void)
Parameters
- element: Document | Element | Window
  
  The target element for the event listener.
- target: Target
  
  The event type to listen for (e.g., 'click', 'resize').
- callback: Listener
  
  The callback function to execute when the event is triggered.
- Optional options: boolean | AddEventListenerOptions
  
  Additional options for the event listener.
Returns (() => void)
- - (): void
  - Returns void
Inherited from Preloader.addEventListener
- Defined in src/base/Module/index.ts:261

addPlugin

addPlugin<T>(plugin): void
Adds a plugin to the component. The plugin is initialized upon being added, and the plugin's component property is set to the current component instance.
Type Parameters
- T extends Plugin<any, any, any, any>
Parameters
- plugin: T
  
  An instance of the Plugin class to be added.
Returns void
Inherited from Preloader.addPlugin
- Defined in src/base/Component/index.ts:30

addResponsiveProps

addResponsiveProps(rules): void
Adds responsive property rules to the module. This must be done before initialization.
Parameters
- rules: IResponsive<ChangeableProps>
  
  The responsive property rules to be added.
Returns void
Inherited from Preloader.addResponsiveProps
- Defined in src/base/Module/index.ts:159

addViewportCallback

addViewportCallback(target, action, data?): void
Adds a viewport callback that will be automatically removed when the module is destroyed.
Parameters
- target: keyof IViewportCallbackTypes
  
  The viewport target (e.g., width or height).
- action: (() => void)
  
  The callback function to execute when the viewport target changes.
  - - (): void
    - Returns void
- data: undefined | ISettings = {}
  
  Additional data for the callback.
Returns void
Inherited from Preloader.addViewportCallback
- Defined in src/base/Module/index.ts:225

changeProps

changeProps(props): void
Updates the changeable properties of the module.
Parameters
- props: Partial<ChangeableProps>
  
  The properties to be updated.
Returns void
Inherited from Preloader.changeProps
- Defined in src/base/Module/index.ts:174

destroy

destroy(): void
Destroys the module, cleaning up resources, callbacks, and event listeners.

Returns void
Inherited from Preloader.destroy
- Defined in src/base/Module/index.ts:310

hide

hide(duration?): PCancelable<any>
Hides the preloader with an optional animation duration.
Parameters
- duration: number = ...
  
  The duration of the hide animation (in milliseconds).
Returns PCancelable<any>
Inherited from Preloader.hide
- Defined in src/components/Preloader/index.ts:141

init

init(): void
Initializes the module. Calls the internal _init method and marks the module as initialized.

Returns void
Inherited from Preloader.init
- Defined in src/base/Module/index.ts:194

iterateLoadedResources

iterateLoadedResources(quantityProp?): void
Increments the loaded resources count by a given quantity.
Parameters
- quantityProp: number = 1
Returns void
- Defined in src/components/ProgressPreloader/index.ts:345

iterateResourcesQuantity

iterateResourcesQuantity(quantity?): void
Increments the total resource count by a given quantity.
Parameters
- quantity: number = 1
  
  The number of resources to add to the total.
Returns void
- Defined in src/components/ProgressPreloader/index.ts:358

onHidden

onHidden(action): undefined | IAddedCallback
Registers a callback for when the preloader is fully hidden.
Parameters
- action: (() => void)
  
  The callback function to execute.
  - - (): void
    - Returns void
Returns undefined | IAddedCallback
A cancelable action or undefined if already hidden.
Inherited from Preloader.onHidden
- Defined in src/components/Preloader/index.ts:206

onHide

onHide(action): undefined | IAddedCallback
Registers a callback for when the preloader starts hiding.
Parameters
- action: (() => void)
  
  The callback function to execute.
  - - (): void
    - Returns void
Returns undefined | IAddedCallback
A cancelable action or undefined if already in hiding process.
Inherited from Preloader.onHide
- Defined in src/components/Preloader/index.ts:190

Class ProgressPreloader<StaticProps, ChangeableProps, CallbacksTypes>

Requires

Link

Link

Type Parameters

StaticProps extends NProgressPreloader.IStaticProps = NProgressPreloader.IStaticProps

ChangeableProps extends NProgressPreloader.IChangeableProps = NProgressPreloader.IChangeableProps

CallbacksTypes extends NProgressPreloader.ICallbacksTypes = NProgressPreloader.ICallbacksTypes

Hierarchy

Index

Constructors

Accessors

Methods

Constructors

constructor

Type Parameters

StaticProps extends NProgressPreloader.IStaticProps = NProgressPreloader.IStaticProps

ChangeableProps extends NProgressPreloader.IChangeableProps = NProgressPreloader.IChangeableProps

CallbacksTypes extends NProgressPreloader.ICallbacksTypes = NProgressPreloader.ICallbacksTypes

Parameters

Optional initialProps: StaticProps & ChangeableProps

canInit: boolean = true

Returns ProgressPreloader<StaticProps, ChangeableProps, CallbacksTypes>

Accessors

callbacks

Returns Callbacks<CallbacksTypes>

container

Returns undefined | false | HTMLElement

customResources

Returns ICustomResourceData[]

images

Returns HTMLImageElement[]

isDestroyed

Returns boolean

isHidden

Returns boolean

isInitialized

Returns boolean

loadProgress

Returns number

loadedResourcesQuantity

Returns number

name

Returns string

prefix

Returns string

progress

Returns number

Parameters

val: number

Returns void

props

Returns TRequiredModuleProp<StaticProps & ChangeableProps>

resourcesQuantity

Returns number

videos

Returns HTMLVideoElement[]

Methods

addCallback

Type Parameters

T extends string | number | symbol

Parameters

target: T

action: TAction<CallbacksTypes[T]>

settings: ISettings = {}

Returns IAddedCallback

addEventListener

Type Parameters

Target extends keyof HTMLElementEventMap

Listener extends ((event) => void)

Parameters

element: Document | Element | Window

target: Target

callback: Listener

Optional options: boolean | AddEventListenerOptions

Returns (() => void)

Returns void

addPlugin

Type Parameters

T extends Plugin<any, any, any, any>

`Optional` initialProps: StaticProps & ChangeableProps

`Optional` options: boolean | AddEventListenerOptions