Skip to content
Frauthy Brand
Frauthy index

Go anywhere.

    No exact contract found. Try a component family, product name, prop, or keyboard key.

    ↑↓ move↵ openesc close

    05 · Forms

    beta

    NumberField

    A labelled native numeric input with localized value text and explicit increment/decrement buttons.

    Since
    1.0.0-next.0
    Owner
    Brand Core
    Export
    PRIVATE_BETA_PACKAGE_COORDINATE_REDACTED/NumberField
    Release
    Documentation version
    Deterministic fixture · default state

    Component studio

    light · comfortable · LTR
    Used to map verified identities to membership.
    §01

    Contract

    Semantics first

    Anatomy

    Uses input type=number plus two labelled native buttons; name/value submission and min/max/step remain native.

    Consumer classes, styles, and data attributes may extend the surface, but required roles, IDs, relationships, and handlers remain owned by the component.

    Keyboard

    • Tab reaches decrement, input, and increment controls.
    • The input retains native Arrow Up/Down and editing behavior.
    • Enter/Space activate step buttons, which clamp to min/max and return focus to the input.
    §02

    Public surface

    API & styling

    Props

    id
    Explicit IDs override stable generated IDs.
    class / style
    Consumer additions compose with required styles.
    ref
    Element or callback where focus control is expected.
    children
    Typed content; raw HTML strings are never rendered.

    Slots & events

    children
    Primary content slot.
    onChange
    Typed value plus a small reason object when state changes.
    native events
    Composed without overwriting required handlers.

    State attributes

    • data-fui-number-field
    • data-fui-control
    • data-fui-invalid

    CSS tokens

    • --fui-field-*
    • --fui-number-field-*
    • --fui-control-target
    §03

    Consumption

    Solid, Vite & Astro

    Solid / VitePRIVATE_BETA_PACKAGE_COORDINATE_REDACTED/NumberField
    import NumberField from 'PRIVATE_BETA_PACKAGE_COORDINATE_REDACTED/NumberField';
    
    <NumberField>Frauthy content</NumberField>
    Astroisland
    ---
    import NumberField from 'PRIVATE_BETA_PACKAGE_COORDINATE_REDACTED/NumberField';
    ---
    
    <NumberField client:visible>Frauthy content</NumberField>
    §04

    Verification

    Evidence record

    Scheduled

    Automated

    Batch D form tests cover null/default/controlled values, localized aria-valuetext, clamping, step reasons, reset, constraints, and errors.

    Target
    Brand 1.0.0-next.0 matrix
    Last verified
    Pending integrated G2 run
    Required

    Assistive technology

    Pending VoiceOver/Safari and NVDA/Firefox spinbutton value, step-button label, and error verification.

    Desktop
    VoiceOver/Safari · NVDA/Firefox
    Touch
    Required for touch-centric behavior
    Open

    Known issues

    • Native number parsing and invalid-character entry vary by browser and locale.
    • Step buttons use fixed English labels until the consumer-facing message catalog lands.
    §05

    Editorial guidance

    Do / don’t

    Do

    Set meaningful min, max, step, and a visible label with units.

    Don’t

    Do not use NumberField for identifiers, postal codes, or values where leading zeroes matter.

    Release activity

    NumberField · Brand Core

    1 recorded change · 26 weeks
    1. 1.0.0-next.3

      Baseline public component contract.

    Version & provenance

    New in the v2 architecture

    There is no stable predecessor for this explicit compiled subpath. The v1 compatibility layer remains tested separately; visual and API diffs begin with the next prerelease.

    Current
    1.0.0-next.0
    Previous
    compatibility surface
    Deprecation
    none
    Replacement
    not applicable
    Next in FormsCheckboxGroup