Interactive online version: .
Simple Widget Introduction¶
What are widgets?¶
Widgets are eventful python objects that have a representation in the browser, often as a control like a slider, textbox, etc.
What can they be used for?¶
To use the widget framework, you need to import
import ipywidgets as widgets
Widgets have their own display
repr which allows them to be displayed using IPython’s display framework. Constructing and returning an
IntSlider automatically displays the widget (as seen below). Widgets are displayed inside the output area below the code cell. Clearing cell output will also remove the widget.
You can also explicitly display the widget using
from IPython.display import display w = widgets.IntSlider() display(w)
Multiple display() calls¶
If you display the same widget twice, the displayed instances in the front-end will remain in sync with each other. Try dragging the slider below and watch the slider above.
Why does displaying the same widget twice work?¶
Widgets are represented in the back-end by a single object. Each time a widget is displayed, a new representation of that same object is created in the front-end. These representations are called views.
You can close a widget by calling its
All of the IPython widgets share a similar naming scheme. To read the value of a widget, you can query its
w = widgets.IntSlider() display(w)
Similarly, to set a widget’s value, you can set its
w.value = 100
In addition to
value, most widgets share
disabled. To see the entire list of synchronized, stateful properties of any specific widget, you can query the
['_dom_classes', '_model_module', '_model_module_version', '_model_name', '_view_count', '_view_module', '_view_module_version', '_view_name', 'behavior', 'continuous_update', 'description', 'description_allow_html', 'disabled', 'layout', 'max', 'min', 'orientation', 'readout', 'readout_format', 'step', 'style', 'tabbable', 'tooltip', 'value']
Shorthand for setting the initial values of widget properties¶
While creating a widget, you can set some or all of the initial values of that widget by defining them as keyword arguments in the widget’s constructor (as seen below).
widgets.Text(value='Hello World!', disabled=True)
Linking two similar widgets¶
If you need to display the same value two different ways, you’ll have to use two different widgets. Instead of attempting to manually synchronize the values of the two widgets, you can use the
jslink function to link two properties together (the difference between these is discussed in Widget Events). Below, the values of two widgets are linked together.
a = widgets.FloatText() b = widgets.FloatSlider() display(a,b) mylink = widgets.jslink((a, 'value'), (b, 'value'))