API: Primitives

SliderDirective

Single-thumb slider root.

Overview

Single-thumb slider root. value is the model; valueChangeCommitted fires once per user change (each key step, and each distinct value reached while dragging). Programmatic writes to value are silent. During a drag the pointer position always wins: an external write applies immediately but the next pointermove of the active gesture overrides it.

Kind: Directive
Export as: qzSlider
Source: packages/primitives/src/slider/slider.directive.ts:49

Selector

[qzSlider]

Inputs

Input	Type	Default	Description
`min`	`number`	`DEFAULT_SLIDER_CONFIG.min`
`max`	`number`	`DEFAULT_SLIDER_CONFIG.max`
`step`	`number`	`DEFAULT_SLIDER_CONFIG.step`
`disabled`	`unknown`	`false`	Transform `booleanAttribute`; reads as `boolean`.
`orientation`	`SliderOrientation`	`DEFAULT_SLIDER_CONFIG.orientation`
`valueText`	`((value: number) => string) \| null`	`null`

Models

Two-way bindings: each model is an input and emits the matching change output.

Model	Type	Default	Required	Change output	Description
`value`	`number`	`DEFAULT_SLIDER_CONFIG.min`		`valueChange`
`dragging`	`boolean`	`false`		`draggingChange`

Outputs

Output	Payload	Description
`valueChangeCommitted`	`number`	Emits the new value once per user change (keyboard step, or a new value reached by pointer).

Properties

Name	Type	Description
`readonly isDisabled`	`Signal<boolean>`	Effective disabled state: the `disabled` input OR a disabled Angular Forms control.
`readonly bounds`	`Signal<{ min: number; max: number; }>`	Repaired bounds: swapped or non-finite `min`/`max` inputs are normalized here.
`readonly currentValue`	`Signal<number>`
`readonly percent`	`Signal<number>`
`readonly ariaValueText`	`Signal<string \| null>`

Public methods

setValue

setValue(value: number): void

User command: normalize, write the model and emit when the effective value changed.

Parameter	Type	Optional	Description
`value`	`number`

increment

increment(multiplier?: number): void

Parameter	Type	Optional	Description
`multiplier`	`number`	Yes

decrement

decrement(multiplier?: number): void

Parameter	Type	Optional	Description
`multiplier`	`number`	Yes

setFormDisabled

setFormDisabled(disabled: boolean): void

Adapter hook for @quartz-headless/primitives/forms (setDisabledState).

Parameter	Type	Optional	Description
`disabled`	`boolean`

onPointerDown

onPointerDown(event: PointerEvent): void

Parameter	Type	Optional	Description
`event`	`PointerEvent`

onPointerMove

onPointerMove(event: PointerEvent): void

Parameter	Type	Optional	Description
`event`	`PointerEvent`

onPointerEnd

onPointerEnd(event: PointerEvent): void

Parameter	Type	Optional	Description
`event`	`PointerEvent`

SliderOrientation