Tally UI

PriceForm

PriceForm displays a line's current price and accepts a new amount and optional reason, showing parsing errors or refusals inline.

Import

import { PriceForm } from '@tallyui/components';

Usage

<PriceForm
  lineName={line.name}
  currency={sale.order.currency}
  currentMinor={line.unitPriceMinor}
  onApply={(amountMinor, reason) => applyPrice(amountMinor, reason)}
  onClose={() => setPriceOpen(false)}
/>

Renders the line's current price, a new price input, an optional reason, and Apply and Cancel buttons. Prices are parsed into minor units, including zero; parsing errors and application refusals appear inline.

With quickDiscounts, the first three valid percentages appear as keys (−5%, −10%, −15%), as on WCPOS v2's price keypad. A key lights and previews the current price less that percentage, rounded half up to the minor unit; pressing it again or typing a price clears it, and Apply passes the previewed price to onApply.

Props

PropTypeDefaultDescription
lineNamestringrequiredLine name used in the heading and accessible group label
currencystringrequiredCurrency used to format the current price and parse the new amount
currentMinornumberrequiredCurrent price in minor units, displayed above the input
onApply(amountMinor: number, reason?: string) => string | nullrequiredReceives the parsed price and trimmed reason, or undefined for an empty reason; return a refusal or null once applied
onClose() => voidrequiredCalled on Cancel or after onApply returns null
quickDiscountsreadonly number[]---Percentages off the current price drawn as keys; values outside 0 < n ≤ 100 are dropped and only the first three are drawn. No keys when absent or empty

On this page