Interface State
clear(): void;
get(options: { name: string }): TJSPositionDataExtra;
getDefault(): TJSPositionDataExtra;
keys(): IterableIterator<string>;
remove(options: { name: string }): TJSPositionDataExtra;
reset(options?: { invokeSet?: boolean; keepZIndex?: boolean }): boolean;
restore(
options: {
animateTo?: boolean;
async?: boolean;
duration?: number;
ease?: EasingReference;
name: string;
properties?: Iterable<string>;
remove?: boolean;
silent?: boolean;
},
): TJSPositionDataExtra
| Promise<TJSPositionDataExtra>;
save(
options: { name: string; [key: string]: any },
optionsGet?: TJSPosition.Options.Get,
): TJSPositionDataExtra;
set(options: { name: string; [key: string]: any }): void;
}
Methods
clear
Returns void
get
Gets any stored saved position data by name.
Parameters
- options: { name: string }
Options.
name: string
Saved data name.
Returns TJSPositionDataExtra
Any saved position data.
- options: { name: string }
getDefault
Returns any associated default position data.
Returns TJSPositionDataExtra
Any saved default position data.
keys
Returns IterableIterator<string>
The saved position data names / keys.
remove
Removes and returns any position data by name.
Parameters
- options: { name: string }
Options.
name: string
Name to remove and retrieve.
Returns TJSPositionDataExtra
Any saved position data.
- options: { name: string }
reset
Resets position instance to default data and invokes set.
Parameters
Optionaloptions: { invokeSet?: boolean; keepZIndex?: boolean }Optional parameters.
OptionalinvokeSet?: booleanWhen true invokes set method.
OptionalkeepZIndex?: booleanWhen true keeps current z-index.
Returns boolean
Operation successful.
restore
- restore(
options: {
animateTo?: boolean;
async?: boolean;
duration?: number;
ease?: EasingReference;
name: string;
properties?: Iterable<string>;
remove?: boolean;
silent?: boolean;
},
): TJSPositionDataExtra
| Promise<TJSPositionDataExtra>Restores a saved positional state returning the data. Several optional parameters are available to control whether the restore action occurs silently (no store / inline styles updates), animates to the stored data, or simply sets the stored data. Restoring via AnimationAPI.to allows specification of the duration and easing along with configuring a Promise to be returned if awaiting the end of the animation.
Parameters
- options: {
animateTo?: boolean;
async?: boolean;
duration?: number;
ease?: EasingReference;
name: string;
properties?: Iterable<string>;
remove?: boolean;
silent?: boolean;
}Parameters
OptionalanimateTo?: booleanAnimate to restore data.
Optionalasync?: booleanIf animating return a Promise that resolves with any saved data.
Optionalduration?: numberDuration in seconds.
Optionalease?: EasingReferenceEasing function name or function.
name: string
Saved data set name.
Optionalproperties?: Iterable<string>Specific properties to set / animate.
Optionalremove?: booleanRemove data set.
Optionalsilent?: booleanSet position data directly; no store or style updates.
Returns TJSPositionDataExtra | Promise<TJSPositionDataExtra>
Any saved position data.
- options: {
save
- save(
options: { name: string; [key: string]: any },
optionsGet?: TJSPosition.Options.Get,
): TJSPositionDataExtraSaves current position state with the opportunity to add extra data to the saved state. Simply include extra properties in
optionsto save extra data.Parameters
- options: { name: string; [key: string]: any }
Options.
[key: string]: any
name: string
name to index this saved data.
OptionaloptionsGet: TJSPosition.Options.GetAdditional options for TJSPosition.get when serializing position state. By default,
nullablevalues are included.
Returns TJSPositionDataExtra
Current position data.
- options: { name: string; [key: string]: any }
set
Directly sets a saved position state. Simply include extra properties in
optionsto set extra data.Parameters
- options: { name: string; [key: string]: any }
Options.
[key: string]: any
name: string
name to index this saved data.
Returns void
- options: { name: string; [key: string]: any }
Clears all saved position data except any default state.