@k8ordo/ui

RangeSlider

2つのつまみで範囲を選ぶスライダーです。価格の下限と上限のように、1組の値を選ぶときに使います。

インポート

ts
import { RangeSlider } from '@k8ordo/ui';

使い方

tsx
<RangeSlider aria-label="Price" defaultValue={[20, 80]} />

制御モード

18–26 °C

tsx
const [value, setValue] = useState<readonly [number, number]>([18, 26]);

<RangeSlider
  aria-label="Temperature"
  max={40}
  min={0}
  onChange={setValue}
  value={value}
/>

無効

tsx
<RangeSlider aria-label="Price" defaultValue={[20, 80]} disabled />

フォームでの送信

つまみはそれぞれ本物の<input type="range">です。nameに渡した2つの名前で、2つの値として送られます。非制御のときは、フォームのリセットとisDirtyがほかの<input>と同じように働きます。

tsx
// schema.ts
export const filterSchema = z.object({
  priceMin: z.coerce.number().int().min(0).max(100),
  priceMax: z.coerce.number().int().min(0).max(100),
});

// filter-form.tsx
const priceMin = form.field('priceMin');
const priceMax = form.field('priceMax');

<FormControl
  label="Price"
  renderInput={(props) => (
    <RangeSlider
      {...props}
      defaultValue={[20, 80]}
      max={100}
      min={0}
      name={[priceMin.input.name, priceMax.input.name]}
    />
  )}
/>

Props

defaultValue?
Type: readonly [number, number]
Default: -
disabled?
Type: boolean
Default: false
invalid?
Type: boolean
Default: false
max?
Type: number
Default: 100
min?
Type: number
Default: 0
name?
Type: readonly [string, string]
Default: -
onChange?
Type: (value: [number, number]) => void
Default: -
ref?
Type: Ref<HTMLDivElement>
Default: -
required?
Type: boolean
Default: false
step?
Type: number
Default: 1
value?
Type: readonly [number, number]
Default: -
PropTypeDefault
defaultValue?readonly [number, number]-
disabled?booleanfalse
invalid?booleanfalse
max?number100
min?number0
name?readonly [string, string]-
onChange?(value: [number, number]) => void-
ref?Ref<HTMLDivElement>-
required?booleanfalse
step?number1
value?readonly [number, number]-

継承する属性(内部で固定するものを除く): HTMLAttributes<HTMLDivElement>

ラベルやプレースホルダーなど、このコンポーネントが描く文言は、propsで指定しないと文言辞書から読まれます。差し替え方は次を見てください: コンポーネントの文言

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。