# Precision Input Examples and Reference

### Default Precision Input

An example of a default precision input without any extra properties.

    library(dash)
    library(dashDaq)
    library(dashHtmlComponents)

    app <- Dash$new()

    app$layout(htmlDiv(list(
      daqPrecisionInput(id = 'my-precision',
                        label = 'Default',
                        precision = 4,
                        value = 1234),
      htmlDiv(id = 'precision-output')
    )))

    app$callback(
      output(id = "precision-output", property = "children"),
      params = list(input(id = "my-precision", property = "value")),

      update_output <- function(value) {
        return(sprintf("The current value is %s", value))
      }
    )

    app$run_server()

Default
1
.
2
3
4
E
3
The current value is 1234.

### Label

Set the label and label position with `label` and `labelPosition`.

    library(dashDaq)

    daqPrecisionInput(
        label = "Label",
        labelPosition = "top",
        precision = 2,
        value = 12
    )

Label
1
.
2
E
1

### Precision

The `precision` property is mandatory for this component. The `precision` property indicates the accuracy of the specified number.

    library(dashDaq)

    daqPrecisionInput(
        precision = 2,
        value = 125
    )

1
.
3
E
2

### Max and Min

Set the maximum and minimum value of the numeric input with `max` and `min`.

    library(dashDaq)

    daqPrecisionInput(
        precision = 2,
        value = 15,
        max = 20,
        min = 10
    )

1
.
5
E
1

### Size

Set the length (in pixels) of the numeric input `size`.

    library(dashDaq)

    daqPrecisionInput(
        size = 120,
        precision = 4,
        value = 245,
    )

2
.
4
5
E
2

### Disabled

Disable the precision input by setting `disabled=TRUE`.

    library(dashDaq)

    daqPrecisionInput(
        disabled = TRUE,
        precision = 4,
        value = 9999,
    )

9
.
9
9
9
E
3

## PrecisionInput Properties

> Our recommended IDE for writing Dash apps is Dash Enterprise's Data Science Workspaces, which has typeahead support for Dash Component Properties. Find out if your company is using Dash Enterprise.

`id` (character; optional): The ID used to identify this compnent in Dash callbacks.

`value` (numeric; optional): The value of numeric input.

`size` (numeric; optional): The size (length) of the numeric input in pixels.

`min` (numeric; default `0`): The minimum value of the numeric input.

`max` (numeric; default `Number.MAX_SAFE_INTEGER`): The maximum value of the numeric input.

`precision` (numeric; default `2`): Number of significant figures.

`disabled` (logical; optional): If TRUE, numeric input cannot be changed.

`theme` (named list; default `light`): Theme configuration to be set by a ThemeProvider.

`label` (named list; optional): Description to be displayed alongside the scientific notation. To control styling, pass an object with label and style properties.

`label` is a character | named list with keys:

- `label` (character; optional)

- `style` (named list; optional)

`labelPosition` (a value equal to: 'top' or 'bottom'; default `'top'`): Where the numeric input label is positioned.

`className` (character; optional): Class to apply to the root component element.

`style` (named list; optional): Style to apply to the root component element.

`persistence` (logical | character | numeric; optional): Used to allow user interactions in this component to be persisted when the component - or the page - is refreshed. If `persisted` is truthy and hasn't changed from its previous value, a `value` that the user has changed while using the app will keep that change, as long as the new `value` also matches what was given originally. Used in conjunction with `persistence_type`.

`persisted_props` (unnamed list of values equal to: 'value'; default `['value']`): Properties whose user interactions will persist after refreshing the component or the page. Since only `value` is allowed this prop can normally be ignored.

`persistence_type` (a value equal to: 'local', 'session' or 'memory'; default `'local'`): Where persisted user changes will be stored: memory: only kept in memory, reset on page refresh. local: window.localStorage, data is kept after the browser quit. session: window.sessionStorage, data is cleared once the browser quit.