Forms v1.0.0

Currency Input

Formatted currency input with symbol addon, automatic thousand separators, and decimal formatting. Supports left/right symbol positioning, customizable separators for international formats, min/max constraints, and a hidden field that stores the raw numeric value for form submission.

Preview & Code

Options

Name Type Default Description
name * String required Form field name attribute (used on the hidden input)
value Float nil Initial numeric value
currency String "USD" Currency code for reference
symbol String "$" Currency symbol to display
symbol_position Symbol :left Symbol placement: :left or :right
decimal_places Integer 2 Number of decimal places
thousand_separator String "," Character used as thousand separator
decimal_separator String "." Character used as decimal separator
min Float nil Minimum allowed value
max Float nil Maximum allowed value
label String nil Label text displayed above the input
size Symbol :md Input size: :sm, :md, or :lg
error String nil Error message -- turns the border red and displays below the input
disabled Boolean false Whether the input is disabled
required Boolean false Whether the input is required
placeholder String "0.00" Placeholder text shown when empty

Changelog v1.0.0

- v1.0.0: Initial release with currency formatting, symbol addon, and hidden value field
- Left/right symbol positioning with proper border radius
- Configurable thousand and decimal separators for international formats
- Min/max constraints enforced on blur
- Keystroke filtering to allow only valid numeric input
- Full dark mode support

Get Full Access

Unlock the source code for this component and all others. One-time payment for lifetime access.

Get Access Now