Home components value

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.
Options:
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