@angular-slider/ngx-slider/types/angular-slider-ngx-slider.d.ts

Self-contained, mobile friendly slider component for Angular based on angularjs-slider

import * as i0 from '@angular/core';
import { InjectionToken, OnInit, AfterViewInit, OnChanges, OnDestroy, EventEmitter, TemplateRef, SimpleChanges, ElementRef, Renderer2, ChangeDetectorRef } from '@angular/core';
import { ControlValueAccessor } from '@angular/forms';
import * as i6 from '@angular/common';

/** Pointer type */
declare enum PointerType {
    /** Low pointer */
    Min = 0,
    /** High pointer */
    Max = 1
}

/** Label type */
declare enum LabelType {
    /** Label above low pointer */
    Low = 0,
    /** Label above high pointer */
    High = 1,
    /** Label for minimum slider value */
    Floor = 2,
    /** Label for maximum slider value */
    Ceil = 3,
    /** Label below legend tick */
    TickValue = 4
}
/** Function to translate label value into text */
type TranslateFunction = (value: number, label: LabelType) => string;
/** Function to combind */
type CombineLabelsFunction = (minLabel: string, maxLabel: string) => string;
/** Function to provide legend  */
type GetLegendFunction = (value: number) => string;
type GetStepLegendFunction = (step: CustomStepDefinition) => string;
/** Function converting slider value to slider position */
type ValueToPositionFunction = (val: number, minVal: number, maxVal: number) => number;
/** Function converting slider position to slider value */
type PositionToValueFunction = (percent: number, minVal: number, maxVal: number) => number;
/**
 * Custom step definition
 *
 * This can be used to specify custom values and legend values for slider ticks
 */
