本文へ移動
uiify

Number field

増減ボタン付きの数値入力。

ブラウザー
Chrome 123+Firefox 121+Safari 17.5+
ティア
1
圧縮後のサイズ
2.45 kB
強制レイアウトの上限
0 ms
axe の上限
0
SSR 対応
はい
公開された契約
テストハーネス

プレイグラウンド

Number Field

標準

API

NumberField.Root

Prop型既定値説明
valuenumber—現在の数値。フィールドを制御します。
defaultValuenumber—非制御フィールドの初期数値。
onValueChange(value: number | undefined) => void—解析した数値、または入力が空の場合はundefinedで呼び出します。
minnumber—受け入れる最小値。
maxnumber—受け入れる最大値。
stepnumber1増加・減少ボタンで加減する量。
formatOptionsIntl.NumberFormatOptions—値の表示に使うIntl.NumberFormatのオプション。
clampValueOnBlurbooleantrue入力からフォーカスが外れたとき、範囲外の値をminとmaxの範囲内に補正します。
disabledbooleanfalse入力と両方の増減ボタンを無効にします。
readOnlybooleanfalseフォーカス可能なまま、入力の値を読み取り専用にします。
requiredbooleanfalseフォーム検証で入力を必須にします。
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

NumberField.Group

Prop型既定値説明
childrenReactNode—グループで囲む入力と増減ボタン。
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

NumberField.Input

Prop型既定値説明
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

NumberField.Increment

Prop型既定値説明
childrenReactNode—増加ボタンの内容。
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

NumberField.Decrement

Prop型既定値説明
childrenReactNode—減少ボタンの内容。
renderReactElement | ((props, state) => ReactElement)—動作とアクセシビリティの接続を維持したまま、描画する要素を置き換えます。

キーボード

キー操作
Tabコントロールへ、またはコントロールからフォーカスを移動
Enter / Spaceフォーカス時に実行(ボタン型のコントロール)

アクセシビリティ

可能な限りセマンティックHTMLを使います。プレイグラウンドで描画されたマークアップを確認できます。ARIAはネイティブ要素だけでは足りない場合にのみ追加します。

スタイリングのフック

data-uiify-number-fielddata-disabled