@theredhead — Frontend Library - v1.0.0
    Preparing search index...

    Adapter for monetary values.

    Strips whitespace, removes grouping separators (commas), and validates that the input is a valid monetary amount with the correct number of decimal places for its currency.

    The prefix icon is chosen automatically based on the currency code.

    ISO 4217 currency code. When omitted, defaults to 'EUR' (overridable via DEFAULT_CURRENCY / provideDefaultCurrency).

    readonly adapter = new MoneyTextAdapter();       // EUR
    readonly adapter = new MoneyTextAdapter('USD'); // explicit

    Implements

    Index

    Constructors

    • Parameters

      • currency: string = "EUR"
      • Optionallocale: string

      Returns MoneyTextAdapter

    Properties

    currency: string

    ISO 4217 currency code this adapter is configured for.

    decimals: number

    Maximum allowed decimal places (0 for JPY/KRW etc., 2 otherwise).

    prefixIcon: string

    Optional SVG icon content to display before the input.

    Should be a Lucide SVG inner-content string (e.g. UIIcons.Lucide.Text.AtSign).

    Methods

    • Optional display formatter.

      When present, the native input element shows the string returned by this method instead of the raw toValue result. Use this to add locale-specific formatting (e.g. thousands separators) while keeping value() as the clean programmatic output.

      Parameters

      • value: string

        The adapted value produced by toValue.

      Returns string

      Formatted string to display in the input element.

    • Transform the raw text into the adapted value.

      Called on every input event. The result is stored in the value model and written back to the native input element, so the user sees the adapted text. The original keystrokes are preserved in the text model.

      Parameters

      • text: string

        Raw text from the input element.

      Returns string

      Adapted value string (displayed in the field and emitted via value).

    • Validate the raw text and return a result indicating whether the current input is valid.

      When present, UIInput exposes a valid signal and applies the invalid host class when validation fails.

      Parameters

      • text: string

        Raw text from the input element.

      Returns TextAdapterValidationResult

      Validation result with valid flag and error messages.