interface CustomStepDefinition {
    /** Value */
    value: number;
    /** Legend (label for the value) */
    legend?: string;
}
/** Slider options */
declare class Options {
    /** Minimum value for a slider.
      Not applicable when using stepsArray. */
    floor?: number;
    /** Maximum value for a slider.
      Not applicable when using stepsArray. */
    ceil?: number;
    /** Step between each value.
      Not applicable when using stepsArray. */
    step?: number;
    /** The minimum range authorized on the slider.
      Applies to range slider only.
      When using stepsArray, expressed as index into stepsArray. */
    minRange?: number;
    /** The maximum range authorized on the slider.
      Applies to range slider only.
      When using stepsArray, expressed as index into stepsArray. */
    maxRange?: number;
    /** Set to true to have a push behavior. When the min handle goes above the max,
      the max is moved as well (and vice-versa). The range between min and max is
      defined by the step option (defaults to 1) and can also be overriden by
      the minRange option. Applies to range slider only. */
    pushRange?: boolean;
    /** The minimum value authorized on the slider.
      When using stepsArray, expressed as index into stepsArray. */
    minLimit?: number;
    /** The maximum value authorized on the slider.
      When using stepsArray, expressed as index into stepsArray. */
    maxLimit?: number;
    /** Custom translate function. Use this if you want to translate values displayed
        on the slider. */
    translate?: TranslateFunction;
    /** Custom function for combining overlapping labels in range slider.
        It takes the min and max values (already translated with translate fuction)
        and should return how these two values should be combined.
        If not provided, the default function will join the two values with
        ' - ' as separator. */
    combineLabels?: CombineLabelsFunction;
    /** Use to display legend under ticks (thus, it needs to be used along with
       showTicks or showTicksValues). The function will be called with each tick
       value and returned content will be displayed under the tick as a legend.
       If the returned value is null, then no legend is displayed under
       the corresponding tick.You can also directly provide the legend values
       in the stepsArray option. */
    getLegend?: GetLegendFunction;
    /** Use to display a custom legend of a stepItem from stepsArray.
      It will be the same as getLegend but for stepsArray. */
    getStepLegend?: GetStepLegendFunction;
    /** If you want to display a slider with non linear/number steps.
       Just pass an array with each slider value and that's it; the floor, ceil and step settings
       of the slider will be computed automatically.
       By default, the value model and valueHigh model values will be the value of the selected item
       in the stepsArray.
       They can also be bound to the index of the selected item by setting the bindIndexForStepsArray
       option to true. */
    stepsArray?: CustomStepDefinition[];
    /** Set to true to bind the index of the selected item to value model and valueHigh model. */
    bindIndexForStepsArray?: boolean;
    /** When set to true and using a range slider, the range can be dragged by the selection bar.
      Applies to range slider only. */
    draggableRange?: boolean;
    /** Same as draggableRange but the slider range can't be changed.
      Applies to range slider only. */
    draggableRangeOnly?: boolean;
    /** Set to true to always show the selection bar before the slider handle. */
    showSelectionBar?: boolean;
    /** Set to true to always show the selection bar after the slider handle. */
    showSelectionBarEnd?: boolean;
    /**  Set a number to draw the selection bar between this value and the slider handle.
      When using stepsArray, expressed as index into stepsArray. */
    showSelectionBarFromValue?: number;
    /**  Only for range slider. Set to true to visualize in different colour the areas
      on the left/right (top/bottom for vertical range slider) of selection bar between the handles. */
    showOuterSelectionBars?: boolean;
    /** Set to true to hide pointer labels */
    hidePointerLabels?: boolean;
    /** Set to true to hide min / max labels  */
    hideLimitLabels?: boolean;
    /** Set to false to disable the auto-hiding behavior of the limit labels. */
    autoHideLimitLabels?: boolean;
    /** Set to true to make the slider read-only. */
    readOnly?: boolean;
    /** Set to true to disable the slider. */
    disabled?: boolean;
    /** Set to true to display a tick for each step of the slider. */
    showTicks?: boolean;
    /** Set to true to display a tick and the step value for each step of the slider.. */
    showTicksValues?: boolean;
    tickStep?: number;
    tickValueStep?: number;
    /** Use to display ticks at specific positions.
      The array contains the index of the ticks that should be displayed.
      For example, [0, 1, 5] will display a tick for the first, second and sixth values. */
    ticksArray?: number[];
    /** Used to display a tooltip when a tick is hovered.
      Set to a function that returns the tooltip content for a given value. */
    ticksTooltip?: (value: number) => string;
    /** Same as ticksTooltip but for ticks values. */
    ticksValuesTooltip?: (value: number) => string;
    /** Set to true to display the slider vertically.
      The slider will take the full height of its parent.
      Changing this value at runtime is not currently supported. */
    vertical?: boolean;
    /** Function that returns the current color of the selection bar.
      If your color won't change, don't use this option but set it through CSS.
      If the returned color depends on a model value (either value or valueHigh),
      you should use the argument passed to the function.
      Indeed, when the function is called, there is no certainty that the model
      has already been updated.*/
    getSelectionBarColor?: (minValue: number, maxValue?: number) => string;
    /** Function that returns the color of a tick. showTicks must be enabled. */
    getTickColor?: (value: number) => string;
    /** Function that returns the current color of a pointer.
      If your color won't change, don't use this option but set it through CSS.
      If the returned color depends on a model value (either value or valueHigh),
      you should use the argument passed to the function.
      Indeed, when the function is called, there is no certainty that the model has already been updated.
      To handle range slider pointers independently, you should evaluate pointerType within the given
      function where "min" stands for value model and "max" for valueHigh model values. */
    getPointerColor?: (value: number, pointerType: PointerType) => string;
    /** Handles are focusable (on click or with tab) and can be modified using the following keyboard controls:
      Left/bottom arrows: -1
      Right/top arrows: +1
      Page-down: -10%
      Page-up: +10%
      Home: minimum value
      End: maximum value
     */
    keyboardSupport?: boolean;
    /** If you display the slider in an element that uses transform: scale(0.5), set the scale value to 2
      so that the slider is rendered properly and the events are handled correctly. */
    scale?: number;
    /** If you display the slider in an element that uses transform: rotate(90deg), set the rotate value to 90
     so that the slider is rendered properly and the events are handled correctly. Value is in degrees. */
    rotate?: number;
    /** Set to true to force the value(s) to be rounded to the step, even when modified from the outside.
      When set to false, if the model values are modified from outside the slider, they are not rounded
      and can be between two steps. */
    enforceStep?: boolean;
    /** Set to true to force the value(s) to be normalised to allowed range (floor to ceil), even when modified from the outside.
      When set to false, if the model values are modified from outside the slider, and they are outside allowed range,
      the slider may be rendered incorrectly. However, setting this to false may be useful if you want to perform custom normalisation. */
    enforceRange?: boolean;
    /** Set to true to force the value(s) to be rounded to the nearest step value, even when modified from the outside.
      When set to false, if the model values are modified from outside the slider, and they are outside allowed range,
      the slider may be rendered incorrectly. However, setting this to false may be useful if you want to perform custom normalisation. */
    enforceStepsArray?: boolean;
    /** Set to true to prevent to user from switching the min and max handles. Applies to range slider only. */
    noSwitching?: boolean;
    /** Set to true to only bind events on slider handles. */
    onlyBindHandles?: boolean;
    /** Set to true to show graphs right to left.
      If vertical is true it will be from top to bottom and left / right arrow functions reversed. */
    rightToLeft?: boolean;
    /** Set to true to reverse keyboard navigation:
      Right/top arrows: -1
      Left/bottom arrows: +1
      Page-up: -10%
      Page-down: +10%
      End: minimum value
      Home: maximum value
     */
    reversedControls?: boolean;
    /** Set to true to keep the slider labels inside the slider bounds. */
    boundPointerLabels?: boolean;
    /** Set to true to use a logarithmic scale to display the slider.  */
    logScale?: boolean;
    /** Function that returns the position on the slider for a given value.
      The position must be a percentage between 0 and 1.
      The function should be monotonically increasing or decreasing; otherwise the slider may behave incorrectly. */
    customValueToPosition?: ValueToPositionFunction;
    /** Function that returns the value for a given position on the slider.
      The position is a percentage between 0 and 1.
      The function should be monotonically increasing or decreasing; otherwise the slider may behave incorrectly. */
    customPositionToValue?: PositionToValueFunction;
    /** Precision limit for calculated values.
      Values used in calculations will be rounded to this number of significant digits
      to prevent accumulating small floating-point errors. */
    precisionLimit?: number;
    /** Use to display the selection bar as a gradient.
      The given object must contain from and to properties which are colors. */
    selectionBarGradient?: {
        from: string;
        to: string;
    };
    /** Use to add a label directly to the slider for accessibility. Adds the aria-label attribute. */
    ariaLabel?: string;
    /** Use instead of ariaLabel to reference the id of an element which will be used to label the slider.
      Adds the aria-labelledby attribute. */
    ariaLabelledBy?: string;
    /** Use to add a label directly to the slider range for accessibility. Adds the aria-label attribute. */
    ariaLabelHigh?: string;
    /** Use instead of ariaLabelHigh to reference the id of an element which will be used to label the slider range.
      Adds the aria-labelledby attribute. */
    ariaLabelledByHigh?: string;
    /** Use to increase rendering performance. If the value is not provided, the slider calculates the with/height of the handle */
    handleDimension?: number;
    /** Use to increase rendering performance. If the value is not provided, the slider calculates the with/height of the bar */
    barDimension?: number;
    /** Enable/disable CSS animations */
    animate?: boolean;
    /** Enable/disable CSS animations while moving the slider */
    animateOnMove?: boolean;
}
declare const AllowUnsafeHtmlInSlider: InjectionToken<boolean>;

