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. You can still see documentation for version 0 here.

PyPI

To install the last v0 release of dash-bootstrap-components from PyPI use

pip install "dash-bootstrap-components<1"

Anaconda

If you installed dash-bootstrap-components with conda you can use

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

You can install earlier versions of dash-bootstrap-components from our GitHub repository by specifying the relevant tag

library(devtools)
install_github('facultyai/dash-bootstrap-components@r0.13.0')

You can install earlier versions of DashBootstrapComponents by adding the version number to the install command.

pkg> add DashBootstrapComponents@0.13.0

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

Col

Collapse

DropdownMenu

Fade

FormGroup

FormFloating New

Input

InputGroup

Jumbotron

ListGroup

Modal

Nav

Navbar

Offcanvas New

Pagination New

Progress

Row

Select

Spinner

Switch New

Table

Tabs

TextArea

Toast

Tooltip