Changelog

Unreleased

See on GitHub: branch master | compare 1.1.1/master

pip install https://github.com/kivymd/KivyMD/archive/master.zip

• Bug fixes and other minor improvements.

• Add icon color property to right_action_items/left_action_items in MDTopAppBar class.

• Add feature for changing the scale of the shadow for CommonElevationBehavior class.

• Add elevation properties to MDDataTable class.

• Add to MDDropdownMenu class.

• Add on_copy event to MDLabel class.

• Add feature to highlight a label with a double tap to MDLabel class.

• Add feature to use text markup in the toast label.

• Fix MDDatePicker widget:

  • Make day widgets non-clickable when another dialog is open;

  • Refactor input fields and fix some bugs;

• Fix MDDropdownMenu position isn’t working.

• Fix switching between a dark and light theme causes most of the MDTextField widget elements not to update their colors when changing the theme.

• Fix incorrect md_bd_color behavior of MDLabel class.

• Fix changing theme doesn’t work as expected with MDDataTable.

• Fix on_long_touch method call for TouchBehavior class - the on_long_touch method was called at the on_touch_down event.

• Fix MDTextField gets text color to black when disabled using dark theme.

• Fix (45024f1) MDLabel not change its color when theme is switched to “Dark” after switching screens.

• Fix right/left icons color - when the MDTextField is in the disabled state, the icon color has not changed.

• Fix text colors - when the MDTextField is in the disabled state nd at the same time in the error state, the colors of the hint text, helper text, max text length have not changed.

• Fix Bug on android related to shaders.

• MDBottomSheet API break. Now the MDBottomSheet class implements only the behavior of the bottom sheet. All custom content must be implemented by self.

• Fix Cannot set font_size when instantiating MDLabel.

• Fix widget size adjustment:

  • When we use the adaptive_height/adaptive_width/adaptive_size parameters, if the widget did not contain child widgets, then its size would be 100.

• Add radius property to MDProgressBar class.

• The material design style has been changed. By default now M3.

• Add MDBottomAppBar M3 style.

• Add new properties to MDScrollViewRefreshLayout class:

  • spinner_color;

  • circle_color;

  • show_transition;

  • show_duration;

  • hide_transition;

  • hide_duration;

• Fix Adaptive_width and md_bg_color properties of MDLabel are not working correctly.

• Add rounded corners for a rectangle type to MDTextField class.

• Remove glsl_path from data from hook-kivymd.py module.

• Add SegmentedButton widget.

• MDSnackbar API break:

  • now the widget has become more customizable and closer to the standards of material design version 3.

• Improved animation performance for animate the MDCheckbox widget.

• Add the feature to use parent and child checkboxes for MDCheckbox.

• MDChip API break:

  • now the widget has become more customizable and closer to the standards of material design version 3.

• Fixed elevation animation for buttons;

• Improved performance and behavior of the MDDropdownMenu class;

• MDDropdownMenu `API break <>https://kivymd.readthedocs.io/en/latest/components/menu/#api-break`_;

• Added the motion_behavior module to the behaviors package to control the display/hide behavior of widgets;

• Fixed scaling and rotation of widgets with elevation behavior;

1.1.1

See on GitHub: tag 1.1.1 | compare 1.0.2/1.1.1

pip install kivymd==1.1.1

• Bug fixes and other minor improvements.

• Add closing_interval parameter to MDCardSwipe class.

• Add implementation of elevation behavior on shaders.

• Add validator property to MDTextField class: the type of text field for entering Email, time, etc. Automatically sets the type of the text field as error if the user input does not match any of the set validation types.

• Add theme_style_switch_animation property to animate the colors of the application when switching the color scheme of the application (‘Dark/light’).

• Add theme_style_switch_animation_duration property to duration of the animation of switching the color scheme of the application (“Dark/ light”).

• Fix memory leak when dynamically adding and removing KivyMD widgets.

• Fix MDBottomNavigation slide transition direction.

• Add a default value for the icon attribute of MDApp class.

• Add new properties to MDFileManager class:

  • icon_selection_button - icon that will be used on the directory selection button;

  • background_color_selection_button - background color of the current directory/path selection button;

  • background_color_toolbar - background color of the file manager toolbar;

  • icon_color - color of the folder icon when the preview property is set to False;

• Add binds to MDFloatingActionButtonSpeedDial individual buttons;

