/** * @license * Copyright Google LLC All Rights Reserved. * * Use of this source code is governed by an MIT-style license that can be * found in the LICENSE file at https://angular.dev/license */ import {InjectionToken, ChangeDetectorRef, WritableSignal} from '@angular/core'; import {MatRipple, RippleGlobalOptions} from '@angular/material/core'; /** * Thumb types: range slider has two thumbs (START, END) whereas single point * slider only has one thumb (END). */ export enum _MatThumb { START = 1, END = 2, } /** Tick mark enum, for discrete sliders. */ export enum _MatTickMark { ACTIVE = 0, INACTIVE = 1, } /** * Injection token that can be used for a `MatSlider` to provide itself as a * parent to the `MatSliderThumb` and `MatSliderRangeThumb`. * Used primarily to avoid circular imports. * @docs-private */ export const MAT_SLIDER = new InjectionToken<{}>('_MatSlider'); /** * Injection token that can be used to query for a `MatSliderThumb`. * Used primarily to avoid circular imports. * @docs-private */ export const MAT_SLIDER_THUMB = new InjectionToken<{}>('_MatSliderThumb'); /** * Injection token that can be used to query for a `MatSliderRangeThumb`. * Used primarily to avoid circular imports. * @docs-private */ export const MAT_SLIDER_RANGE_THUMB = new InjectionToken<{}>('_MatSliderRangeThumb'); /** * Injection token that can be used to query for a `MatSliderVisualThumb`. * Used primarily to avoid circular imports. * @docs-private */ export const MAT_SLIDER_VISUAL_THUMB = new InjectionToken<{}>('_MatSliderVisualThumb'); /** Represents a drag event emitted by the MatSlider component. */ export interface MatSliderDragEvent { /** The MatSliderThumb that was interacted with. */ source: _MatSliderThumb; /** The MatSlider that was interacted with. */ parent: _MatSlider; /** The current value of the slider. */ value: number; } /** * A simple change event emitted by the MatSlider component. * @deprecated Use event bindings directly on the MatSliderThumbs for `change` and `input` events. See https://v17.material.angular.io/guide/mdc-migration for information about migrating. * @breaking-change 17.0.0 */ export class MatSliderChange { /** The MatSliderThumb that was interacted with. */ source: _MatSliderThumb; /** The MatSlider that was interacted with. */ parent: _MatSlider; /** The new value of the source slider. */ value: number; } export interface _MatSlider { /** Whether the given pointer event occurred within the bounds of the slider pointer's DOM Rect. */ _isCursorOnSliderThumb(event: PointerEvent, rect: DOMRect): boolean; /** Gets the slider thumb input of the given thumb position. */ _getInput(thumbPosition: _MatThumb): _MatSliderThumb | _MatSliderRangeThumb | undefined; /** Gets the slider thumb HTML input element of the given thumb position. */ _getThumb(thumbPosition: _MatThumb): _MatSliderVisualThumb; /** The minimum value that the slider can have. */ min: number; /** The maximum value that the slider can have. */ max: number; /** The amount that slider values can increment or decrement by. */ step: number; /** Whether the slider is disabled. */ disabled: boolean; /** Whether the slider is a range slider. */ _isRange: boolean; /** Whether the slider is rtl. */ _isRtl: boolean; /** The stored width of the host element's bounding client rect. */ _cachedWidth: number; /** The stored width of the host element's bounding client rect. */ _cachedLeft: number; /** * The padding of the native slider input. This is added in order to make the region where the * thumb ripple extends past the end of the slider track clickable. */ _inputPadding: number; /** The radius of the visual slider's ripple. */ _rippleRadius: number; /** The global configuration for `matRipple` instances. */ readonly _globalRippleOptions: RippleGlobalOptions | null; /** Whether animations have been disabled. */ _noopAnimations: boolean; /** Whether or not the slider should use animations. */ _hasAnimation: boolean; /** Triggers UI updates that are needed after a slider input value has changed. */ _onValueChange: (source: _MatSliderThumb) => void; /** Triggers UI updates that are needed after the slider thumb position has changed. */ _onTranslateXChange: (source: _MatSliderThumb) => void; /** Updates the stored slider dimensions using the current bounding client rect. */ _updateDimensions: () => void; /** Updates the scale on the active portion of the track. */ _updateTrackUI: (source: _MatSliderThumb) => void; /** Used to set the transition duration for thumb and track animations. */ _setTransition: (withAnimation: boolean) => void; _cdr: ChangeDetectorRef; } export interface _MatSliderThumb { /** The minimum value that the slider can have. */ min: number; /** The maximum value that the slider can have. */ max: number; /** The amount that slider values can increment or decrement by. */ step: number; /** The current value of this slider input. */ value: number; /** The current translateX in px of the slider visual thumb. */ translateX: number; /** Indicates whether this thumb is the start or end thumb. */ thumbPosition: _MatThumb; /** Similar to percentage but calcualted using translateX relative to the total track width. */ fillPercentage: number; /** Whether the slider is disabled. */ disabled: boolean; /** The host native HTML input element. */ _hostElement: HTMLInputElement; /** Whether the input is currently focused (either by tab or after clicking). */ _isFocused: boolean; /** The aria-valuetext string representation of the input's value. */ _valuetext: WritableSignal; /** * Indicates whether UI updates should be skipped. * * This flag is used to avoid flickering * when correcting values on pointer up/down. */ _skipUIUpdate: boolean; /** Handles the initialization of properties for the slider input. */ initProps: () => void; /** Handles UI initialization controlled by this slider input. */ initUI: () => void; /** Calculates the visual thumb's translateX based on the slider input's current value. */ _calcTranslateXByValue: () => number; /** Updates the visual thumb based on the slider input's current value. */ _updateThumbUIByValue: () => void; /** * Sets the slider input to disproportionate dimensions to allow for touch * events to be captured on touch devices. */ _updateWidthInactive: () => void; /** * Used to set the slider width to the correct * dimensions while the user is dragging. */ _updateWidthActive: () => void; } export interface _MatSliderRangeThumb extends _MatSliderThumb { /** Whether this slider corresponds to the input on the left hand side. */ _isLeftThumb: boolean; /** * Gets the sibling MatSliderRangeThumb. * Returns undefined if it is too early in Angular's life cycle. */ getSibling: () => _MatSliderRangeThumb | undefined; /** Used to cache whether this slider input corresponds to the visual left thumb. */ _setIsLeftThumb: () => void; /** Updates the input styles to control whether it is pinned to the start or end of the mat-slider. */ _updateStaticStyles: () => void; /** Updates the min and max properties of this slider input according to it's sibling. */ _updateMinMax: () => void; } export interface _MatSliderVisualThumb { /** The MatRipple for this slider thumb. */ _ripple: MatRipple; /** Whether the slider thumb is currently being pressed. */ _isActive: boolean; /** The host native HTML input element. */ _hostElement: HTMLElement; /** Shows the value indicator ui. */ _showValueIndicator: () => void; /** Hides the value indicator ui. */ _hideValueIndicator: () => void; /** Whether the slider visual thumb is currently showing any ripple. */ _isShowingAnyRipple: () => boolean; }