@flourish/formatters
v2.0.0
Published
Format numbers and datetimes
Downloads
298
Maintainers
Keywords
Readme
Flourish formatter
Flourish module for formatting numbers and dates using the format id's of the interpreter module.
Install
To install the module, type:
npm install @flourish/formatters
To add the module's settings block for number formatting, include something like the following in a templates' template.yml file:
- property: x_format
import: "@flourish/formatters/number-formatter"
Since you may well want different formatting for different variables or axes, it is quite likely you may want to include multiple settings blocks:
- property: y_format
import: "@flourish/formatters/number-formatter"
Usage
getFormatter(format_id)
This function return a formatter function with the given format_id
. For example:
import { getFormatter } from @flourish/formatter;
const numFormat = getFormatter("number$point_comma");
console.log(numFormat(12235.56)); // "12.235,56"
const dateFormat = getFormat("datetime$%d/%m/%Y");
console.log(Date.now()); // "20/01/2022"
initNumberFormatter(state_obj)
This function returns a function for generating a number-formatting function with additional properties that can be specified by the user of the template via the settings panel when the settings.yml from the number-formatter folder is included in the template.yml file. For example...
- Number formatting
- property: formatting
import: "@flourish/formatters/number-formatter"
// In state.js
const state = {
...
formatting = {};
...
}
// In draw.js
...
const getNumberFormatter = initNumberFormatter(state.formatting);
function draw() {
...
}
// In update.js
function update() {
...
const numberFormatter = getNumberFormatter(output_id);
const label = numberFormatter(value);
...
}