• Add functionality for using multiple heroes.

• Add shadow_softness_size attribute (value of the softness of the shadow) to CommonElevationBehavior class.

• Optimize of MDDatePicker widget.

1.0.2

See on GitHub: tag 1.0.2 | compare 1.0.1/1.0.2

pip install kivymd==1.0.2

• Bug fixes and other minor improvements.

• Added a button to copy the code to the documentation.

• Added the feature to view code examples of documentation in imperative and declarative styles.

• Added console scripts for developer tools.

1.0.1

See on GitHub: tag 1.0.1 | compare 1.0.0/1.0.1

pip install kivymd==1.0.1

• Bug fixes and other minor improvements.

• Fix https://github.com/kivymd/KivyMD/issues/1305.

1.0.0

See on GitHub: tag 1.0.0 | compare 0.104.2/1.0.0

pip install kivymd==1.0.0

• Bug fixes and other minor improvements.

• Added ImageLeftWidgetWithoutTouch, ImageRightWidgetWithoutTouch, IconRightWidgetWithoutTouch, IconLeftWidgetWithoutTouch classes to kivymd/uix/list.py module;

• Added MDStepper component;

• Added a feature, show_disks to the MDFileManager class, that allows you to display the disks and folders contained in them;

• Added animation_tooltip_dismiss function and on_dismiss event to MDTooltip class;

• Added MDColorPicker component;

• Added new transition package - a set of classes for implementing transitions between application screens;

• Now all modules from the uix directory are packages;

• Type hints have been added to the source code of the KivyMD library;

• Added divider_color attribute to BaseListItem class;

• Added load_all_kv_files method to MDApp class;

• Added Templates package - base classes for controlling the scale, rotation of the widget, etc.;

• Added kivymd/tools/patterns package - scripts for creating projects with design patterns;

• FitImage widget move from kivymd.utils to kivymd.uix.fitimage;

• Added background_color_header, background_color_cell, background_color_selected_cell, added methods for adding/removing rows to a common table to MDDataTable widget;

• Added method for update rows to MDDataTable class;

• Delete kivymd/utils/hot_reload_viewer.py;

• Added kivymd/tools/hotreload package;

• Added top value to position parameter of MDDropdownMenu class;

• Added get_current_tab method to MDTabs class;

• Added the feature to automatically create a virtual environment when creating a project using the kivymd.tools.patterns.create_project tool;

• Added the feature to use the left_icon for MDTextField text fields;

• The design and behavior of the MDChip widget is close to the material design spec;

• Added the feature to set the thickness of the MDProgressBar class;

• Added localization support when creating a project using the create_project tool;

• Added support Material Design v3;

• Added support badge icon to MDIcon class;

• Added the feature to use a radius for the BaseListItem class;

• MDFloatingActionButton class configured according to M3 style;

• Ripple animation for round buttons customized to material design standards;

• Fix Warning, too much iteration done before the next frame for button classes;

• Added FadingEdgeEffect class

• Added MDSliverAppBar widget;

• Added the feature to use custom icons and font name for the MDBottomNavigation class;

• Rename MDToolbarr to MDTopAppBar class;

• The overflow behavior from the ActionBar class of the Kivy framework has been added to the MDTopAppBar class;

• Add shift_right and shift_right attributes to MDTooltip class;

• Fixed the size of the MDIconButton icon when changing icon_size on mobile devices;

• Add new MDSegmentedControl widget;

• Add on_release/on_press events to MDSmartTile class;

• Add mipmap property to FitImage class;

• Added the feature to use Hero animation;

• Added MDResponsiveLayout layout;

• Added add_view utility;

• Added the feature to create widgets in declarative programming style;

0.104.2

See on GitHub: tag 0.104.2 | compare 0.104.1/0.104.2

pip install kivymd==0.104.2

• Bug fixes and other minor improvements.

• Add HotReloadViewer class

• Added features to Snackbar class: use padding, set custom button color, elevation

• Add MDToggleButton class

• Change to Material Design Baseline dark theme spec

• Fix ReferenceError: weakly-referenced object no longer exists when start demo application

• Changed the default value for the theme_text_color parameter in the BaseButton class (to the value “Primary”)

• Fix setting of the text_color_normal and text_color_active parameters - earlier their values ​​did not affect anything

• Fixed the length of the right edge of the border in relation to the hint text when the MDTextField is in the rectangle mode

