Money input

A localized currency field on Intl.NumberFormat.

import { BuiMoneyInput } from 'ng-blatui';

<bui-money-input [(value)]="amount" currency="USD" />

Localized currency

<!-- symbol="DH" overrides the ISO code (MAD) ICU would otherwise show -->
<bui-money-input [(value)]="price" currency="MAD" locale="fr-MA" symbol="DH" />

API reference

Inputs

Prop	Type	Default	Description
`locale`	`string`	`''`	BCP 47 locale for formatting/parsing. Defaults to the runtime locale.
`currency`	`string`	`'USD'`	ISO 4217 currency code, e.g. `USD`, `EUR`, `MAD`.
`currencyDisplay`	`CurrencyDisplay`	`'narrowSymbol'`	How the currency is shown. `narrowSymbol` renders the local symbol when ICU has one.
`symbol`	`string`	`''`	Custom currency symbol that overrides the one ICU would render, kept in the locale's correct position and spacing. Use it when the ISO data has no local glyph — e.g. `symbol="DH"` shows `DH` instead of the `MAD` code for Moroccan dirham.
`minimumFractionDigits`	`number \| null`	`null`	Minimum fraction digits shown when formatted. Defaults to the currency's own default.
`maximumFractionDigits`	`number \| null`	`null`	Maximum fraction digits shown when formatted. Defaults to the currency's own default.
`placeholder`	`string`	`''`	Placeholder shown when the field is empty.
`name`	`string`	`''`	Native `name` attribute for the input.
`id`	`string`	`''`	Native `id` attribute; falls back to a generated id.
`aria-label`	`string`	`''`	Accessible name, applied to the inner input.

Two-way models

Bind with [(name)], or one-way as an input.

Prop	Type	Default	Description
`value`	`number \| null`	`null`	The numeric amount. Two-way bindable with `[(value)]`. `null` when the field is empty.
`disabled`	`boolean`	`false`	Whether the field is disabled. Two-way bindable with `[(disabled)]`.

Types

CurrencyDisplay — How the currency is shown: local symbol, narrow symbol, ISO code, or full name.

"code" | "name" | "narrowSymbol" | "symbol"

Every ng-blatui component also accepts a class input to merge extra Tailwind classes onto the host.