declare class ChangeContext {
    value: number;
    highValue?: number;
    pointerType: PointerType;
}

declare class Tick {
    selected: boolean;
    style: any;
    tooltip: string;
    tooltipPlacement: string;
    value: string;
    valueTooltip: string;
    valueTooltipPlacement: string;
    legend: string;
}
declare class SliderComponent implements OnInit, AfterViewInit, OnChanges, OnDestroy, ControlValueAccessor {
    private renderer;
    private elementRef;
    private changeDetectionRef;
    private zone;
    allowUnsafeHtmlInSlider: boolean;
    protected sliderElementNgxSliderClass: boolean;
    value: number;
    valueChange: EventEmitter<number>;
    highValue: number;
    highValueChange: EventEmitter<number>;
    options: Options;
    userChangeStart: EventEmitter<ChangeContext>;
    userChange: EventEmitter<ChangeContext>;
    userChangeEnd: EventEmitter<ChangeContext>;
    private manualRefreshSubscription;
    set manualRefresh(manualRefresh: EventEmitter<void>);
    private triggerFocusSubscription;
    set triggerFocus(triggerFocus: EventEmitter<void>);
    private cancelUserChangeSubscription;
    set cancelUserChange(cancelUserChange: EventEmitter<void>);
    get range(): boolean;
    private initHasRun;
    private inputModelChangeSubject;
    private inputModelChangeSubscription;
    private outputModelChangeSubject;
    private outputModelChangeSubscription;
    private viewLowValue;
    private viewHighValue;
    private viewOptions;
    private handleHalfDimension;
    private maxHandlePosition;
    private currentTrackingPointer;
    private currentFocusPointer;
    private firstKeyDown;
    private touchId;
    private dragging;
    private preStartHandleValue;
    private leftOuterSelectionBarElement;
    private rightOuterSelectionBarElement;
    private fullBarElement;
    private selectionBarElement;
    private minHandleElement;
    private maxHandleElement;
    private floorLabelElement;
    private ceilLabelElement;
    private minHandleLabelElement;
    private maxHandleLabelElement;
    private combinedLabelElement;
    private ticksElement;
    tooltipTemplate: TemplateRef<any>;
    sliderElementVerticalClass: boolean;
    sliderElementAnimateClass: boolean;
    sliderElementWithLegendClass: boolean;
    sliderElementDisabledAttr: string;
    sliderElementAriaLabel: string;
    barStyle: any;
    minPointerStyle: any;
    maxPointerStyle: any;
    fullBarTransparentClass: boolean;
    selectionBarDraggableClass: boolean;
    ticksUnderValuesClass: boolean;
    get showTicks(): boolean;
    private intermediateTicks;
    ticks: Tick[];
    private eventListenerHelper;
    private onMoveEventListener;
    private onEndEventListener;
    private onCancelEventListener;
    private moving;
    private resizeObserver;
    private onTouchedCallback;
    private onChangeCallback;
    private document;
    constructor();
    ngOnInit(): void;
    ngAfterViewInit(): void;
    ngOnChanges(changes: SimpleChanges): void;
    ngOnDestroy(): void;
    writeValue(obj: any): void;
    registerOnChange(onChangeCallback: any): void;
    registerOnTouched(onTouchedCallback: any): void;
    setDisabledState(isDisabled: boolean): void;
    setAriaLabel(ariaLabel: string): void;
    onResize(event: any): void;
    private subscribeInputModelChangeSubject;
    private subscribeOutputModelChangeSubject;
    private subscribeResizeObserver;
    private unsubscribeResizeObserver;
    private unsubscribeOnMove;
    private unsubscribeOnEnd;
    private unsubscribeInputModelChangeSubject;
    private unsubscribeOutputModelChangeSubject;
    private unsubscribeManualRefresh;
    private unsubscribeTriggerFocus;
    private unsubscribeCancelUserChange;
    private getPointerElement;
    private getCurrentTrackingValue;
    private modelValueToViewValue;
    private viewValueToModelValue;
    private getStepValue;
    private applyViewChange;
    private applyInputModelChange;
    private publishOutputModelChange;
    private normaliseModelValues;
    private renormaliseModelValues;
    private onChangeOptions;
    private applyOptions;
    private applyStepsArrayOptions;
    private applyFloorCeilOptions;
    private resetSlider;
    private focusPointer;
    private refocusPointerIfNeeded;
    private manageElementsStyle;
    private manageEventsBindings;
    private updateDisabledState;
    private updateAriaLabel;
    private updateVerticalState;
    private updateScale;
    private updateRotate;
    private getAllSliderElements;
    private initHandles;
    private addAccessibility;
    private updateAriaAttributes;
    private calculateViewDimensions;
    private calculateViewDimensionsAndDetectChanges;
    /**
     * If the slider reference is already destroyed
     * @returns boolean - true if ref is destroyed
     */
    private isRefDestroyed;
    private updateTicksScale;
    private getTicksArray;
    private isTickSelected;
    private updateFloorLabel;
    private updateCeilLabel;
    private updateHandles;
    private getHandleLabelPos;
    private updateLowHandle;
    private updateHighHandle;
    private updateFloorAndCeilLabelsVisibility;
    private isLabelBelowFloorLabel;
    private isLabelAboveCeilLabel;
    private updateSelectionBar;
    private getSelectionBarColor;
    private getPointerColor;
    private getTickColor;
    private updateCombinedLabel;
    private getDisplayValue;
    private roundStep;
    private valueToPosition;
    private positionToValue;
    private getEventXY;
    private getEventPosition;
    private getNearestHandle;
    private bindEvents;
    private getOptionsInfluencingEventBindings;
    private unbindEvents;
    private onBarStart;
    private onStart;
    private onMove;
    private forceEnd;
    private onEnd;
    private onPointerFocus;
    private onKeyUp;
    private onPointerBlur;
    private getKeyActions;
    private onKeyboardEvent;
    private onDragStart;
    /** Get min value depending on whether the newPos is outOfBounds above or below the bar and rightToLeft */
    private getMinValue;
    /** Get max value depending on whether the newPos is outOfBounds above or below the bar and rightToLeft */
    private getMaxValue;
    private onDragMove;
    private positionTrackingBar;
    private positionTrackingHandle;
    private applyMinMaxLimit;
    private applyMinMaxRange;
    private applyPushRange;
    private getChangeContext;
    static ɵfac: i0.ɵɵFactoryDeclaration<SliderComponent, never>;
    static ɵcmp: i0.ɵɵComponentDeclaration<SliderComponent, "ngx-slider", never, { "value": { "alias": "value"; "required": false; }; "highValue": { "alias": "highValue"; "required": false; }; "options": { "alias": "options"; "required": false; }; "manualRefresh": { "alias": "manualRefresh"; "required": false; }; "triggerFocus": { "alias": "triggerFocus"; "required": false; }; "cancelUserChange": { "alias": "cancelUserChange"; "required": false; }; }, { "valueChange": "valueChange"; "highValueChange": "highValueChange"; "userChangeStart": "userChangeStart"; "userChange": "userChange"; "userChangeEnd": "userChangeEnd"; }, ["tooltipTemplate"], never, false, never>;
}

