smart-webcomponents
Version:
Web Components & Custom Elements for Professional Web Applications
656 lines (568 loc) • 23.4 kB
text/typescript
import { Slider } from './../index';
import { Animation, LabelsVisibility, DragMechanicalAction, ScaleMode, Orientation, ScalePosition, ScaleType, Position, TicksPosition, TicksVisibility, Validation, WordLength, ElementRenderMode} from './../index';
import { Component, Directive, AfterViewInit, ElementRef, Input, OnInit, OnChanges, OnDestroy, SimpleChanges, forwardRef, ChangeDetectionStrategy, Output, EventEmitter } from '@angular/core';
import { BaseElement, Smart } from './smart.element';
export { Animation, LabelsVisibility, DragMechanicalAction, ScaleMode, Orientation, ScalePosition, ScaleType, Position, TicksPosition, TicksVisibility, Validation, WordLength, ElementRenderMode} from './../index';
export { Smart } from './smart.element';
export { Slider } from './../index';
import { ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';
const CUSTOM_INPUT_CONTROL_VALUE_ACCESSOR: any = {
provide: NG_VALUE_ACCESSOR,
useExisting: forwardRef(() => SliderComponent),
multi: true
}
export class SliderComponent extends BaseElement implements OnInit, AfterViewInit, OnDestroy, OnChanges, ControlValueAccessor {
constructor(ref: ElementRef<Slider>) {
super(ref);
this.nativeElement = ref.nativeElement as Slider;
}
private eventHandlers: any[] = [];
public declare nativeElement: Slider;
/** @description Creates the component on demand.
* @param properties An optional object of properties, which will be added to the template binded ones.
*/
public createComponent(properties = {}): any {
this.nativeElement = <Slider>document.createElement('smart-slider');
for (let propertyName in properties) {
this.nativeElement[propertyName] = properties[propertyName];
}
return this.nativeElement;
}
/**
* @description
* The registered callback function called when a change event occurs on the form elements.
*/
_onChange: (value: any) => void = () => {};
/**
* @description
* The registered callback function called when a blur event occurs on the form elements.
*/
_onTouched: () => any = () => {};
/** @description Sets or gets the animation mode. Animation is disabled when the property is set to 'none' */
get animation(): Animation | string {
return this.nativeElement ? this.nativeElement.animation : undefined;
}
set animation(value: Animation | string) {
this.nativeElement ? this.nativeElement.animation = value : undefined;
}
/** @description With the coerce property true and clicking the track, the thumb and value are moved and set to the nearest value allowed by the interval property. */
get coerce(): boolean {
return this.nativeElement ? this.nativeElement.coerce : undefined;
}
set coerce(value: boolean) {
this.nativeElement ? this.nativeElement.coerce = value : undefined;
}
/** @description Sets or gets whether custom ticks at (possibly) uneven interval will be plotted. The ticks to be plotted are defined with the property customTicks. */
get customInterval(): boolean {
return this.nativeElement ? this.nativeElement.customInterval : undefined;
}
set customInterval(value: boolean) {
this.nativeElement ? this.nativeElement.customInterval = value : undefined;
}
/** @description If customInterval is enabled, sets a list of ticks to be plotted. If coerce is set to true, the value will snap to these ticks. */
get customTicks(): number[] {
return this.nativeElement ? this.nativeElement.customTicks : undefined;
}
set customTicks(value: number[]) {
this.nativeElement ? this.nativeElement.customTicks = value : undefined;
}
/** @description Sets or gets the pattern which labels are displayed in when mode is 'date'. */
get dateLabelFormatString(): string {
return this.nativeElement ? this.nativeElement.dateLabelFormatString : undefined;
}
set dateLabelFormatString(value: string) {
this.nativeElement ? this.nativeElement.dateLabelFormatString = value : undefined;
}
/** @description Sets or gets the char to use as the decimal separator in numeric values. */
get decimalSeparator(): string {
return this.nativeElement ? this.nativeElement.decimalSeparator : undefined;
}
set decimalSeparator(value: string) {
this.nativeElement ? this.nativeElement.decimalSeparator = value : undefined;
}
/** @description Enables or disables the widget. */
get disabled(): boolean {
return this.nativeElement ? this.nativeElement.disabled : undefined;
}
set disabled(value: boolean) {
this.nativeElement ? this.nativeElement.disabled = value : undefined;
}
/** @description Enables or disables incrementing/decrementing the value using the mouse wheel in jqxSlider. */
get enableMouseWheelAction(): boolean {
return this.nativeElement ? this.nativeElement.enableMouseWheelAction : undefined;
}
set enableMouseWheelAction(value: boolean) {
this.nativeElement ? this.nativeElement.enableMouseWheelAction = value : undefined;
}
/** @description Determines what values the thumb snaps to. */
get interval(): string | number {
return this.nativeElement ? this.nativeElement.interval : undefined;
}
set interval(value: string | number) {
this.nativeElement ? this.nativeElement.interval = value : undefined;
}
/** @description Sets the direction of the slider. If is true - positions of the slider's begin and end are changed. */
get inverted(): boolean {
return this.nativeElement ? this.nativeElement.inverted : undefined;
}
set inverted(value: boolean) {
this.nativeElement ? this.nativeElement.inverted = value : undefined;
}
/** @description A callback function that can be used to format the values displayed on the slider labels and tooltip. */
get labelFormatFunction(): any {
return this.nativeElement ? this.nativeElement.labelFormatFunction : undefined;
}
set labelFormatFunction(value: any) {
this.nativeElement ? this.nativeElement.labelFormatFunction = value : undefined;
}
/** @description Sets or gets the widget's label visibility. */
get labelsVisibility(): LabelsVisibility | string {
return this.nativeElement ? this.nativeElement.labelsVisibility : undefined;
}
set labelsVisibility(value: LabelsVisibility | string) {
this.nativeElement ? this.nativeElement.labelsVisibility = value : undefined;
}
/** @description Sets or gets the unlockKey which unlocks the product. */
get unlockKey(): string {
return this.nativeElement ? this.nativeElement.unlockKey : undefined;
}
set unlockKey(value: string) {
this.nativeElement ? this.nativeElement.unlockKey = value : undefined;
}
/** @description Sets or gets the locale. Used in conjunction with the property messages. */
get locale(): string {
return this.nativeElement ? this.nativeElement.locale : undefined;
}
set locale(value: string) {
this.nativeElement ? this.nativeElement.locale = value : undefined;
}
/** @description Callback, related to localization module. */
get localizeFormatFunction(): any {
return this.nativeElement ? this.nativeElement.localizeFormatFunction : undefined;
}
set localizeFormatFunction(value: any) {
this.nativeElement ? this.nativeElement.localizeFormatFunction = value : undefined;
}
/** @description Enables or disables the usage of logarithmic scale in the widget. */
get logarithmicScale(): boolean {
return this.nativeElement ? this.nativeElement.logarithmicScale : undefined;
}
set logarithmicScale(value: boolean) {
this.nativeElement ? this.nativeElement.logarithmicScale = value : undefined;
}
/** @description Sets or gets the maximum value of the widget. */
get max(): string | number {
return this.nativeElement ? this.nativeElement.max : undefined;
}
set max(value: string | number) {
this.nativeElement ? this.nativeElement.max = value : undefined;
}
/** @description Sets or gets the type of used mechanical action. */
get mechanicalAction(): DragMechanicalAction | string {
return this.nativeElement ? this.nativeElement.mechanicalAction : undefined;
}
set mechanicalAction(value: DragMechanicalAction | string) {
this.nativeElement ? this.nativeElement.mechanicalAction = value : undefined;
}
/** @description Sets or gets an object specifying strings used in the widget that can be localized. Used in conjunction with the property locale. */
get messages(): any {
return this.nativeElement ? this.nativeElement.messages : undefined;
}
set messages(value: any) {
this.nativeElement ? this.nativeElement.messages = value : undefined;
}
/** @description Sets or gets the minimum value of the widget. */
get min(): string | number {
return this.nativeElement ? this.nativeElement.min : undefined;
}
set min(value: string | number) {
this.nativeElement ? this.nativeElement.min = value : undefined;
}
/** @description Sets or gets whether the widget works with numbers or dates. */
get mode(): ScaleMode | string {
return this.nativeElement ? this.nativeElement.mode : undefined;
}
set mode(value: ScaleMode | string) {
this.nativeElement ? this.nativeElement.mode = value : undefined;
}
/** @description Sets or gets the element's name, which is used as a reference when the data is submitted. */
get name(): string {
return this.nativeElement ? this.nativeElement.name : undefined;
}
set name(value: string) {
this.nativeElement ? this.nativeElement.name = value : undefined;
}
/** @description Sets the orientation of the widget. */
get orientation(): Orientation | string {
return this.nativeElement ? this.nativeElement.orientation : undefined;
}
set orientation(value: Orientation | string) {
this.nativeElement ? this.nativeElement.orientation = value : undefined;
}
/** @description Determines the number of digits after the decimal point. Applicable only when scaleType is 'integer'. */
get precisionDigits(): number {
return this.nativeElement ? this.nativeElement.precisionDigits : undefined;
}
set precisionDigits(value: number) {
this.nativeElement ? this.nativeElement.precisionDigits = value : undefined;
}
/** @description Enables or disables the slider to be in range mode. If is set to true, the range is represented between two thumbs. */
get rangeSlider(): boolean {
return this.nativeElement ? this.nativeElement.rangeSlider : undefined;
}
set rangeSlider(value: boolean) {
this.nativeElement ? this.nativeElement.rangeSlider = value : undefined;
}
/** @description When the slider is read only the users cannot drag or click in the fill of the slider. */
get readonly(): boolean {
return this.nativeElement ? this.nativeElement.readonly : undefined;
}
set readonly(value: boolean) {
this.nativeElement ? this.nativeElement.readonly = value : undefined;
}
/** @description Sets or gets the value indicating whether the element is aligned to support locales using right-to-left fonts. */
get rightToLeft(): boolean {
return this.nativeElement ? this.nativeElement.rightToLeft : undefined;
}
set rightToLeft(value: boolean) {
this.nativeElement ? this.nativeElement.rightToLeft = value : undefined;
}
/** @description Sets the position of the widget's scales. */
get scalePosition(): ScalePosition | string {
return this.nativeElement ? this.nativeElement.scalePosition : undefined;
}
set scalePosition(value: ScalePosition | string) {
this.nativeElement ? this.nativeElement.scalePosition = value : undefined;
}
/** @description Sets the type of the slider's scale. */
get scaleType(): ScaleType | string {
return this.nativeElement ? this.nativeElement.scaleType : undefined;
}
set scaleType(value: ScaleType | string) {
this.nativeElement ? this.nativeElement.scaleType = value : undefined;
}
/** @description Enables or disables scientific notation. */
get scientificNotation(): boolean {
return this.nativeElement ? this.nativeElement.scientificNotation : undefined;
}
set scientificNotation(value: boolean) {
this.nativeElement ? this.nativeElement.scientificNotation = value : undefined;
}
/** @description Enables or disables displaying of the buttons. */
get showButtons(): boolean {
return this.nativeElement ? this.nativeElement.showButtons : undefined;
}
set showButtons(value: boolean) {
this.nativeElement ? this.nativeElement.showButtons = value : undefined;
}
/** @description Enables or disables displaying of the thumb label. */
get showThumbLabel(): boolean {
return this.nativeElement ? this.nativeElement.showThumbLabel : undefined;
}
set showThumbLabel(value: boolean) {
this.nativeElement ? this.nativeElement.showThumbLabel = value : undefined;
}
/** @description Enables or disables displaying of the tooltip. */
get showTooltip(): boolean {
return this.nativeElement ? this.nativeElement.showTooltip : undefined;
}
set showTooltip(value: boolean) {
this.nativeElement ? this.nativeElement.showTooltip = value : undefined;
}
/** @description Enables or disables displaying of the units. */
get showUnit(): boolean {
return this.nativeElement ? this.nativeElement.showUnit : undefined;
}
set showUnit(value: boolean) {
this.nativeElement ? this.nativeElement.showUnit = value : undefined;
}
/** @description Determining how many significant digits are in a number. Applicable only when scaleType is 'integer'. */
get significantDigits(): number {
return this.nativeElement ? this.nativeElement.significantDigits : undefined;
}
set significantDigits(value: number) {
this.nativeElement ? this.nativeElement.significantDigits = value : undefined;
}
/** @description Sets or gets the element's visual theme. */
get theme(): string {
return this.nativeElement ? this.nativeElement.theme : undefined;
}
set theme(value: string) {
this.nativeElement ? this.nativeElement.theme = value : undefined;
}
/** @description Sets or gets the position of the thumb label. */
get thumbLabelPosition(): Position | string {
return this.nativeElement ? this.nativeElement.thumbLabelPosition : undefined;
}
set thumbLabelPosition(value: Position | string) {
this.nativeElement ? this.nativeElement.thumbLabelPosition = value : undefined;
}
/** @description Sets or gets the position of the ticks in jqxSlider widget. */
get ticksPosition(): TicksPosition | string {
return this.nativeElement ? this.nativeElement.ticksPosition : undefined;
}
set ticksPosition(value: TicksPosition | string) {
this.nativeElement ? this.nativeElement.ticksPosition = value : undefined;
}
/** @description Sets or gets the visibility of the ticks. */
get ticksVisibility(): TicksVisibility | string {
return this.nativeElement ? this.nativeElement.ticksVisibility : undefined;
}
set ticksVisibility(value: TicksVisibility | string) {
this.nativeElement ? this.nativeElement.ticksVisibility = value : undefined;
}
/** @description Sets or gets the position of the tooltip in jqxSlider widget. */
get tooltipPosition(): Position | string {
return this.nativeElement ? this.nativeElement.tooltipPosition : undefined;
}
set tooltipPosition(value: Position | string) {
this.nativeElement ? this.nativeElement.tooltipPosition = value : undefined;
}
/** @description Sets or gets if the element can be focused. */
get unfocusable(): boolean {
return this.nativeElement ? this.nativeElement.unfocusable : undefined;
}
set unfocusable(value: boolean) {
this.nativeElement ? this.nativeElement.unfocusable = value : undefined;
}
/** @description Sets or gets the name of unit used in jqxSlider widget. */
get unit(): string {
return this.nativeElement ? this.nativeElement.unit : undefined;
}
set unit(value: string) {
this.nativeElement ? this.nativeElement.unit = value : undefined;
}
/** @description Sets the value's validation by min/max. If 'strict' is applied, the value is always validated by min and max. If 'interaction' is applied, programmatic value changes are not coerced to min/max and if min/max are changed, resulting in the current value being out of range, the value is not coerced, and no change event is fired. */
get validation(): Validation | string {
return this.nativeElement ? this.nativeElement.validation : undefined;
}
set validation(value: Validation | string) {
this.nativeElement ? this.nativeElement.validation = value : undefined;
}
/** @description Sets or gets the value of the jqxSlider widget. The property is used when the rangeSlider property is set to false. */
get value(): any {
return this.nativeElement ? this.nativeElement.value : undefined;
}
set value(value: any) {
this.nativeElement ? this.nativeElement.value = value : undefined;
}
/** @description Sets or gets the value of the jqxSlider widget. The property is used when the rangeSlider property is set to true. */
get values(): number[] {
return this.nativeElement ? this.nativeElement.values : undefined;
}
set values(value: number[]) {
this.nativeElement ? this.nativeElement.values = value : undefined;
}
/** @description Sets or gets the word length. Applicable only when scaleType is 'integer'. */
get wordLength(): WordLength | string {
return this.nativeElement ? this.nativeElement.wordLength : undefined;
}
set wordLength(value: WordLength | string) {
this.nativeElement ? this.nativeElement.wordLength = value : undefined;
}
/** @description This event is triggered when the value of the slider is changed.
* @param event. The custom event. Custom event was created with: event.detail( value, oldValue)
* value - A numeric value indicating the scroll position.
* oldValue - A numeric value indicating the previous scroll position.
*/
onChange: EventEmitter<CustomEvent> = new EventEmitter();
/** @description Focuses the slider.
*/
public focus(): void {
if (this.nativeElement.isRendered) {
this.nativeElement.focus();
}
else
{
this.nativeElement.whenRendered(() => {
this.nativeElement.focus();
});
}
}
/** @description Gets the optimal size of the widget.
* @returns {any}
*/
public async getOptimalSizeAsync(): Promise<any> {
const getResultOnRender = () => {
return new Promise(resolve => {
this.nativeElement.whenRendered(() => {
const result = this.nativeElement.getOptimalSize();
resolve(result)
});
});
};
const result = await getResultOnRender();
return result;
}
public getOptimalSize(): any {
if (this.nativeElement.isRendered) {
return this.nativeElement.getOptimalSize();
}
return null;
}
/** @description Get/set the value of the slider.
* @param {string | number | number[] | string[]} value?. The value to be set. If no parameter is passed, returns the displayed value of the slider.
* @returns {string}
*/
public async valAsync(value?): Promise<any> {
const getResultOnRender = () => {
return new Promise(resolve => {
this.nativeElement.whenRendered(() => {
const result = this.nativeElement.val(value);
resolve(result)
});
});
};
const result = await getResultOnRender();
return result;
}
public val(value?): string {
if (this.nativeElement.isRendered) {
return this.nativeElement.val(value);
}
return null;
}
get isRendered(): boolean {
return this.nativeElement ? this.nativeElement.isRendered : false;
}
ngOnInit() {
}
ngAfterViewInit() {
const that = this;
that.onCreate.emit(that.nativeElement);
if (Smart) Smart.Render();
this.nativeElement.classList.add('smart-angular');
if (this.nativeElement.whenRendered) this.nativeElement.whenRendered(() => { that.onReady.emit(that.nativeElement); });
this.listen();
}
ngOnDestroy() {
this.unlisten();
}
_initialChange = true;
get ngValue(): any {
if (!this.nativeElement) {
return null;
}
const value = this.nativeElement.value;
return value;
}
set ngValue(value: any) {
if (this.nativeElement) {
this.writeValue(value);
}
}
writeValue(value: any): void {
const that = this;
const normalizedValue = value == null ? '' : value;
that.nativeElement.whenRendered(() => {
that.value = normalizedValue;
if (that._initialChange === false) {
that._onChange(that.value);
}
});
}
registerOnChange(fn: any): void {
this._onChange = fn;
}
registerOnTouched(fn: any): void {
this._onTouched = fn;
}
ngOnChanges(changes: SimpleChanges) {
if (this.nativeElement && this.nativeElement.isRendered) {
for (const propName in changes) {
if (changes.hasOwnProperty(propName)) {
this.nativeElement[propName] = changes[propName].currentValue;
}
}
}
}
/** @description Add event listeners. */
private listen(): void {
const that = this;
that.eventHandlers['changeHandler'] = (event: CustomEvent) => { that.onChange.emit(event); }
that.nativeElement.addEventListener('change', that.eventHandlers['changeHandler']);
that.eventHandlers['changeModelHandler'] = (event: Event) => {
that._initialChange = false;
that._onChange(that.nativeElement.value);
};
that.eventHandlers['blurModelHandler'] = (event: Event) => {
that._onTouched();
};
that.nativeElement.whenRendered(() => {
if (that.nativeElement.querySelector('input')) {
that.eventHandlers['keyupModelHandler'] = (event) => {
setTimeout(() => { that.eventHandlers['changeModelHandler'](event); }, 50);
};
that.nativeElement.querySelector('input').addEventListener('keyup', that.eventHandlers['keyupModelHandler']);
}
});
that.nativeElement.addEventListener('change', that.eventHandlers['changeModelHandler']);
that.nativeElement.addEventListener('blur', that.eventHandlers['blurModelHandler']);
}
/** @description Remove event listeners. */
private unlisten(): void {
const that = this;
if (that.eventHandlers['changeHandler']) {
that.nativeElement.removeEventListener('change', that.eventHandlers['changeHandler']);
}
if (that.eventHandlers['changeModelHandler']) {
that.nativeElement.removeEventListener('change', that.eventHandlers['changeModelHandler']);
if (that.nativeElement.querySelector('input')) {
that.nativeElement.querySelector('input').removeEventListener('keyup', that.eventHandlers['keyupModelHandler']);
}
}
if (that.eventHandlers['blurModelHandler']) {
that.nativeElement.removeEventListener('blur', that.eventHandlers['blurModelHandler']);
}
}
}