Range

Adds Range widget.

import mercury as mr
 
# add range widget
your_range = mr.Range(value=[1, 6], min=0, max=10, label="Your favourite range", step=1)
    
# access widget value in the code
print(f"Your range starts at {your_range.value[0]} ends at {your_range.value[1]}")

Parameters

value (list of two integers)- the initial value of the range widget.
min (int) - minimum allowed value in the widget, default is set to 0.
max (int) - maximum allowed value in the widget, default is set to 10.
label (string)- the label that will appear near the widget.
step (integer or float)- value of change, default is set to 1.
url_key (string) - set this value if you would like to set Range value with URL paramters.
disabled (boolean) - disable widget in the sidebar, default is set to False.
hidden (boolean) - hide widget in the sidebar, default is set to False.

Share widget value in URL

Let's create the Range widget with url_key="my-range":

import mercury as mr
 
app = mr.App(title="Range", description="Range widget demo", show_code=True)
 
# add range widget
your_range = mr.Range(value=[1, 6], min=0, max=10, label="Your favourite range", 
                      step=1, url_key="my-range")
    
# access widget value in the code
print(f"Your range starts at {your_range.value[0]} ends at {your_range.value[1]}")

You can share the widgets values with other users. Please click the Share button in the sidebar bottom. It will open a dialog with URL.

The URL will look like:

https://your-server-address.com/app/notebook-name?my-range=3,5

Please note that ?my-range=3,5 is added at the end of URL address.

Example App

Below is a screenshot with example app. Example app is available at docs.runmercury.com/app/range (opens in a new tab).

Notebook's code:

Numeric Select