- Add missing import of
dmc-code.csstoInlineCodeHighlight. #704 by @antonymilne - Unknown code highlight language now defaults to
plaintextrather thanmarkdown. #704
- Updated to Mantine 8.3.17 #705
- Added
ColorSchemeToggleto switch between light and dark themes without a callback. The current scheme is persisted in localStorage (mantine-color-scheme-value). Also added thepre_render_color_scheme()helper, which sets the color scheme before the app renders on page load or refresh, preventing flashes of the wrong theme. #693 by @AnnMarieW
- Fixed
NumberInputclamping whenmax=None#697 by @AnnMarieW - Fixed prop types in
GridandSimpleGrid#698 by @AnnMarieW
- Updated to Mantine 8.3.14 #699
- Fixed more Python type generation by including improvements available in latest dash version. #692
-
Added
TableOfContentscomponent #513 by @deadkex -
Exposed
MantineCoreandMantineHookson the global window object for use in custom Dash components. This enables building custom Dash components that depend on Mantine components or hooks while remaining compatible with Dash Mantine Components. #653 by @BSd3v -
AppShell: Add static
modesupport for nested app shells -
Added
selectFirstOptionOnDropdownOpenandopenOnFocusprops to Combobox based components.
- Fixed
PinInputso thatvaluecan be set initially and in a callback. #684 by @AnnMarieW - Fixed Python type generation, #688 and #685 by @AnnMarieW
- Updated to Mantine 8.3.13
- Added
withAlignedLabelsprop to support offsetting the selected check icon inSelectandMultiSelect#675 by @AnnMarieW. - Added
anchorPropsprop toAnchorby @jksinton
- Fixed race condition in debounced value updates #671 by @AnnMarieW
- Updated to Mantine (8.3.10), Recharts (2.15.4), and TipTap (3.14.0) #675
-
Two new copy to clipboard components #662 by @AnnMarieW
CopyButtona ready-to-use copy button with customizable text, icons, and colors to indicate copy state.CustomCopyButtona fully customizable component using JavaScript function props for advanced use-cases.
-
Added function as prop support for
xAxisProps,yAxisProps,gridProps,rightYAxisProps(andzAxisPropsfor BubbleChart) inAreaChart,BarChart,BubbleChart,CompositeChart,LineChart, andScatterChart. #661 by @AnnMarieW -
RichTextEditor updates:
- Added
dash_mantine_components.getEditor(id)function to access the Tiptap editor instance in clientside callbacks. #666 by @AnnMarieW - Added
focusprop to control the cursor of theRich Text Editor#665 by @chgiesse - Added
editableprop toRich Text Editor#665 - Enabled code highlighting with the
CodeBlockLowlightextension #663 by @AnnMarieW
- Added
- removed random react key generation which led to keys never match up between renders and would force component rerenders. #664 chgiesse
- Updated to latest Mantine (8.3.6) #667 by @AnnMarieW
-
New
scrollToprop forScrollArea#645 by @AnnMarieW -
New
ScrollAreaAutoheightcomponent. #645 -
added
DirectionProviderto handle RTL (right-to-left) text direction. #650 by @AnnMarieW -
added
debounceprop to `Autocomplete #654 by @AnnMarieW -
added support for new text style features from TipTap 3: BackgroundColor, FontFamily, FontSize, LineHeight. #657 By @AnnMarieW
The following new features available in Mantine 8.3.0 were added in #655 by @AnnMarieW
MiniCalendarcomponentorientationprop forProgress. Now supports both horizontal and vertical orientationclearSearchOnChangeprop forMultiSelect- to clear search input when an item is selectedreverseTimeControlsListprop forTimePicker- to reverse the order of time controls in the dropdown. Use this option if you want the order of controls to match keyboard controls (up and down arrow) direction.
- BarChart: Added default
valueFormatterto prevent rendering issues whenvalueFormatteris undefined. #464 by @AnnMarieW
- Updated to latest Mantine (8.3.1) #650 by @AnnMarieW
RichTextEditornow uses Tiptap 3 (Mantine 8.3.0 recommendation). . No known breaking changes, but customizations may be affected. See our migration guide,. #657 by @AnnMarieW
- Fixed
MultiSelectandSelectso that changes to thedataandvalueare batched so they only trigger a single callback. #637 by @AnnMarieW - Fixed a regression where Navlinks with
childrendid not open/close on click. #633 by @AnnMarieW
- Upgraded to latest Mantine (8.2.7) #638 by @AnnMarieW
See details and examples in the DMC 2.2.0 Release Announcement
- Added support for custom toolbar controls in
RichTextEditor#629 by @BSd3v - Added
clearSearchOnFocusprop toSelect#627 by @AnnMarieW
The following was added in #625 by @AnnMarieW
attributesprop – Pass custom attributes to inner elements of components that support the Styles API.strategyprop forContainer– Addedstrategy="grid"option for grid-based layouts with breakout features.targetprop forTooltip– Specify tooltip targets using a selector, HTML element, or ref, as an alternative to children.chevronIconSizeprop forAccordion– Control the size of the default chevron icon independently fromchevronSize.keepMountedprop forCollapse– Keep collapsed content in the DOM while hidden.autoSelectOnBlurprop forSelectandAutocomplete– Automatically select the highlighted option when the input loses focus.
- Fixed CSS for
CodeHighlightso it works whendcc.Markdownand/ordash-ag-gridare also used in the same app. #625 by @AnnMarieW
- Upgraded to latest Mantine (8.2.5) #632 by @AnnMarieW
- Resolved an issue where
SliderandRangeSlidervalues did not update correctly when theminormaxprops were updated in a callback. #616 by @AnnMarieW
- Added
valueLabelPropstoBarChartto allow customization of the value label, which is displayed whenwithBarValueLabelis set. #619 by @CGaul
-
New features for
Autocomplete#604 by @ihor-lazariev:- Support functions as props in
renderOptionandfilterprops - Added
clearButtonPropsandclearableprops
- Support functions as props in
-
Added
renderNodeprop inTreecomponent, allowing full control over node rendering with a JavaScript function. #608 by @AnnMarieW -
Added Modal Stack and Drawer Stack components #606 by @AnnMarieW
- Introduced
ModalStack/ManagedModalandDrawerStack/ManagedDrawerfor managing stacked modals and drawers. ModalStackandDrawerStackaccept the Dash props:open,close,toggle, andcloseAllto control visibility, and a read-onlystateprop to track which children are open.
- Introduced
-
Added Props #609 by @AnnMarieW
headerControlOrderPropto calendar componentspresetstoDatePickerandDateTimePickerautoContrasttoTooltipandFloatingTooltipdomaintoSliderandRangeSliderpushOnOverlaptoRangeSliderbdrsnew style prop to forborderRadiusgetYearControlProps,getMonthControlProps,getDayProps,renderDayto date components
- Fixed issue where setting
value=NoneinMultiSelectorCheckboxGroupcaused an error #609
- Upgraded to latest Mantine (8.1.2)
- BREAKING CHANGES - updated to use Mantine 8.0.2
- See Migration guide in the dmc-docs
-
New
TimePicker,TimeGrid,DatePickerandSubMenucomponents -
Functions as Props #580 by @AnnMarieW and @BSd3v
- Components can now accept JavaScript functions via:
{"function": "myFunction"} - Functions must be defined in a .js file in
/assetsinwindow.dashMantineFunctionnamespace - Supports passing
optionsfrom Python, for example:{"function": "formatTemp", "options": {"unit": "F"}} - Supported props:
- label and scale in Slider and RangeSlider
- renderOption and filter in Select, MultiSelect and TagsInput,
- disabledDates in date components with a calendar picker
- getBarColor in BarCharts
- valueFormatter and tooltipProps in chart components
- Components can now accept JavaScript functions via:
-
New way to handle Notifications #539 by @BSd3v
- Added new
NotificationContainerthat works more closely to upstream Notifications in Mantine. - Exposed the
notificationsapi of Mantine for granular control atdash_mantine_components.appNotifications.api - Exposed the
storeof notifications atdash_mantine_components.store - Marked
NotificationandNotificationProviderfor deprecation
- Added new
- Added
tablePropsandtabularNumsprops toTable#587 by @AnnMarieW - Added
TableScrollContainercomponent #587 by @AnnMarieW
- Fixed issue for components as props for
Timeline,Stepper,CodeHighlightandSegmentedControl. #555 by @BSd3v - Removed unused async files #587 by @AnnMarieW
- Upgraded to latest Mantine (7.17.7)
- Added
inputPropsto JsonInput, NumberInput, PasswordInput, TextInput, and TextArea components to allow passing props directly to the underlying input element. #568 by @AnnMarieW - Optional component stylesheets are now bundled automatically. It’s no longer necessary to include them as external stylesheets or add them to the assets folder. PR #567 by @AnnMarieW
- Fixed issue where children of certain components could not be updated in a callback. Requires dash >=3.03 #558 by @AnnMarieW
- Fixed issue where Navlink could not be updated in a callback if the href prop was not set initially. #562 by @AnnMarieW
- Fixed issue with components that used
useMemothat couldn't be updated in a callback. #561 BY @AnnMarieW
- Upgraded to latest Mantine (7.17.4)
- Reverted PR #523, which introduced errors in the
Notificationcomponent (reported in issue #542). - Resolved an issue in the
Steppercomponent where it failed to render correctly when using custom icons or other components as props. #544 by @BSd3v
- Added
RichTextEditorandTypographyStylesProvidercomponents #530 by @emilhe
- Complex components such as
CodeHighlightTabs, andStepperare now rendered by the dash ecosystem when using dash 3+. Dash 2 falls back ondash-extensions-jsto render viaReact.createElement(by @emilhe). This enables the use of these components in callbacks as triggers. #531 @BSd3v - Upgraded to latest Mantine (7.17.2)
- Fixed
TagsInputinitial value being cleared after user update (regression introduced in 1.0.0) #533 by AnnMarieW
- Removed
draggableandspeedprop fromCarouselsince these props are not supported in Embla Carousel V8. #520 by @AnnMarieW
- Added
middlewaresprop toTooltipandoverscrollBehaviorprop toScrollArea(New props as of Manitine 7.17). #520 by @AnnMarie
Notificationwill now automatically set itsactiontohidewhen closed, this avoids issues where acallbackerror would re-trigger the component. #523 by @BSd3v- graphs and code highlight components now loaded async, reducing the dash_mantine_components.js file size from 2.68 MiB to 823 KiB #521 by @AnnMarieW and @emilhe
- Added
CheckboxCardCheckboxIndicatorRadioCardRadioIndicatorcomponents #486 by @deadkex
-
Expanded the
activeprop to support string values ("exact"and"partial") in addition totrue/false. #504 by @BSd3vexact: Marks the link as active only whenpathnameexactly matcheshref.partial: Marks the link as active whenpathnamestarts withhref, allowing for subpages.
-
Upgraded to latest Mantine (7.17.0)
- Corrected an error in the
Alertcomponent when thedurationprop was set when using dash>=3 #516 by @AnnMarieW
-
This release ensures dash-mantine-components V1 is compatible with both Dash 2 and Dash 3
-
⚠️ Important: Apps usingdmc < 1.0.0must pindash < 3to avoid compatibility issues.
- Updated to handle changes in Dash 3 #506 by @AnnMarieW:
- Removed
defaultPropsto be compatible with React 18.3 - Handled the removal of the
loading_stateprop - Updated to use the new
dash_component_api
- Removed
- For
MonthPickerInput, the debounce prop can now be True, False or number of ms delay before updating. When True, the value updates on blur. #471 by @oelhammouchi - Added
InputWrappercomponent #491 by @Godisemo
- Fixed debounce in
DatePickerInputthat stopped working in 0.15.2 #496 by @AnnMarie - Enable components to be used in
childrenandiconin thecloseButtonPropsandclearButtonProps. #493 by @AnnMarieW
- Upgraded to latest Mantine (7.16.2)
-
Added
disabledprop for individual options on aSegmentedControl#451 by @petefine -
Added
typeprop forSimpleGridto enable container queries #472 by @namakshenas -
Added
typeprop andbreakpointsprop forGridto enable container queries #473 by @namakshenas -
Added props #478 by @AnnMarieW:
inlineprop toCenter,allowedInitialsColorstoAvatardefaultExpandedtoCodeHightlightTabsautoCompletetoPasswordInput
-
Added props available in Mantine 7.16.0 #489 by @AnnMarieW
withOverlayandoverlayPropsto `PopoverwithPagesto `PaginationtypetoCarouselenabling container queriesrestrictToMarkstoRangeSlider
-
Added
Treecomponent #460 by @Godisemo -
Added
InlineCodeHighlightcomponent #483 by @Godisemo
- Styled the figure buttons in the "mantine_light" and "mantine_dark" Plotly figure templates. #456 by @AnnMarieW
- In
CarouselAllow only "center" | "start" | "end" in thealignprop #477 by @AnnMarieW
- Upgraded to latest Mantine (7.16.1)
-
Added
disabledprop toRadio#425 by @namakshenas -
Added
lineSizeprop toBurger#432 by @ChinoUkaegbu -
Added
SemiCircleProgresscomponent #434 by @AnnMarieW -
Added the
add_figure_templates()function which creates Mantine-styled Plotly figure templates for both light and dark modes using the default Mantine theme. It registers the templates with plotly.io.templates as "mantine_light" and "mantine_dark", and optionally sets one of the themes as a default. #431 by @AnnMarie -
Added various props:
acceptValueOnBlurtoTagsInput,gradienttoLineChart,hideWithOnePagetoPagination,nametoAvatar, anddisabledtoNumberInput. #440 by @AnnMarieW
- Fixed closing of Popovers when clicking outside. #423 by @magicmq
- Enabled
searchValuein theMultiSelectcomponent to be updated in a callback #441 by @AnnMarieW
- Upgraded to latest Mantine (7.14.3), which also fixes issues #413 and #439
- Breaking Change: Renamed
DatePickertoDatePickerInputso component names are aligned with the upstream Mantine library. #414 by @AnnMarieW - Upgraded to latest Mantine (7.14.1)
-
New additions to Date components #405 by @AnnMarieW
DatePicker- Thedebounceprop can now beTrueFalseornumberof ms delay before updating. When True, the value updates on blur.- Added missing
highlightTodayprop on all Date components with calendars. DateInputupdates properly now when clearable=True
-
Enabled custom icons in
CheckboxAddediconandindeterminateIconprops #408 by @snehilvj -
New props:
barLabelColorfor theBarChartandrestrictToMarksfor theSlider#416 by @AnnMarieW -
Added
positionprop to `Notification #419 by @AnnMarieW
- In MultiSelect, enable the debounce to work when deleting items when the dropdown is closed when debounce is a number. #407 by @AnnMarieW
- In MultiSelect and Select, fixed regression where it was not possible to update both the value and data in the same callback #412
- Fixed console warning in Tooltip component by adding a key to the wrapper Box element #418 by @AnnMarieW
- Added
autoScrollprop to theCarouselcomponent, enabling smooth scrolling like a stock ticker. #373 by @mmarfat - Added
withLegendtoRadarChart, andmaxBarWidth,minBarSizetoBarChart. #395 by @AnnMarieW - New chart types:
CompositeChartandBubbleChart#368 by @michaelw88 - New props for charts: (Included in #368 by @michaelw88)
- added
hoverData,hoverSeriesName,clickSeriesNameandhighlightHoverprops toAreaChart,LineChart,BarChart, andCompositeChart - added
hoverData,hoverSeriesName,clickSeriesNametoPieChart,DonutChart,ScatterChart
- added
- New props for triggering dash callbacks on input components:
n_submitn_blur#383 by @AnnMarieW
- Reduced the Highlight component file size #366 by @AnnMarieW
- The
debounceprop on input components can now beTrueFalseornumberof ms delay before updating. When True, the value will update on enter or on blur. #383 by @AnnMarieW - Upgraded to latest Mantine (7.13.3)
- Prevent loading from empty
srcinAvatar. #372 by @mmarfat - Enable base64 images in Avatar #379 by @AnnMarieW
- Fixed boxWrapperProps in the Hovercard #389 by @AnnMarieW
- Added
autoplayprop to theCarouselcomponent #316 by @mmarfat - Added the
ChipGroupcomponent and updatedChipto work with it. #327 and #355 by @AnnMarieW and @BSd3v - Added GitHub actions workflow for automated tests on PRs #333 by @BSd3v
- Added new and missing props to the charts. Enables figure animation, right Y axis and more! #349 by @AnnMarieW
- Added
activeprop to Carousel, allowing callbacks to be triggered based on the currently displayed slide. #354 by @AnnMarieW - RadioGroup and ChipGroup (in single mode) now have a
deselectableargument to allow resetting the radio value #351 by @RenaudL
- Excluded the
loading_stateprop from being passed to the DOM. Addeddata-dash-is-loadingattribute to components during callback execution, allowing custom CSS styling for loading states. #325 by @AnnMarieW - Enabled the
openedprop to trigger callback in the Popover component #353 by @AnnMarieW - Stepper component can be stepped through by clicking on steps buttons #352 by @RenaudL
- Reduced the package size by excluding the 5MB metadata.json file #357 by @AnnMarieW
- Upgraded to latest Mantine (7.13.2)
-
for Date components:
- enable date parsing based on the valueFormat
- locale now works with persistence and on first render
- This PR #314 is based on #265 - Thanks for your contribution @albavilanova
-
Fixed
boxWrapperPropsin theMenuTargetcomponent #309 by @datenzauberai -
Ensure that Mantine and stylesheet versions match to the exact version rather than the major version. #317 by @AnnMarieW
-
Changed
inprop name toopenedin dmc.Collapse #311 by @AnnMarieW -
When updating the
datain aSelectorMultiSelectcomponent in a callback, the value now correctly reflects only valid options. #301 #324 by @AnnMarieW.
- Added
disabledprop toFieldsetcomponent #306 by @AnnMarieW - New components #266 by @stpnvkirill
- MonthPickerInput
- YearPickerInput
- Added
barPropsandwithValueLabelsfor the BarCharts #300 by @AnnMarieW
- Upgrade to latest Mantine (7.13.0)
- Image and BackgroundImage supports base64 encoded images #282
- Time parsing in DateTimePicker. #273
- Show MenuItem as disabled when argument is set to True. #202
- Update selection when options are changed in combobox components - Select, MultiSelect and TagsInput. #201
- Add readOnly prop to input components. #252
- Ability to control Spoiler state. #277
- Expose stylesheet links at dmc.styles.*
- Upgrade to latest Mantine (7.11.0)
- TagsInput component
- Corrected transition props.
- Burger component
- Click callback in chart components by subscribing to
clickDataproperty. This feature might change in future.
- TooltipFloating has been renamed to FloatingTooltip as its not a compound component.
- Corrected prop structure of few components
- BREAKING CHANGE!!
- Updated to use latest Mantine - v7
- Detailed changelog for Mantine v7 can be found here: https://mantine.dev/changelog/7-0-0/.
- Added a bunch of new components like nprogress, charts, carousel, etc.
- Fixed issues revealed in process of developing 0.13 series based on Mantine v6.
- Wild card aria-and data- props to all components
- New component:
- InputWrapper
- Missing input props from TimeInput
- Pass empty list as default prop for Select and MultiSelect
- Remove left over MantineProvider from Switch testing
This release is based on Mantine v6.
- New components
- Autocomplete
- Box
- ColorInput
- Flex
- Popover
- Rating
Detailed changelog for Mantine v6 can be found here: https://mantine.dev/changelog/6-0-0/.
- Date components freezing the entire UI
- Persistence props for TransferList #171
- Clearing datepicker via callback #167
- Trigger callback when new options are created using the creatable prop in Select and MultiSelect #164
- Add
classNamesprop to all components
- Disabled dates losing effect in DatePicker and DateRangePicker #137
- Date range selection issue when selecting adjacent dates #66
- AppShell prop types #162
- Updated to use latest Mantine - v5.10.5
- New Mantine Style props. #142
spellcheckprop to text input components #133styleprop for MediaQuery inner box component #148- New props to few components because of Mantine version upgrade.
- New components
- NavLink
- TransferList
- Indicator
- Add
disabledproperty in Checkbox #150 - Pass initial value to Checkbox component #140
- Stepper icon bug #146
- Missing style props in Notification component.
- Bullet and title were not rendered. #126
- Accessibility props in some components.
- New components
- HoverCard #114
- Stepper #109
- Notification!!
- Disable browser autocomplete in input components #111
- Search value prop for Select and MultiSelect #89
- Missing persistence props from text inputs
- Ability to set Select/Multiselect options using callbacks
- ActionIcon was not reflecting disabled state.
- MenuItem links now work like Anchor (which in turn works as dcc.Link now).
- Make persistence props optional.
- New components:
- Card, CardSection
- Burger
- AppShell
- Persistence props
nameprop in text inputs for forms. #103- Ability to debounce callbacks by specifying a duration in all text inputs. #102
- Button not showing disabled state. #106
- Inability to move RangeSlider left handle when
minprop is set to a negative value. (Fixed in upstream)
This is an alpha release based on Mantine v5. This version of dmc is a big overhaul with lots of new features but at the cost of backward compatibility for many components.
- Updates for Mantine v5.
- New component APIs such as for Tabs, Accordion, RadioGroup, etc.
- Prop names
- Adopted typescript which simplified the code a lot. Thanks to @plotly team.
- Organisation of components source code.
- New components:
- FloatingTooltip
- Aside, Footer
- RangeSlider
- Notification and NotificationsProvider component for now, as they are not compiling for some reason.
styleprop in Timeline and TimelineItem.
- Tooltip component was not working properly.
- Typo in
autosizeprop name in Textarea component.
- New components
- Textarea
- Missing id's from Stack and Timeline components.
- New components
- PasswordInput
- Stack
- Pagination
- Input element types for TextInput component
- ActionIcon component
- (Specific to dmc-docs) DemoSlider, ThemeSwitcher
- Missing default icon bug in accordion and Blockquote.
- Slider onChange callbacks
- New props in various components
- Add persistence to all inputs as well as tabs
- New components:
- Menu, MenuItem, MenuLabel Code List, ListItem BackgroundImage
- Chip disabled state was not passed to component.
- New components:
- Kbd
- Avatar, AvatarGroup
- Highlight
- Timeline, TimelineInput
- Mark
- MediaQuery
- DateRangePicker will clean up the half selected range on dropdown close. #47
- DatePicker and DateRangePicker timezone issue. #33
- LoadingOverlay component similar to dcc.Loading
- Persistence in DatePicker, DateRangePicker, MultiSelect, RadioGroup, Select, TimeInput
- Skeleton component was not using loading_states.
- Props in Tooltip
- Underline prop in Text
- Mantine default theme colors.
dmc.theme.DEFAULT_COLORS
- New components:
- NumberInput
- JsonInput
- ThemeIcon
- Table
- RingProgress
- TimeInput
- Props in SimpleGrid, Navbar, Header, Spoiler, and Title.
- Issues in Notifications system.
inlineprop from Center, as it doesn't work right now.
- Corrected props for Datepickers, Notification, and slider.
- Props were not rendered correctly in InputWrapper.
- DatePicker and DateRangePicker will now accept date/dates through callbacks. #23.
- Updated props for some components to follow Mantine components more strictly.
- MantineProvider to allow theming, more specifically dark theme.
- Support for passing and rendering components other than
chidren. - Transition and shadow props to all components that support them.
- A new Notification component.
- Removed the NotificationHandler component which was not easy to work with.
- DatePicker and DateRangePicker now accept date/dates under the prop name
valueto support pattern matching callbacks and to follow the Mantine convention.