declare class SliderElementDirective {
    protected elemRef: ElementRef<any>;
    protected renderer: Renderer2;
    protected changeDetectionRef: ChangeDetectorRef;
    private _position;
    get position(): number;
    private _dimension;
    get dimension(): number;
    private _alwaysHide;
    get alwaysHide(): boolean;
    private _vertical;
    get vertical(): boolean;
    private _scale;
    get scale(): number;
    private _rotate;
    get rotate(): number;
    opacity: number;
    visibility: string;
    left: string;
    bottom: string;
    height: string;
    width: string;
    transform: string;
    private eventListenerHelper;
    private eventListeners;
    constructor();
    setAlwaysHide(hide: boolean): void;
    hide(): void;
    show(): void;
    isVisible(): boolean;
    setVertical(vertical: boolean): void;
    setScale(scale: number): void;
    setRotate(rotate: number): void;
    getRotate(): number;
    setPosition(pos: number): void;
    calculateDimension(): void;
    setDimension(dim: number): void;
    getBoundingClientRect(): ClientRect;
    on(eventName: string, callback: (event: any) => void, debounceInterval?: number): void;
    onPassive(eventName: string, callback: (event: any) => void, debounceInterval?: number): void;
    off(eventName?: string): void;
    private isRefDestroyed;
    static ɵfac: i0.ɵɵFactoryDeclaration<SliderElementDirective, never>;
    static ɵdir: i0.ɵɵDirectiveDeclaration<SliderElementDirective, "[ngxSliderElement]", never, {}, {}, never, never, false, never>;
}

