Changelog
This page documents notable changes in dash-bootstrap-components releases.
1.6.0 - 2024/04/14
Version 1.6.0 of dash-bootstrap-components. This version makes some improvements to Accordion
, Modal
and Progress
as well as updating CDN links. Please continue to report problems on our issue tracker.
Added
- The
title
property ofAccordionItem
can now be an arbitrary Dash component (PR 988) - You can now set
enforceFocus=False
on aModal
to allow components in the background to receive focus while theModal
is open (PR 1001) - The documentation now has a dark mode (PR 984)
Fixed
- The
min
andmax
properties of aProgress
bar are propagated to its children (PR 986) - Fixed console errors originating from
Tooltip
component (PR 1008) - Fix error caused by
Tooltip
closing as component unmounts (PR 1008)
Changed
- Drop support for Python 3.7 as it is EOL (PR 995)
- The
themes
module now links to Bootstrap 5.3.3 (PR 1013)
1.5.0 - 2023/09/07
Version 1.5.0 of dash-bootstrap-components. This version makes some improvements to Carousel
and Textarea
as well as updating CDN links. Please continue to report problems on our issue tracker.
Changed
- Textarea will no longer increment
n_submit
if the user types "shift + enter" to create a new-line (PR 968) - CDN links have been updated to use Bootstrap version 5.3.1 (PR 977)
Added
- You can now pass a
href
attribute to a Carousel item to render that item as a link. Thanks @mapix for the contribution! (PR 971, PR 973, PR 975)
1.4.2 - 2023/07/15
Version 1.4.2 of dash-bootstrap-components. This version contains updates and bug fixes but no new features. Please continue to report problems on our issue tracker.
Fixed
- Fixed navigation bug when using auto-dismissing
Alert
(PR 962)
Changed
- Updated CDN links for Bootstrap and Bootswatch stylesheets (PR 963)
1.4.1 - 2023/03/17
Version 1.4.1 of dash-bootstrap-components. This version contains bug fixes but no new features. Please continue to report problems on our issue tracker.
Fixed
- Fixed issue with
active_label_style
indbc.Tab
not overwritinglabel_style
(PR 946) - Updated CDN links for icons in R and Julia packages (PR 950)
1.4.0 - 2023/02/27
Version 1.4.0 of dash-bootstrap-components. This version contains some new features and bug fixes. Please continue to report problems on our issue tracker.
Added
- It is now possible to pass props as labels to
Checklist
,RadioItems
,RadioButton
,Checkbox
, andSwitch
components. (PR 940)
Fixed
- Ensure ids in
dbc.Tab
anddbc.AccordionItem
are stringified before components are rendered (PR 937) - Allow
Offcanvas.title
to be an arbitrary dash component (PR 938)
1.3.1 - 2023/01/29
Version 1.3.1 of dash-bootstrap-components. This version contains bug fixes but no new features. Please continue to report problems on our issue tracker.
Fixed
- Fixed an issue where
pylint
would fail to recognisedbc.Table.from_dataframe
(PR 926) - Simpler implementation of deprecation warnings made possible by Python 3.6 deprecation (PR 928)
1.3.0 - 2022/12/28
Version 1.3.0 of dash-bootstrap-components. This version contains a number of new features, updates, and bug fixes. Please continue to report problems on our issue tracker.
Added
- Add shorthand syntax for specifying options in
Checklist
,RadioItems
,Select
to mimic dash-core-components ((PR 894) - Add
numbered
prop toListGroup
for numbered list group support ((PR 895) - Add support for horizontal collapses with
horizontal
prop inCollapse
component ((PR 896) - Add new
Stack
component for vertical layouts ((PR 897) - Add new
Placeholder
component which can be used as a loading component also ((PR 899) - Accept Dash components as arguments to
DropdownMenu.label
,NavbarSimple.brand
andToast.header
((PR 917) - Expose
rel
prop inButton
when used as a link ((PR 921)
Fixed
- Fixed a recursion error that could arise when pickling dash-bootstrap-components (PR 918)
- Fixed navigation bug when using auto-dismissing
Toast
((PR 920)
Changed
1.2.1 - 2022/7/31
Version 1.2.1 of dash-bootstrap-components is a patch release containing bug fixes but no new features. Please continue to report problems on our issue tracker.
Fixed
- Suppress console errors originating from
DropdownMenu
(PR 878) - Allow
DropdownMenu
toggle to be rendered as a link (PR 884)
1.2.0 - 2022/6/29
Version 1.2.0 of dash-bootstrap-components contains some new features and bug fixes. Please continue to report problems on our issue tracker.
Added
Tooltip
can now be shown and hidden from callbacks via the newis_open
prop (PR 861)- Added
trigger
prop toTooltip
which behaves liketrigger
prop ofPopover
, allowing users to control what causes the tooltip to show (PR 861) - Added
fade
prop toTooltip
, which behaves likefade
prop ofAlert
, allowing users to control whether the tooltip shows and hides with a fade animation or not ((PR 861) - Add
persistence
prop toAlert
,Carousel
,Popover
,Toast
((PR 872)
Fixed
- Fixed bug in
Textarea
. NowsetProps
is called with the correct value whendebounce=True
on blur and submit event (PR 858) zindex
/zIndex
argument inModal
is now applied correctly (PR 869)Popover
displays on start-up when default value ofis_open
isTrue
((PR 872)
1.1.0 - 2022/4/3
Version 1.1.0 of dash-bootstrap-components contains some new features and bug fixes. Please continue to report problems on our issue tracker.
Added
- Add
readonly
prop toInput
component (PR 833) - Add
always_open
prop toAccordion
. When set toTrue
, opening one section of the accordion does not close any currently open sections (PR 840) - dash-bootstrap-components now explicitly supports Python 3.10 (PR 841)
Fixed
- Allow arbitrary colors to be passed to
color
prop ofProgress
(PR 835) contentClassName
inModal
has been fixed, previously it was not passing the class names on to the relevant elements (PR 839)Select
can now be cleared by returningNone
from a callback (PR 842)
Changed
- Updated CDN links for FontAwesome and Bootstrap Icons in the
icons
submodule. FontAwesome now uses version 6.1.1, Bootstrap Icons uses version 1.8.1 (PR 837)
1.0.3 - 2022/2/5
This is a patch release that fixes a few bugs. Please continue to report any bugs on our issue tracker!
Fixed
- Set
cursor: pointer
on tabs that aren't disabled (PR 801) - Ensure no caret is rendered when
caret=False
inDropdownMenu
(PR 804)
1.0.2 - 2021/12/12
This release updates CDN links to use Bootstrap 5.1.3 and fixes a few bugs. Please continue to report bugs on our issue tracker!
Changed
- Links in the
themes
module now use Bootstrap 5.1.3 (PR 789)
Added
- Added
autohide
prop toTooltip
andPopover
when using thehover
trigger. When set toTrue
, thePopover
/Tooltip
will hide if the mouse is moved over the content (PR 788)
Fixed
Popover
with triggerhover
will not dismiss if mouse is moved over the content (PR 788)- Resolved bug where
Tooltip
could get stuck open when moused over quickly (PR 788)
1.0.1 - 2021/11/28
This release adds no new features but fixes a number of bugs. Please continue to report bugs on our issue tracker!
Fixed
- Open
AccordionItem
s will close when clicked on (PR 744) - Fixed regressions in
DropdownMenu
dismissal. The menu will dismiss if the user clicks outside the menu or if the escape key is pressed. (PR 751) - Fixed bug in
Select
that preventedvalid
andinvalid
props from having an effect (PR 755) - Set
id
property on tabs so that they can be targeted with tooltips. (PR 756) - A number of fixes to
Popover
: ensure the correct behaviour of thelegacy
trigger, and fix bug that preventedoffset
andhide_arrow
props from having an effect. (PR 757) - Make
Button
compatible withdash_core_components.ConfirmDialogProvider
(PR 773) - Fixed bug in
Button
that preventedtarget
prop from having an effect (PR 781)
1.0.0 - 2021/10/19
v1 of dash-bootstrap-components! This release contains loads of new features, but also breaking changes. Please read the changelog carefully, and refer to the migration guide for full details of the changes.
Added
- Seven new components! Accordion, Breadcrumb, FormFloating, ModalTitle, Offcanvas, Pagination, and Switch (PR 646) (PR 689)
- New CDN links for icons from Bootstrap Icons and Font Awesome (PR 661)
- CDN Links for four new Bootswatch themes:
QUARTZ
,MORPH
,VAPOR
andZEPHYR
. - All components now accept
class_name
as an alternative toclassName
. If both are specified thenclass_name
will take precedence.class_name
should be preferred from now on. (PR 642)
Fixed
- The
loading_state
is no longer passed to underlying DOM nodes in any components (PR 666) Popover
doesn't error ifis_open
defaults to true. (PR 646)
Changed
- Components are all now built for Bootstrap 5. CDN links have all been updated. There are multiple breaking changes in the component props. Please see the migration-guide for full details on the changes (PR 646).
0.13.1 - 2021/9/22
Fixed
- Fix cursor jump issue in
Input
component. (PR 707)
0.13.0 - 2021/7/31
Added
- Adds a new
Carousel
component to display images in an animated slideshow. Thanks @AnnMarieW for the contribution! (PR 587) - Exposes
title
prop onButton
andBadge
(PR 617) - Added
links_left
prop toNavbarSimple
to allow links to be left-aligned (PR 618)
Fixed
- Fixed bug in
Spinner
component that meantspinner_style
prop was not correctly applied to the spinner. (PR 578)
Changed
- Updated behaviour of
Input
withtype="number"
to match behaviour in dash-core-components. If an invalid input is entered (i.e. one outside the range ofmin
/max
or with an invalidstep
) the component passes the valueNone
to callbacks for the first invalid input, then doesn't fire again until a valid input is entered. PR 626)
0.12.2 - 2021/5/4
Fixed
- Fix issue with nested
Progress
bars(PR 573)
0.12.1 - 2021/5/4
Added
- Adds
required
property toInput
andSelect
(PR 552) - Added
debounce
andshow_initially
props toSpinner
.debounce
can be used to add a time delay to prevent the spinner from dismissing immediately when its children have finished loading. This can help reduce flickering.show_initially
can be used to ensure that the spinner is initially showing when the app starts up to prevent flickering when initial callbacks fire. (PR 561) - Added
name
andvalue
props toButton
, can be used to send additional data with form submissions. (PR 565)
Fixed
- Fix
toggle
property ofDropdownMenuItem
which can be used to prevent the parentDropdownMenu
from dismissing when that item is clicked on (PR 554)
0.12.0 - 2021/3/21
Added
- Adds a new
trigger
property toPopover
, allowing it to be used without writing callbacks if desired (PR 531) - Exposes
download
prop onButton
(PR 528)
Fixed
- Restore default colours in
Alert
andBadge
components (PR 542)
Changed
- Adds
visibility:hidden
toFade
when content is faded so that tooltips do not appear on faded content (PR 535, PR 537)
0.11.3 - 2021/2/13
This version marks the first release of dash-bootstrap-components for Julia. There are no changes in functionality.
0.11.2 - 2021/2/5
Added
color
prop for multiple components now accepts CSS colors, hex strings etc. (PR 506)Table.from_dataframe
now supports multiple column header levels (PR 509)
0.11.1 - 2020/12/20
Fixed
- Fixes bug that prevented
active
property ofNavLink
from being correctly updated by callbacks (PR 499)
0.11.0 - 2020/12/13
Added
- The
NavLink
component can now automatically set theactive
prop based on the current pathname. Setactive="exact"
to toggle setactive=True
if thehref
exactly matches the current pathname, oractive="partial"
to setactive=True
if the current pathname starts withhref
(PR 482) active_tab_style
andactiveTabClassName
props toTab
for styling active tabs (PR 491)- Exposed
name
prop on input components so that they can be used more effectively in form submissions, andaction
andmethod
props ofForm
so thatForm
can be used to post form submissions to a route on the backend (PR 474) - Exposes
type
prop onButton
(PR 470)
Fixed
- Cursor becomes pointer when hovering on tabs (PR 480)
- Current position on page is preserved when using
Spinner
as a loading component (PR 465)
Changed
- Updated BootstrapCDN links to use Bootstrap v4.5.2 (PR 481)
0.10.7 - 2020/10/4
Fixed
- Follow link as external link when
external_link=True
inDropdownMenuItem
(PR 458)
0.10.6 - 2020/9/10
Added
- The JavaScript bundle for dash-bootstrap-components can now be fetched from a CDN by setting
serve_locally=False
indash.Dash
(PR 451)
Fixed
- Wheels are now available on PyPI which should resolve some reported installation issues (PR 445)
0.10.5 - 2020/8/20
Fixed
- Reverted behaviour of
style
prop fromProgress
component. Bar can be styled with newbar_style
prop (PR 441)
0.10.4 - 2020/8/19
Added
Select
now has aplaceholder
prop (PR 431)Checkbox
andRadioButton
now have adisabled
prop (PR 432)
0.10.3 - 2020/6/26
Fixed
- Sets the
active_tab
prop server-side when default is not provided (required for dynamic tab content with callbacks) (PR 405) - Fixed
disabled
prop of various link based components (PR 410) - Persists null values in
Input
components withtype="number"
(PR 411)
0.10.2 - 2020/6/7
Added
- Each option in
Select
now acceptstitle
as a field (PR 389)
Fixed
- No more warnings related to deprecated React lifecycle methods, or controlled components changing to uncontrolled components (PR 396)
- Automatic dismissal of
Alert
andToast
does not happen early if manually toggled. (PR 396) - Clicking on a
DropdownMenuItem
consistently dismisses the parentDropdownMenu
(PR 396)
0.10.1 - 2020/5/30
Added
- Each option in
RadioItems
andChecklist
now acceptsinput_id
andlabel_id
as fields to allow custom ids to be attached to inputs and labels (PR 379)
Fixed
- Prevent
Form
component from submitting (and hence refreshing the page) by default. If the submit behaviour is desired setprevent_default_on_submit=False
. (PR 385)
Changed
- The
themes
module now links to Bootstrap and Bootswatch 4.5.0 stylesheets (PR 380)
0.10.0 - 2020/5/9
Added
- Support for Dash for R, check the documentation here
- Add support for persistence to
Checkbox
andRadioButton
components (PR 365) - Allow arbitrary CSS colors to be passed to
color
prop ofSpinner
(PR 366)
Fixed
- Expose
flip
prop inPopover
component (PR 363)
Changed
- Removed
style
andclass_name
arguments fromSpinner
, replaced withspinner_style
andspinnerClassName
. Also addedfullscreen_style
andfullscreenClassName
for controlling the style of fullscreen spinners. (PR 344)
0.9.2 - 2020/4/5
Fixed
0.9.1 - 2020/3/12
Fixed
- Restore ability to install module with Python 2 (PR 329)
0.9.0 - 2020/3/11
Added
- Allow
Spinner
to be used likedash_core_components.Loading
by passingchildren
(PR 314)
Fixed
- Prevent
false
being passed to thetarget
prop ofLink
components (PR 315)
0.8.3 - 2020/2/8
Fixed
- Update
Link
components for compatibility with Dash >= 1.9.0 (PR 311)
0.8.2 - 2020/1/28
Fixed
- Expose
target
prop ofLink
components so that linked pages can be made to open in new tabs (PR 305)
0.8.1 - 2020/1/8
Fixed
- Ensure
Input
withtype="number"
triggers callbacks when given the value0
(PR 299)
0.8.0 - 2019/12/24
Added
- Add
horizontal
prop toListGroup
to allow use of horizontal list groups (PR 292) - Add support for Dash's persistence feature to
Checklist
,Input
,RadioItems
,Select
,Textarea
andTabs
(PR 293). - Add
toggle
prop toDropdownMenuItem
which controls whether the parentDropdownMenu
is dismissed on click. Default behaviour is to dismiss theDropdownMenu
(PR 288)
Changed
- Update BootstrapCDN links in
dash_bootstrap_components.themes
to use Bootstrap 4.4.1 (PR 289)
Fixed
- Ensure
DropdownMenu
can be dismissed byDropdownMenuItem
s being used as internal links (PR 288)
0.7.2 - 2019/10/25
Added
- Add
href
andexternal_link
props toButton
(PR 259) - Add
href
,external_link
,n_clicks
andn_clicks_timestamp
props toBadge
to allow for use in callbacks and navigation. (PR 268)
Fixed
- Allow
InputGroupAddon
to accept multiple children andRadioButton
orCheckbox
components (PR 260) - Prevent
Tabs
from throwing an error if instantiated without children (PR 266) - Enable the
value
prop ofSelect
to be used as the Output in a callback (PR 270) - Prevent
setProps
from being set on DOM elements (PR 264) - Set
key
on list items forRadioItems
andChecklist
(PR 265)
0.7.1 - 2019/9/7
Added
- Add
Select
component that renders a styled<select>
element. Options and values are specified much likedash_core_components.Dropdown
(PR 251) - Add
duration
prop toAlert
andToast
components allowing users to specify a time in milliseconds after which theAlert
/Toast
will dismiss itself (PR 250)
Changed
- Internal improvements to
Input
withtype="number"
(PR 244)
0.7.0 - 2019/7/25
Added
- Add
Toast
component (PR 234)
Changed
- Use Bootstrap's custom radio and checkbox styles for
RadioItems
andChecklist
. This can be overridden by settingcustom=False
(PR 238) - Rename
values
prop ofChecklist
tovalue
for consistency with other components and with Dash >=1.0.0 (PR 226)
0.6.3 - 2019/6/27
Added
- Expose
color
,toggle_style
andtoggleClassName
props inDropdownMenu
component (PR 221)
0.6.2 - 2019/6/5
Fixed
- Allow
active_tab
prop ofTabs
to be set by callbacks (PR 213)
0.6.1 - 2019/5/19
Added
- Add
"baseline"
and"stretch"
as possible arguments toalign
in bothRow
andCol
components (PR 204)
0.6.0 - 2019/5/10
Added
- Enable the
"up"
direction inDropdownMenu
(PR 196)
Changed
- Remove
CardTitle
,CardSubtitle
andCardText
components in favour of applying thecard-title
,card-subtitle
orcard-text
classes to relevant HTML components (PR 193) - Use timestamps rather than Date objects for the
*_timestamp
props inInput
(PR 189) - Rename props of
Input
to use camelCase in order that they are applied properly by dash-renderer (PR 189)
0.5.0 - 2019/4/19
Added
- Add
Modal
andSpinner
components (PR 177)
Changed
- Allow
DropdownMenu
to be right aligned (PR 143)
0.4.0 - 2019/4/7
Added
- Add
dismissable
prop toAlert
(PR 158) - Add support the Dash loading states feature (PR 171)
- Expose the
style
prop inButtonGroup
(PR 167) - Expose the
disabled
prop inInput
(PR 170) - Expose the
group
prop inDropdownMenu
(PR 175)
Changed
- Remove
DatePickerSingle
andDatePickerRange
components. Use the versions from dash-core-components instead (PR 159)
Older versions
Older versions continue to exist on PyPI, but we strongly recommend using more recent versions. If you need to know what changed in old versions of dash-bootstrap-components you can check the releases page on GitHub.