All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres
to Semantic Versioning.
(Date format is dd-MM-yyyy)
- Added for new features.
- Changed for changes in existing functionality.
- Deprecated for soon-to-be removed features.
- Removed for now removed features.
- Fixed for any bug fixes.
- Update Gradle and some dependencies
- Import build scripts from the
rewritebranch - Improved notification systems thanks to @infinite-dev22 (PR#325)
- Backport and replace the Theming API from the
rewritebranch, performance now should be vastly better - Explicitly add MFXCore and MFXResources as dependencies to always use their latest version
- Fixed MFXSimpleTreeCell still using old MFXResources for the arrow icon. It is now set in CSS
- Fixed how FilterBeans produce Predicates, leading to the wrong filter being built
- Fixed exceptions being thrown when changing the MFXFilterPane's skin, due to a listener not being disposed
- Fixed MFXScrollPane not changing the track and thumb colors because the respective color tokens in CSS were changed
- Make some dependencies transitive
- Migrate to the newest version of VirtualizedFX that also brings the latest versions of MFXCore and MFXResources. This fixes issues at compile time caused by the MFXCore being renamed in the module-info to "mfx.core" and at runtime caused by conflicts between the old resources and the new ones. Note though that even if VirtualizedFX has been updated it still uses the old VirtualFlow implementation, switching to the new would be way too much work, and it would not be worth it, better wait for the rewrite to be over
- Fixed in owner centering for stage dialogs, fixes kindly provided by Stefano Fornari (Thanks!)
- SizeBean: override toString() methods
- Improved When, OnChanged and OnInvalidated constructs by importing them from the latest version of MFXCore
- Implemented API for MaterialFX styleable controls and SceneBuilder support
- Added utility to detect SceneBuilder at runtime
- Ditch the user agent stylesheet system in favor of a new theming API
- MFXIconWrapper: improve layout algorithm for automatic size detection. Do not set size until the Scene is inside a Window as this could lead to wrong icon sizes. Also use snapped sizes
- MFXComboBox, MFXComboBoxSkin, MFXFilterComboBoxSkin: improvement for issue #243, allow to easily dimension the combo popup by setting the number of rows to show in the list
- MFXFilterComboBoxSkin: do not create a new instance of SimpleVirtualFlow, use the one in the superclass instead
- Renamed GenericAddRemoveChange to NonIterableChange as it was causing compilation issues from time to time
- Imported CSSFragment from MaterialFX rewrite branch
- Upgraded JavaFX to version 19.0.2
- Upgraded Ikonli to version 12.3.1
- Upgraded JUnit to version 5.9.1
- Improvement for issue #235
- MFXPopup is not set to fix its position automatically, this fixes issue #188
- Improvement for issue #245, allow dialogs to wrap a user given node in a scroll pane
- Fix exception due to incorrect Font resource description in info dialogs
- Fix for issue #292, the stage dialog was being created the wrong way
- Fixed some I18N issues
- Fixed some issues for MFXTextField based controls
This minor version includes a bunch of kindly submitted PRs and some minor refactor. Also, Gradle has been updated to version 7.6 PRs such as:
- Fix for memory leak caused by When construct, #210
- Fix for combobox list view not using combo's cell factory
- Fix for FilterPaneSkin's combo boxes not having correct styles
- Add BigDecimal filter
- Add czech and spanish languages
Many thanks to @stefanofornari for its donation and contributions to the project!
- MFXCSSBridge: do not take into account the Region's user agent stylesheet. If it's needed to specify the user agent the popup's getUserAgentStylesheet() method should be overridden inline, as well as for any other component that mey require it (see MFXComboBoxSkin as an example) (Fix for #173)
- Adds a method to retrieve the selection values as a List (rather than getSelection().values() which returns a generic Collection). Also make MultipleSelectionManager use LinkedHashSet and LinkedHashMap (TreeMap was used, oversight sorry) to keep insertion order for selection, this also ensures that building the values List returns the selected values in the same exact order as in the selection Map (Enhancement for #161)
- MFXTextField: fixed TextFormatter not working. It must be added on the BoundTextField, for this reason, added a delegate property (Fix for #174)
- MFXComboBoxSkin, MFXFilterComboBoxSkin: fixed an issue that prevented the combo box's popup from being fully customizable with CSS (Fix for #173)
- MFXDatePickerSkin: initialize the picker's text if the initial date is not null (Fix for #172)
- Fixed Maven POM
- Fixed MFXTextField bug which was causing improper text fill in specific occasions
- MFXTextField: added a label to specify the unit of measure (optional, leave blank string to remove)
- Update Gradle plugins
- Update VirtualizedFX to 11.2.5
- Improve ROADMAP
- New control MFXMagnifierPane
- ColorUtils: added some new methods to convert Colors to Strings
- FunctionalStringConverter: added two new convenience methods
- New utils class SwingFXUtils (copied from javafx.embed.swing)
- Added fluent API builders for MaterialFX components and JavaFX Panes, as requested by #78
- Added resource bundles and API for internationalization
- Added new control, MFXSpinner
- ColorUtils: changed some method to be null-safe
- MFXFilterPaneSkin: properly compute the minimum width
- MFXTableViewSkin: allow to drag the filter dialog
- MFXIconWrapper: added handler to acquire focus
- MFXComboBoxSkin: ensure the caret position is at 0 if the combo box is not selectable
- MFXTableViewSkin: ensure the dialog is on foreground
- MFXTextField and all subclasses: fixed an issue with CSS and :focused PseudoClass. It was being ignored in some cases, probably because the inner TextField was stealing the focus to the actual control. To fix this we use a new PseudoClass ":focus-within" to specify that the inner field is focused, so the control should be considered focused as well
- I18N: do not use URLClassLoader to load the ResourceBundles as using MaterialFX is other projects would lead to a MissingResourceException, instead change the bundle base name returned by getBundleBaseName() with the complete path to the bundles
- BoundTextField: remove text formatter binding as it was causing an exception, also it works anyway, so it was unnecessary
- MFXIconWrapper: fix NullPointerException when creating an empty wrapper
- ListChangeProcessor: fix computeRemoval() method returning negative indexes
- ListChangeProcessor: fix findShift() method by including the given index in the count too
This version won't follow the above scheme as the amount of changes and commits is simply too huge and there would be no way to correctly show all the changes without making mistakes (duplicates, "overlapping" changes...), for this reason I'll try to sum up only the major changes below.
- The demo has been completely remade
- Added new beans and properties
- Added new mechanisms for bindings
- Added new collections, in particular an ObservableList that combines the capabilities of JavaFX's FilteredList and SortedList. Also those two are read-only, but MaterialFX also offers a version that allows to directly make changes to the source list
- ReactFX, Flowless removed in favor of my own Virtual Flow implementation, VirtualizedFX. As a result all controls having lists have been reworked.
- The table view has been reworked as well to use a Virtual Flow (scrollable) so it's efficiency is now on a whole new level. There's also a paginated version of the table (like before) but it still uses a Virtual Flow, which of course makes it efficient
- MFXLabels have been deprecated and removed as now MaterialFX follows Material Design's text fields. The new MFXTextFields are the best thing you're gonna see on JavaFX. They have all the features defined by Material Design principles and also more. They now offer a floating label that can have 4 states: disabled, above, border, inline. Oh, they can also be set to behave like Labels, no need to have duplicate controls (Label and TextFields), since they offer the same functionalities duh.
- Many controls (such as combo boxes, date pickers) now extends MFXTextField, so they inherit all its features.
- Almost all controls have been reviewed/remade to make them fully functional (there were a lot of issues with CSS not working properly).
- The Filter API has been reviewed and now it's more powerful than ever with the new MFXFilterPane.
- The Validation API has been reviewed as well, it is as powerful as before thanks to JavaFX properties and observables, but it's much more flexible. It's up to the user now to decide when and how to validate a control. Also an important design choice has been made here. Many validation frameworks for JavaFX also offer a way to decorate a control, but I decided to not to that as it would violate the Single Responsibility Principle! Validation has nothing to do with UI, plus depending on the fanciness of your App it's up to you to decide how the validation controls will look like!
- Dialogs and Notifications have been reviewed as well. The dialogs have been simplified, and for notifications there are now two separate systems.
- The date picker is now on a whole new level, it's been remade from scratch and it's simply beautiful, powerful and versatile.
- There are also new components! MFXPopup is a PopupControl that actually works. Ever tried to style a PopupControl but no matter what the CSS would not work? Do not worry about that never again, just use MFXPopup it's super easy thanks to my custom MFXCSSBridge (check documentation would be too much to write here haha). MFXPagination has been made for MFXPaginatedTableViews, remade from scratch (meaning that doesn't extend Pagination) with a stunning modern look. MFXTooltip, an alternative to JavaFX's tooltip, much more versatile!
- MFXRippleGenerator has been deprecated. The ripple generation is organized to be a new API, meaning that there are now interfaces and a base abstract class from which you can implement new ripple generators. The new default implementation is MFXCircleRippleGenerator. The new API also allows you to create new Ripples by implementing the IRipple interface. It's a rather advanced API tbh, but hey, it's there, who knows maybe someday I'll need it to be like this.
- MFXHLoader and MFXVLoader are no more. The loading API has been "extracted" to be independent from UI. MFXLoader has the same capabilities as the aforementioned controls but it's not a Node. It's up to the user to decide how to manage the loaded views, and how to translate the loaded beans to a Node. (see the documentation and the DemoController for an example on how to easily create a nav-bar even with the new API)
- The Selection API has been reviewed as well. It also supports the "extend selection" behavior when "Shift" is pressed, like you would expect from a file manager.
- There is an insane amount of new utilities, for JavaFX as well as for Java
Again, let me apologize for this messy changelist, but I promise from next version changes will be tracked properly!