Migration guide for dash-bootstrap-components v1

dash-bootstrap-components v1 contains loads of new features, but also some breaking changes. This is for two reasons:

This guide introduces the new features, and also covers the changes you must make to run your apps with dash-bootstrap-components 1.0.0 rather than 0.13.x (the final v0 releases). If you find any issues not covered here, or bugs in v1 please raise an issue on our GitHub repository.

If you're not ready to upgrade yet, you can continue to use earlier versions of dash-bootstrap-components, just be sure to pin the version numbers.

pip install "dash-bootstrap-components<1"

Or if you installed dash-bootstrap-components with conda you can use

conda install -c conda-forge "dash-bootstrap-components<1"

Dependencies

Breaking dash-bootstrap-components v1 requires Dash 2.0.0 or greater. The primary implication of this is that we have dropped support for Python 2.7 and 3.5. All apps using dash-bootstrap-components v1 should be run with Python 3.6+.

See the Dash 2.0 migration guide for more details on changes within Dash itself.

New Themes

Check out the four new themes: QUARTZ, MORPH, VAPOR and ZEPHYR in the Theme Explorer

Icons

Include Bootstrap and Font Awesome icons to your app as easily as adding a Bootstrap Theme using bundled links to CDNs for Bootstrap Icons and Font Awesome. See more information in the Icons section of the docs.

Components

There are seven new components in dash-bootstrap-components: Accordion, Breadcrumb, FormFloating, ModalTitle, Offcanvas, Pagination, and Switch. Additionally many components have changes to their props.

Notably previously there was a mix of size and bs_size props for controlling the size of some components. All components that allow size to be changed now consistently use size. To set the HTML size property of the underlying <input /> in the Input component, or the underlying <select /> in the Select component, use html_size instead.

Accordion New

Badge

Breadcrumb New

Buttons

ButtonGroup

Card

Carousel

Checkbox

Checklist

Col

Collapse

DropdownMenu

Fade

Form

FormGroup

FormFloating New

Input

InputGroup

Jumbotron

ListGroup

Modal

Nav

Navbar

Offcanvas New

Pagination New

Progress

RadioButton

RadioItems

Row

Select

Spinner

Switch New

Table

Tabs

TextArea

Toast

Tooltip