• Add get_tab_list method to MDTabs class

• Add hover behavior when using MDDropdownMenu class

• Added the feature to use the FitImage component to download images from the network

• The elevation value for RectangularElevationBehavior and CircularElevationBehavior classes after pressing was always set to 2 - fixed

• Methods that implement the ripple effect have always been called twice - fixed

• The SmartTile class now uses the FitImage class to display images instead of the Image class

• Removed dependency on PIL library

• Add hint_bg_color, hint_text_color, hint_radius attributes to MDSlider class

• Delete progressloader.py

• Delete context_menu.py

• Added the feature to control the properties of menu items during creation in MDDropdownMenu class

• Added the feature to change the number of buttons after creating the MDFloatingActionButtonSpeedDial object

• Added the feature to set the font_name property for the MDTabsLabel class

• Add MDCarousel class

• Delete kivymd/uix/useranimationcard.py

• Added usage types for MDNavigationDrawer class: modal/standard

• Added stencil instructions to the FitImage class canvas

• Added on_ref_press and switch_tab methods to MDTabs class

• Added on_release method for menu item events instead of callback method to MDDropdownMenu class

• Added palette attribute - the feature to change the color of the MDSpinner when changing rotation cycles

• Added the feature to change the border color of the MDRectangleFlatIconButton class

• Add MDRelativeLayout class

• Added the feature to use radius for MDNavigationDrawer corners

• Removed UserAnimationCard class

• Added feature to set background color for MDDialog class

• Added MDNavigationRail component

• Added MDSwiper component

• Added ripple effect to MDTabs class

• Added the feature to set toast positions on an Android device

• Added of tooltips to MDToolbar icons

• Fixed MDBottomAppBar notch transparency

• Updated MDDatePicker class to material design specification.

• Updated MDTimePicker class to material design specification.

• Elevation behavior redesign to comply with the material design specification.

• Removed the vendor package.

• Added the feature to use a class instance (Kivy or KivyMD widget), which will be added to the MDDropdownMenu class menu header.

0.104.1

See on GitHub: tag 0.104.1 | compare 0.104.0/0.104.1

pip install kivymd==0.104.1

• Bug fixes and other minor improvements.

• Added MDGridLayout and MDBoxLayout classes

• Add TouchBehavior class

• Add radius parameter to BackgroundColorBehavior class

• Add MDScreen class

• Add MDFloatLayout class

• Added a MDTextField with fill mode

• Added a shadow, increased speed of opening, added the feature to control the position of the MDDropdownMenu class

• The MDDropDownItem class is now a regular element, such as a button

• Added the ability to use the texture of the icon on the right in any MDTextField classes

• Added the feature to use ripple and focus behavior in MDCard class

• MDDialogs class redesigned to meet material design requirements

• Added MDDataTable class

0.104.0

See on GitHub: tag 0.104.0 | compare 0.103.0/0.104.0

pip install kivymd==0.104.0

• Fixed bug in kivymd.uix.expansionpanel.MDExpansionPanel if, with the panel open, without closing it, try to open another panel, then the chevron of the first panel remained open.

• The kivymd.uix.textfield.MDTextFieldRound class is now directly inherited from the kivy.uix.textinput.TextInput class.

• Removed kivymd.uix.textfield.MDTextFieldClear class.

• kivymd.uix.navigationdrawer.NavigationLayout allowed to add kivymd.uix.toolbar.MDToolbar class.

• Added feature to control range of dates to be active in kivymd.uix.picker.MDDatePicker class.

• Updated kivymd.uix.navigationdrawer.MDNavigationDrawer realization.

• Removed kivymd.uix.card.MDCardPost class.

• Added kivymd.uix.card.MDCardSwipe class.

• Added switch_tab method for switching tabs to kivymd.uix.bottomnavigation.MDBottomNavigation class.

• Added feature to use panel type in the kivymd.uix.expansionpanel.MDExpansionPanel class: kivymd.uix.expansionpanel.MDExpansionPanelOneLine, kivymd.uix.expansionpanel.MDExpansionPanelTwoLine or kivymd.uix.expansionpanel.MDExpansionPanelThreeLine.

• Fixed panel opening animation in the kivymd.uix.expansionpanel.MDExpansionPanel class.

• Delete kivymd.uix.managerswiper.py

• Add MDFloatingActionButtonSpeedDial class

