CurrencyInputBaseOptions

Configuration shared by the hook and the component.

Extended by

optional allowNegative?: boolean;

Allow negative amounts (refunds, adjustments).

false

optional country?: string;

Convenience: combined into ${language}-${country} when locale is absent.

currency: string;

ISO-4217 currency code, e.g. 'EUR', 'BGN', 'JPY'. Required.

optional currencyDisplay?: CurrencyDisplay;

How the currency is displayed.

'symbol'

optional formatMode?: FormatMode;

When the field formats. 'live' (default) formats as you type with a stable caret; 'blur' shows a plain number while focused.

'live'

optional language?: string;

Convenience: combined into ${language}-${country} when locale is absent.

optional locale?: string;

BCP-47 locale, e.g. 'bg-BG'. Takes precedence over language/country. When all three are omitted the runtime default locale is used.

optional maximumFractionDigits?: number;

Cap on fraction digits. Defaults to the currency’s own default (JPY → 0, EUR → 2, KWD → 3).

optional minimumFractionDigits?: number;

Floor on fraction digits in the formatted value.

optional numberingSystem?: string;

Override the numbering system, e.g. 'latn' to force ASCII digits.

optional step?: number;

Amount added/subtracted by ArrowUp/ArrowDown. Omit to leave arrow keys untouched. The result is rounded to the currency’s fraction precision.

optional transformRawValue?: (raw) => string;

Transform browser input before locale-aware sanitization.

Parameter	Type
`raw`	`string`

string