declare class SliderHandleDirective extends SliderElementDirective {
    active: boolean;
    role: string;
    tabindex: string;
    ariaOrientation: string;
    ariaLabel: string;
    ariaLabelledBy: string;
    ariaValueNow: string;
    ariaValueText: string;
    ariaValueMin: string;
    ariaValueMax: string;
    private document;
    focus(): void;
    focusIfNeeded(): void;
    static ɵfac: i0.ɵɵFactoryDeclaration<SliderHandleDirective, never>;
    static ɵdir: i0.ɵɵDirectiveDeclaration<SliderHandleDirective, "[ngxSliderHandle]", never, {}, {}, never, never, false, never>;
}

declare class SliderLabelDirective extends SliderElementDirective {
    private allowUnsafeHtmlInSlider;
    private _value;
    get value(): string;
    setValue(value: string): void;
    static ɵfac: i0.ɵɵFactoryDeclaration<SliderLabelDirective, never>;
    static ɵdir: i0.ɵɵDirectiveDeclaration<SliderLabelDirective, "[ngxSliderLabel]", never, {}, {}, never, never, false, never>;
}

declare class TooltipWrapperComponent {
    template: TemplateRef<any>;
    tooltip: string;
    placement: string;
    content: string;
    static ɵfac: i0.ɵɵFactoryDeclaration<TooltipWrapperComponent, never>;
    static ɵcmp: i0.ɵɵComponentDeclaration<TooltipWrapperComponent, "ngx-slider-tooltip-wrapper", never, { "template": { "alias": "template"; "required": false; }; "tooltip": { "alias": "tooltip"; "required": false; }; "placement": { "alias": "placement"; "required": false; }; "content": { "alias": "content"; "required": false; }; }, {}, never, never, false, never>;
}

/**
 * NgxSlider module
 *
 * The module exports the slider component
 */
declare class NgxSliderModule {
    static ɵfac: i0.ɵɵFactoryDeclaration<NgxSliderModule, never>;
    static ɵmod: i0.ɵɵNgModuleDeclaration<NgxSliderModule, [typeof SliderComponent, typeof SliderElementDirective, typeof SliderHandleDirective, typeof SliderLabelDirective, typeof TooltipWrapperComponent], [typeof i6.CommonModule], [typeof SliderComponent]>;
    static ɵinj: i0.ɵɵInjectorDeclaration<NgxSliderModule>;
}

export { AllowUnsafeHtmlInSlider, ChangeContext, LabelType, NgxSliderModule, Options, PointerType, SliderComponent };
export type { CombineLabelsFunction, CustomStepDefinition, GetLegendFunction, GetStepLegendFunction, PositionToValueFunction, TranslateFunction, ValueToPositionFunction };