Value

The Value component accepts a query and displays a formatted value inline in text.

By default, Value will display the value from the first row of the first column of the referenced data.

<Value data={query_name} /> <!-- First row from the first column -->

Specifying Rows and Columns

Optionally supply a column and/or a row argument to display other values from data.

<!-- Show the **7th row** from column_name -->

<Value 
    data={query_name}
    column=column_name 
    row=6
/>

Example

Markdown:

The most recent month of data began <Value data={monthly_orders} />,
when there were <Value data={monthly_orders} column=orders/> orders.

Results: summary-sentence

Adding a Placeholder

Override errors with the optional placeholder argument. This is useful for drafting reports before writing your queries.

<Value placeholder="Report Date"/>

value-placeholder

Formatting Values

Evidence supports a variety of formats - see value formatting and the fmt prop below for more info.

Options

data
Required

Query name, wrapped in curly braces

Options:
query name
column

Column to pull values from

Options:
column name
Default:
First column
row

Row number to display. 0 is the first row.

Options:
number
Default:
0
placeholder

Text to display in place of an error

Options:
string
fmt

Format to use for the value (see available formats)

Options:
Excel-style format | built-in format | custom format
emptySet

Sets behaviour for empty datasets. Can throw an error, a warning, or allow empty. When set to 'error', empty datasets will block builds in build:strict. Note this only applies to initial page load - empty datasets caused by input component changes (dropdowns, etc.) are allowed.

Default:
error
emptyMessage

Text to display when an empty dataset is received - only applies when emptySet is 'warn' or 'pass', or when the empty dataset is a result of an input component change (dropdowns, etc.).

Options:
string
Default:
No records