Skip to content

oeway/ipywidgets

 
 

Repository files navigation

ipywidgets: Interactive HTML Widgets

Version Downloads Build Status Documentation Status Join the chat at https://gitter.im/ipython/ipywidgets

ipywidgets are interactive HTML widgets for Jupyter notebooks and the IPython kernel.

Notebooks come alive when interactive widgets are used. Users gain control of their data and can visualize changes in the data.

Learning becomes an immersive, plus fun, experience. Researchers can easily see how changing inputs to a model impact the results. We hope you will add ipywidgets to your notebooks, and we're here to help you get started.

Features

A demonstration notebook provides an overview of the core interactive widgets, including:

  • sliders
  • progress bars
  • text boxes
  • toggle buttons and checkboxes
  • display areas
  • and more

Besides the widgets already provided with the library, the framework can be extended with custom widget libraries. Examples of custom widget libraries built upon ipywidgets are

  • bqplot a 2d data visualization library enabling custom user interactions.
  • pythreejs a Jupyter - Three.js wrapper, bringing Three.js to the notebook.

The resulting widgets can then be embeded into web pages other than the Jupyter notebook.

For detailed information, please refer to the ipywidgets documentation.

Install

Install the current version of ipywidgets using pip or conda:

pip install ipywidgets

or

conda install ipywidgets

Then run

jupyter nbextension enable --py widgetsnbextension

See the Installation section of the documentation for additional details.

Compatibility

ipywidgets version Jupyter/notebook version
master master
4.1.x 4.1
4.0.x 4.0

Change log

Usage

See the examples section of the documentation. The widgets are being used in a variety of ways; some uses can be seen in these notebooks:

Contributing to ipywidgets

Project Jupyter resources

About

IPython widgets for the Jupyter Notebook

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 61.6%
  • Python 32.7%
  • CSS 4.1%
  • HTML 1.4%
  • Shell 0.2%