CurrencyInput

Currency input widget for entering monetary values.

Examples

Basic Usage

This example runs a form with a single page containing the widget

Example Code

from abstra.forms import CurrencyInput, run

# Create a page with the widget
example_page = [
    CurrencyInput(label="Currency Input", key="my-currency_input"),
]

# Run the form
result = run([example_page])

# Print the result
print(result)

Parameters

Name	Description	Type	Default
label (required)	Text label displayed above the input.	str	None
key	Identifier for the widget, defaults to label if not provided.	str	None
required	Whether the input must be filled before proceeding.	bool	True
hint	Help text displayed below the input.	str	None
placeholder	Placeholder text displayed when the input is empty.	str	''
full_width	Whether the input should take up the full width of its container.	bool	False
disabled	Whether the input is non-interactive.	bool	False
min	Minimum allowed value.	float	None
max	Maximum allowed value.	float	None
currency	Currency code to use for formatting (e.g., "USD", "EUR").	str	'USD'
errors	Pre-defined validation error messages to display.	Union[List[str], str]	None

State Value

Optional[float]: The currency value entered by the user.

info

This is the type of the value that this widget holds. It will show up when accessing widget's state item.

This also defines which value type can be used on initial_state