PriceRangeField

Summary

Dual-handle price range slider with histogram backdrop, min/max numeric inputs, and currency prefix.


Class	`Bjanczak\FilamentFlexFields\Filament\Forms\Components\PriceRangeField`
State type	`array<min: int	float, max: int	float>`
Model cast	`'price_range' => 'array'` or `'json'`
FieldType	`price_range`

Example state: ['min' => 100, 'max' => 1124].

Basic usage

use Bjanczak\FilamentFlexFields\Filament\Forms\Components\PriceRangeField;

PriceRangeField::make('price_range')
    ->label('Price range')
    ->min(0)
    ->max(5000)
    ->step(1)
    ->prefix('$')
    ->histogram([30, 74, 85, 36, 98])
    ->showInputs()
    ->variant('bordered')
    ->default(['min' => 100, 'max' => 1124]);

Validation

Built-in rules via custom validator:

Failure	Translation key
Non-numeric min/max	`price_range.invalid`
Values outside bounds	`price_range.out_of_bounds`
min > max	`price_range.min_greater_than_max`

Configuration API

`min(int|float|Closure $min = 0)` / `max(int|float|Closure $max = 1000)`

Range boundaries for slider and inputs.

PriceRangeField::make('field_name')
    ->min(1)
    ->max(10);

`step(int|float|Closure $step = 1)`

Snap increment.

PriceRangeField::make('field_name')
    ->step(1);

`integer(bool|Closure $condition = true)`

Restrict to whole numbers. Default: true.

PriceRangeField::make('field_name')
    ->integer(true);

`decimalPlaces(int|Closure|null $places)`

Fixed decimal precision when not integer.

PriceRangeField::make('field_name')
    ->decimalPlaces(2);

`prefix(string|Closure|null $prefix)` / `withoutPrefix()`

Currency or unit prefix shown in inputs. Default config: $.

PriceRangeField::make('field_name')
    ->prefix('value')
    ->withoutPrefix();

`variant(string|Closure $variant)`

Value	Description
`bordered`	Bordered track. Default.
`flat`	Flat styling.
`faded`	Subtle faded track.

PriceRangeField::make('field_name')
    ->variant('primary');

`showInputs(bool|Closure $condition = true)`

Min/max numeric inputs below the slider. Default: true.

PriceRangeField::make('field_name')
    ->showInputs(true);

`minInputLabel(string|Closure|null $label)` / `maxInputLabel(string|Closure|null $label)`

Accessible labels for the numeric inputs.

PriceRangeField::make('field_name')
    ->minInputLabel('value')
    ->maxInputLabel('value');

`histogram(array|Closure $heights)`

Bar heights (8–100) for the background chart. Uses a built-in default pattern when omitted.

PriceRangeField::make('field_name')
    ->histogram(['value1', 'value2']);

`size(string|ControlSize|Closure $size)`

See Control size.

PriceRangeField::make('field_name')
    ->size('md');

State normalization

On hydrate and dehydrate, values are clamped to [min, max], stepped, and min is never greater than max.

FlexField schema config

Config key	Maps to
`min`	`min()`
`max`	`max()`
`step`	`step()`
`size`	`size()`
`variant`	`variant()`
`prefix`	`prefix()`
`histogram`	`histogram()`
`integer`	`integer()`
`decimal_places`	`decimalPlaces()`
`show_inputs`	`showInputs()`
`min_input_label`	`minInputLabel()`
`max_input_label`	`maxInputLabel()`

Public helper methods

Method	Returns	Description
`normalizeState(array $state)`	`array<min, max>`	Clamps min/max to bounds, applies step rounding, ensures `min ≤ max`.
`defaultHistogram()`	`list<float>`	Built-in 32-bar histogram heights (8–100) used when `histogram()` is empty.
`hasPrefix()`	`bool`	Whether a currency/unit prefix is configured (not `withoutPrefix()`).

Getting Started

Guides & Resources

Text & Input

Number & Range

Choice & Selection

Date & Time

Media, Color & Location

Rating & Tables

Actions & Enterprise

Layout & Display (Schemas)

Summary

Basic usage

Validation

Configuration API

`min(int|float|Closure $min = 0)` / `max(int|float|Closure $max = 1000)`

`step(int|float|Closure $step = 1)`

`integer(bool|Closure $condition = true)`

`decimalPlaces(int|Closure|null $places)`

`prefix(string|Closure|null $prefix)` / `withoutPrefix()`

`variant(string|Closure $variant)`

`showInputs(bool|Closure $condition = true)`

`minInputLabel(string|Closure|null $label)` / `maxInputLabel(string|Closure|null $label)`

`histogram(array|Closure $heights)`

`size(string|ControlSize|Closure $size)`

State normalization

FlexField schema config

Public helper methods

​Summary

​Basic usage

​Validation

​Configuration API

​min(int|float|Closure $min = 0) / max(int|float|Closure $max = 1000)

​step(int|float|Closure $step = 1)

​integer(bool|Closure $condition = true)

​decimalPlaces(int|Closure|null $places)

​prefix(string|Closure|null $prefix) / withoutPrefix()

​variant(string|Closure $variant)

​showInputs(bool|Closure $condition = true)

​minInputLabel(string|Closure|null $label) / maxInputLabel(string|Closure|null $label)

​histogram(array|Closure $heights)

​size(string|ControlSize|Closure $size)

​State normalization

​FlexField schema config

​Public helper methods

Summary

Basic usage

Validation

Configuration API

`min(int|float|Closure $min = 0)` / `max(int|float|Closure $max = 1000)`

`step(int|float|Closure $step = 1)`

`integer(bool|Closure $condition = true)`

`decimalPlaces(int|Closure|null $places)`

`prefix(string|Closure|null $prefix)` / `withoutPrefix()`

`variant(string|Closure $variant)`

`showInputs(bool|Closure $condition = true)`

`minInputLabel(string|Closure|null $label)` / `maxInputLabel(string|Closure|null $label)`

`histogram(array|Closure $heights)`

`size(string|ControlSize|Closure $size)`

State normalization

FlexField schema config

Public helper methods