currencyConverter - javascript currency converter
Compatibility
IE9 and up, Edge, iOS Safari 6+, Chrome 8+, Firefox 6+
Usage
The currencyConverter Instance
You may store the instance by assigning the result of an invocation to a variable.
Here are a few ways to do it.
const cc = currencyConverter("#myID", {}); // currencyConverter
const myElement = document.querySelector(".myElement");
const cc = currencyConverter(myElement, {}); // currencyConverter
const instances = currencyConverter(".currencyElm", {});
instances[0] // currencyConverter
Props
| Prop name | Description | Default value | Example values |
|---|---|---|---|
| baseAmount | Default input amount. | 100 |
20 |
| currencyApi | The api which will be used to fetch currency data if "currencyData" prop is not set |
"https://api.exchangeratesapi.io/latest" | "https://data.fixer.io/api/latest" |
| currencyData | Currency values for dropdown. If not provided, it will be fetch through exchangeApi. | n/a | { AUD: 1.6376, BGN: 1.9558, BRL: 6.0777} |
| fromCurrency | Initial from currency value for for dropdown. | "EUR" |
"INR" |
| inputFromAmountClass | Class name(s) that will be added along with "input-from-amount" to the from amount <input> element. |
n/a | "class1 class2" |
| inputFromCurrencyClass | Class name(s) that will be added along with "select-from-curreny" to the from currency <select> element. |
n/a | "class1 class2" |
| inputToAmountClass | Class name(s) that will be added along with "input-to-amount" to the to amount <input> element. |
n/a | "class1 class2" |
| inputToCurrencyClass | Class name(s) that will be added along with "select-to-curreny" to the to currency <select> element. |
n/a | "class1 class2" |
| locale | Localization data | n/a | { From: 'Von', To: 'Zu'} |
| onChange | Callback method when data is changed. | n/a | (data) => console.log(data) |
| precision | Decimal precision for conversation. | 4 |
2 |
| toCurrency | Initial to currency value for for dropdown. | "USD" |
"JPY" |
| wrapperClass | Class name(s) that will be added along with "currency-converter" to the main <div> element. |
n/a | "class1 class2" |
| withText | Whether to show currency text. "1 EUR = 1.1608 USD" |
true |
false |
Methods
setAmount(amount)
Sets the input from amount
setCurrency(currency)
Sets the select from currency
updateCurrencyData(data)
Updates the currency data
Events
onInit
onInit gets triggered when the component is initialized
onChange
onChange gets triggered when currency or amount is changed
onDestroy
onDestroy gets triggered when the component is destroyed
License
MIT
6 Jan 4, 2023
0 Apr 30, 2022
6 Aug 14, 2022
2 Jan 27, 2022
4 Mar 12, 2022
6 Aug 24, 2022
6 Aug 11, 2022
17 Sep 10, 2022
61 Jan 7, 2023
1 Jan 6, 2022
1.6k Dec 31, 2022
27 Dec 25, 2022
11 Dec 28, 2022
5 Oct 1, 2022
25 Dec 20, 2022
1 Aug 22, 2022
321 Dec 29, 2022
5 Sep 6, 2022
18 Sep 20, 2022