• Added the feature to create text on tabs using markup, thereby triggering the on_ref_press event in the MDTabsLabel class

• Added color_indicator attribute to set custom indicator color in the MDTabs class

• Added the feature to change the background color of menu items in the BaseListItem class

• Add MDTapTargetView class

0.103.0

See on GitHub: tag 0.103.0 | compare 0.102.1/0.103.0

pip install kivymd==0.103.0

• Fix MDSwitch size according to material design guides

• Fix MDSwitch’s thumb position when size changes

• Fix position of the icon relative to the right edge of the MDChip class on mobile devices

• Updated MDBottomAppBar class.

• Updated navigationdrawer.py

• Added on_tab_switch method that is called when switching tabs (MDTabs class)

• Added FpsMonitor class

• Added fitimage.py - feature to automatically crop a Kivy image to fit your layout

• Added animation when changing the action button position mode in MDBottomAppBar class

• Delete fanscreenmanager.py

• Bug fixes and other minor improvements.

0.102.1

See on GitHub: tag 0.102.1 | compare 0.102.0/0.102.1

pip install kivymd==0.102.1

• Implemented the ability [Backdrop](https://material.io/components/backdrop)

• Added MDApp class. Now app object should be inherited from kivymd.app.MDApp.

• Added MDRoundImageButton class.

• Added MDTooltip class.

• Added MDBanner class.

• Added hook for PyInstaller (add hookspath=[kivymd.hooks_path]).

• Added examples of spec files for building [Kitchen Sink demo](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink).

• Added some features to MDProgressLoader.

• Added feature to preview the current value of MDSlider.

• Added feature to use custom screens for dialog in MDBottomSheet class.

• Removed MDPopupScreen.

• Added [studies](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink/studies) directory for demos in Material Design.

• Bug fixes and other minor improvements.

0.102.0

See on GitHub: tag 0.102.0 | compare 0.101.8/0.102.0

pip install kivymd==0.102.0

• Moved kivymd.behaviors to kivymd.uix.behaviors.

• Updated [Iconic font](https://github.com/Templarian/MaterialDesign-Webfont) (v4.5.95).

• Added blank icon to icon_definitions.

• Bug fixes and other minor improvements.

0.101.8

See on GitHub: tag 0.101.8 | compare 0.101.7/0.101.8

pip install https://github.com/kivymd/KivyMD/archive/0.101.8.zip

• Added uix and behaviors folder to package_data.

0.101.7

See on GitHub: tag 0.101.7 | compare 0.101.6/0.101.7

pip install https://github.com/kivymd/KivyMD/archive/0.101.7.zip

• Fixed colors and position of the buttons in the Buttons demo screen ([Kitchen Sink demo](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink)).

• Displaying percent of loading kv-files ([Kitchen Sink demo](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink)).

0.101.6

See on GitHub: tag 0.101.6 | compare 0.101.5/0.101.6

pip install https://github.com/kivymd/KivyMD/archive/0.101.6.zip

• Fixed NameError: name ‘MDThemePicker’ is not defined.

0.101.5

See on GitHub: tag 0.101.5 | compare 0.101.4/0.101.5

pip install https://github.com/kivymd/KivyMD/archive/0.101.5.zip

• Added feature to see source code of current example ([Kitchen Sink demo](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink)).

• Added names of authors of this fork ([Kitchen Sink demo](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink)).

• Bug fixes and other minor improvements.

0.101.4

See on GitHub: tag 0.101.4 | compare 0.101.3/0.101.4

pip install https://github.com/kivymd/KivyMD/archive/0.101.4.zip

• Bug fixes and other minor improvements.

0.101.3

See on GitHub: tag 0.101.3 | compare 0.101.2/0.101.3

pip install https://github.com/kivymd/KivyMD/archive/0.101.3.zip

• Bug fixes and other minor improvements.

0.101.2

See on GitHub: tag 0.101.2 | compare 0.101.1/0.101.2

pip install https://github.com/kivymd/KivyMD/archive/0.101.2.zip

• Bug fixes and other minor improvements.

0.101.1

See on GitHub: tag 0.101.1 | compare 0.101.0/0.101.1

pip install https://github.com/kivymd/KivyMD/archive/0.101.1.zip

• Bug fixes and other minor improvements.

0.101.0

See on GitHub: tag 0.101.0 | compare 0.100.2/0.101.0

pip install https://github.com/kivymd/KivyMD/archive/0.101.0.zip

• Added MDContextMenu class.

• Added MDExpansionPanel class.

• Removed MDAccordion and MDAccordionListItem. Use MDExpansionPanel instead.

• Added HoverBehavior class by [Olivier POYEN](https://gist.github.com/opqopq/15c707dc4cffc2b6455f).

• Added markup support for buttons.

• Added duration property to Toast.

• Added TextInput’s events and properties to MDTextFieldRound.

• Added feature to resize text field

• Added color property to MDSeparator class

• Added [tool](https://github.com/kivymd/KivyMD/blob/master/kivymd/tools/update_icons.py) for updating [Iconic font](https://github.com/Templarian/MaterialDesign-Webfont).

• Updated [Iconic font](https://github.com/Templarian/MaterialDesign-Webfont) (v4.3.95).

• Added new examples for [Kitchen Sink demo](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink).

• Bug fixes and other minor improvements.

0.100.2

See on GitHub: tag 0.100.2 | compare 0.100.1/0.100.2

pip install https://github.com/kivymd/KivyMD/archive/0.100.2.zip

• [Black](https://github.com/psf/black) formatting.

0.100.1

See on GitHub: tag 0.100.1 | compare 0.100.0/0.100.1

pip install https://github.com/kivymd/KivyMD/archive/0.100.1.zip

• MDUserAnimationCard uses Image instead of AsyncImage.

0.100.0

See on GitHub: tag 0.100.0 | compare 0.99.99/0.100.0

pip install https://github.com/kivymd/KivyMD/archive/0.100.0.zip

• Added feature to change color for MDStackFloatingButtons.

0.99.99.01

See on GitHub: tag 0.99.99.01 | compare 0.99.98/0.99.99.01

pip install https://github.com/kivymd/KivyMD/archive/0.99.99.01.zip

• Fixed MDNavigationDrawer.use_logo.

0.99.99

See on GitHub: tag 0.99.99 | compare 0.99.99.01/0.99.99

pip install https://github.com/kivymd/KivyMD/archive/0.99.99.zip

• Added icon_color property for NavigationDrawerIconButton.

0.99.98

See on GitHub: tag 0.99.98 | compare 0.99.97/0.99.98

pip install https://github.com/kivymd/KivyMD/archive/0.99.98.zip

• Added MDFillRoundFlatIconButton class.

0.99.97

See on GitHub: tag 0.99.97 | compare 0.99.96/0.99.97

pip install https://github.com/kivymd/KivyMD/archive/0.99.97.zip

• Fixed Spinner animation.

0.99.96

See on GitHub: tag 0.99.96 | compare 0.99.95/0.99.96

pip install https://github.com/kivymd/KivyMD/archive/0.99.96.zip

• Added asynckivy module by [Nattōsai Mitō](https://github.com/gottadiveintopython/asynckivy).

0.99.95

See on GitHub: tag 0.99.95 | compare 0.99.94/0.99.95

pip install https://github.com/kivymd/KivyMD/archive/0.99.95.zip

• Added function to create a round image in kivymd/utils/cropimage.py module.

• Added MDCustomRoundIconButton class.

• Added demo application [Account Page](https://www.youtube.com/watch?v=dfUOwqtYoYg) for [Kitchen Sink demo](https://github.com/kivymd/KivyMD/tree/master/demos/kitchen_sink).

0.99.94

See on GitHub: tag 0.99.94 | compare 0.99.93/0.99.94

pip install https://github.com/kivymd/KivyMD/archive/0.99.94.zip

• Added _no_ripple_effect property to BaseListItem class.

• Added check to use ripple effect in RectangularRippleBehavior class.

• [Disabled](https://www.youtube.com/watch?v=P_9oSx0Pz_U) using ripple effect in MDAccordionListItem class.

0.99.93

See on GitHub: tag 0.99.93 | compare 0.99.92/0.99.93

pip install https://github.com/kivymd/KivyMD/archive/0.99.93.zip

• Updated [Iconic font](https://github.com/Templarian/MaterialDesign-Webfont) (v3.6.95).

0.99.92

See on GitHub: tag 0.99.92 | compare 0.99.91/0.99.92

pip install https://github.com/kivymd/KivyMD/archive/0.99.92.zip

• Removed automatic change of text field length in MDTextFieldRound class.