Metadata-Version: 2.1
Name: ipywidgets-extended
Version: 1.2.0
Summary: Extensions to the Jupyter Widgets in the `ipywidgets` package.
Home-page: https://github.com/CasperWA/ipywidgets-extended
Author: Casper Welzel Andersen
Author-email: casper+github@welzel.nu
License: BSD
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Jupyter
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Widget Sets
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: dev
License-File: LICENSE

# Jupyter Widgets - Extended

This package contains widget extensions to the standard [`ipywidgets`](https://github.com/jupyter-widgets/ipywidgets) package.
The intent is to not produce completely new widgets, but rather _extend_ the widgets already in [`ipywidgets`](https://github.com/jupyter-widgets/ipywidgets) with more possibilities and options.

## Current extended widgets

### Dropdown

The dropdown widget has been extended to include the possibility of:

- disabling options; and
- grouping the options.

#### Disabling

This can be done *via* the `disabled_options` traitlet, which must be a list of option labels.
If an option label is included in the `disabled_options` list traitlet, it will be "grayed out", i.e., disabled (but still visible) in the dropdown widget.

#### Grouping

Using the `grouping` parameter *instead of* the `options` parameter, options can be grouped as desired.
The format is similar to the value for `options`, but each grouping of options should be paired with a header, i.e., you'll the value to be an iterable of (header, `options`)-pairs.

One can introduce un-grouped options by passing an empty header, i.e., an empty string (`""`).

## About

**Author**: Casper Welzel Andersen ([email](casper+github@welzel.nu), [website](https://casper.welzel.nu)).  
**License**: [BSD-3-Clause](LICENSE) and copyright (c) 2020 Casper Welzel Andersen & parts by Jupyter Development Team.
