组件Controls
NumberField
@mox-hub/ui 组件 · Controls · standby
number-field@mox-hub/uiControlsstandbysrc/components/number-field.tsx变体演示number-field
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| id* | string | — | — |
| className* | string | ((state: NumberFieldRootState) => string) | — | — |
| size* | "default" | "sm" | "lg" | "default" | — |
源码
"use client"
import { NumberField as NumberFieldPrimitive } from "@base-ui/react/number-field"
import { MinusIcon, PlusIcon } from "lucide-react"
import * as React from "react"
import { cn } from "../lib/utils"
/* coss ui NumberField(base-ui 配方移植,registry @coss/number-field)*/
export const NumberFieldContext: React.Context<{
fieldId: string
} | null> = React.createContext<{
fieldId: string
} | null>(null)
export function NumberField({
id,
className,
size = "default",
...props
}: NumberFieldPrimitive.Root.Props & {
/**
* 控件档位。2026-11-15 审计 W2 起并入 `--spacing-control-*`:
* 旧 coss 配方的 30/34/38px 收口到 32/36/40px(comfortable,±2px 已登记)。
*/
size?: "sm" | "default" | "lg"
}): React.ReactElement {
const generatedId = React.useId()
const fieldId = id ?? generatedId
return (
<NumberFieldContext.Provider value={{ fieldId }}>
<NumberFieldPrimitive.Root
className={cn("flex w-full flex-col items-start gap-2", className)}
data-size={size}
data-slot="number-field"
id={fieldId}
{...props}
/>
</NumberFieldContext.Provider>
)
}
export function NumberFieldGroup({
className,
...props
}: NumberFieldPrimitive.Group.Props): React.ReactElement {
return (
<NumberFieldPrimitive.Group
className={cn(
"relative flex w-full justify-between rounded-md border border-input bg-background has-[[readonly]]:bg-muted/50 not-dark:bg-clip-padding text-base text-foreground shadow-xs/5 ring-ring/24 transition-shadow duration-fast before:pointer-events-none before:absolute before:inset-0 before:rounded-[calc(var(--radius-md)-1px)] not-data-disabled:not-focus-within:not-aria-invalid:before:shadow-[0_1px_--theme(--color-black/4%)] focus-within:border-ring focus-within:ring-2 has-aria-invalid:border-destructive/36 focus-within:has-aria-invalid:border-destructive/64 focus-within:has-aria-invalid:ring-destructive/16 data-disabled:pointer-events-none data-disabled:opacity-50 sm:text-sm dark:bg-input/32 dark:has-aria-invalid:ring-destructive/24 dark:not-data-disabled:not-focus-within:not-aria-invalid:before:shadow-[0_-1px_--theme(--color-white/6%)] [&_svg:not([class*='size-'])]:size-4.5 sm:[&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0 [[data-disabled],:focus-within,[aria-invalid]]:shadow-none",
className
)}
data-slot="number-field-group"
{...props}
/>
)
}
export function NumberFieldDecrement({
className,
...props
}: NumberFieldPrimitive.Decrement.Props): React.ReactElement {
return (
<NumberFieldPrimitive.Decrement
className={cn(
"relative flex shrink-0 cursor-pointer items-center justify-center rounded-s-md in-data-[size=sm]:px-[calc(--spacing(2.5)-1px)] px-[calc(--spacing(3)-1px)] transition-colors duration-fast pointer-coarse:after:absolute pointer-coarse:after:size-full pointer-coarse:after:min-h-11 pointer-coarse:after:min-w-11 hover:bg-muted",
className
)}
data-slot="number-field-decrement"
{...props}
>
<MinusIcon />
</NumberFieldPrimitive.Decrement>
)
}
export function NumberFieldIncrement({
className,
...props
}: NumberFieldPrimitive.Increment.Props): React.ReactElement {
return (
<NumberFieldPrimitive.Increment
className={cn(
"relative flex shrink-0 cursor-pointer items-center justify-center rounded-e-md in-data-[size=sm]:px-[calc(--spacing(2.5)-1px)] px-[calc(--spacing(3)-1px)] transition-colors duration-fast pointer-coarse:after:absolute pointer-coarse:after:size-full pointer-coarse:after:min-h-11 pointer-coarse:after:min-w-11 hover:bg-muted",
className
)}
data-slot="number-field-increment"
{...props}
>
<PlusIcon />
</NumberFieldPrimitive.Increment>
)
}
export function NumberFieldInput({
className,
...props
}: NumberFieldPrimitive.Input.Props): React.ReactElement {
return (
<NumberFieldPrimitive.Input
className={cn(
"h-control-md in-data-[size=lg]:h-control-lg in-data-[size=sm]:h-control-sm w-full min-w-0 grow bg-transparent in-data-[size=sm]:px-[calc(--spacing(2.5)-1px)] px-[calc(--spacing(3)-1px)] text-center text-foreground tabular-nums outline-none read-only:cursor-default read-only:text-muted-foreground",
className
)}
data-slot="number-field-input"
{...props}
/>
)
}
export { NumberFieldPrimitive }
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
数值输入,支持步进、最小最大与格式;受控用 value 与 onValueChange。