A numeric model creates one thumb; a readonly [number, number] model creates a range. There is no range input. minValue/maxValue define the scale and step defines increments. minStepsBetweenThumbs keeps a minimum separation. Use a number input instead when exact typed entry is important.
Change the controls and try the live preview. Expand the application value or event to inspect its real data; the generated template stays with the configurator.
These values match the current preview. Complete handlers, Core imports and templates are in Source.
configured-state.ts
import { signal } from '@angular/core';
export const volume = signal(25);
These inputs require a model or function, not a checkbox. Edit the same-named field in the Source component and bind it in the template; data already used by this preview appears in the state above.
Bind FormField once to the component; the field owns value and validation. The required validator treats 0 as a value. This example also uses min(10), so a value below ten is invalid. Leave the control to mark it touched, then reset the field to clear both value and interaction state.
Use [(value)] or [value] with (valueChange), not both. The model synchronizes application state; other Outputs communicate their documented events. touch reports leaving/visiting the control, not a new value.
Name the slider with label or ariaLabel and use unit to describe the value. A range exposes two separately focusable thumbs with minimum/maximum names. Arrow keys change one step, PageUp/PageDown ten steps, and Home/End uses the allowed bounds of the focused thumb.
Key
Action
Tab
Focuses the thumb; a range has two tab stops.
Arrow keys
Changes the focused thumb by one step.
PageUp / PageDown
Changes it by ten steps.
Home / End
Moves to the allowed minimum or maximum for that thumb.
Inputs, models and Outputs come from the pinned Core contract. Click named types to open their definitions. This component has no public template slots.
Inputs
Configure the component with [property]="value". Your application supplies these values; the component does not replace the state you pass in.
Name
Type
Default
Template binding
Description
ariaDescribedBy
string
''
[ariaDescribedBy]
IDs of elements describing the control, separated by spaces.
ariaLabel
string
''
[ariaLabel]
Accessible name when no visible label is available.
dirty
boolean
false
[dirty]
Form state indicating that the user has changed the value.
disabled
boolean
false
[disabled]
Prevents user interaction.
errors
readonly ValidationError.WithOptionalFieldTree[]
[]
[errors]
Validation errors supplied by the form or the application.
Stable identifier of the native control; automatically generated when omitted.
invalid
boolean
false
[invalid]
Displays the invalid state; it does not add a validation rule.
label
string
''
[label]
Visible label and accessible name of the control.
maxValue
number
100
[maxValue]
Upper endpoint of the slider scale.
minStepsBetweenThumbs
number
0
[minStepsBetweenThumbs]
Minimum gap between range thumbs, measured in multiples of step.
minValue
number
0
[minValue]
Lower endpoint of the slider scale.
name
string
''
[name]
Name associated with the native form control.
orientation
"horizontal" | "vertical"
'horizontal'
[orientation]
horizontal or vertical track orientation.
pending
boolean
false
[pending]
Form state indicating that asynchronous validation is pending.
readonly
boolean
false
[readonly]
Keeps the control focusable and readable without accepting edits.
required
boolean
false
[required]
Marks the field as required; use a form validator to enforce it.
showTicks
boolean
false
[showTicks]
Displays scale ticks.
showValue
boolean
true
[showValue]
Displays the current formatted value.
step
number
1
[step]
Accepted increment between values.
touched
boolean
false
[touched]
Form state indicating that the control has been visited.
unit
string
''
[unit]
Display suffix; the model remains numeric.
Models
A model supports [(property)]="signal" or the [property] and (propertyChange) pair. Choose one form, not both.
Name
Type
Default
Template binding
Description
value
V
0 as VDerived default
[(value)]
Numeric value or readonly [number, number] interval. The model type determines the interaction.
Outputs
Listen to an event with (event)="handler($event)". The table explains the data your handler receives and how to use it.
Name
Payload
Template binding
Description
touch
void
(touch)="onTouch($event)"
Notifies the form that the control has been touched; not a value change.
Templates
ng-content projects content into the component. TemplateRef inputs receive a template; ng-template directives identify templates with a typed context. A directive shared by an entrypoint is not necessarily a slot of this component.
This component does not expose content projection or public customization templates.
Public Types
Open a type to inspect its definition and interface fields.
NeuSliderValue.d.ts
import type { NeuSliderValue } from '@neural-ui/core/slider';
// Public declaration (reference only)
export type NeuSliderValue = SliderValue;
Load Core styles once. Use the public tokens below for local customization or a preset for application-wide changes. Keep labels, focus, selected options and disabled states readable in both light and dark themes.
Specific tokens
This component uses shared theme tokens rather than dedicated component hooks.
Shared tokens used
Override these on a local wrapper to affect this example. An override on :root affects other components that use the same token.
Token
Purpose here
Other impact
Default / fallback
--neu-primary
Brand color for active controls and emphasis
Shared by other Core consumers; scope the override.
#007aff
--neu-primary-dark
Dark brand shade; outline and ghost Button text in the light theme
Shared by other Core consumers; scope the override.
#005fcc
--neu-surface
Main field, header or control surface
Shared by other Core consumers; scope the override.
#ffffff
--neu-surface-3
Hover and raised control surfaces
Shared by other Core consumers; scope the override.
#e2e8f0
--neu-text-disabled
Text of disabled controls
Shared by other Core consumers; scope the override.
#64748b
--neu-text-muted
Secondary labels and supporting content
Shared by other Core consumers; scope the override.
#475569
--neu-font-sans
Text typography
Shared by other Core consumers; scope the override.