What Is New in PrimeFaces 6.2
PrimeFaces 6.2 delivers a significant set of enhancements and refinements, focusing on component upgrades, performance tuning, and bug fixes. This release strengthens the framework's core while introducing new capabilities for modern UI development. The key changes are summarized in the table below.
| Category | Key Highlights |
|---|---|
| New Features | Touch support for Galleria, new modes for SplitButton, and a locale property for Schedule. |
| Improvements | AJAX behavior events for SelectCheckboxMenu, ARIA support for SelectManyButton, and enhanced Dialog positioning. |
| Fixed Defects | Over 150 bug fixes addressing issues across various components like DataTable, TreeTable, and FileUpload. |
| Deprecations | The deprecated org.primefaces.util.Constants class has been removed. |
What new component features were added?
The Galleria component now supports touch-enabled swipe gestures, making it fully responsive for mobile devices. The SplitButton gained two new modes, "tiered" and "split," giving developers more flexibility in its visual presentation and behavior.
For the Schedule component, a new locale property was introduced. This allows for easier localization of the calendar's text directly through the component attributes, streamlining the setup for internationalized applications.
How were existing components improved?
Major improvements were made to accessibility and event handling. SelectCheckboxMenu now fires AJAX behavior events like change and toggle, enabling more dynamic page interactions. SelectManyButton received ARIA accessibility attributes to improve screen reader support.
Dialog positioning was enhanced to be more reliable, and the DataExporter was updated to handle custom UIComponents, making it more extensible. These changes are about polishing the developer experience and ensuring components work predictably.
What major bugs were squashed in this release?
This release includes a massive round of bug fixes targeting over 150 issues. Key areas addressed include filtering and selection problems in DataTable and TreeTable, duplicate ID issues with FileUpload, and various rendering glitches across multiple components.
Fixing the FileUpload duplicate ID bug was a big one for us. It was a common pain point that could break forms, so its resolution makes the component much more stable for production use. The team focused on core stability with this patch.
FAQ
Is the removal of the Constants class a breaking change?
Yes, if your code directly imported and used the deprecated org.primefaces.util.Constants class, you will need to remove those references when upgrading to 6.2. Most applications are unaffected as this was an internal class.
How do I use the new locale property on the Schedule component?
You can now set the locale directly via the locale attribute instead of only through the view locale. For example: <p:schedule locale="de" /> will display the calendar in German.
Were there any changes to the ChartJS integration?
Yes, the Chart component was updated to be compatible with Chart.js version 2.5.0. If you are using custom chart scripts, ensure they are compatible with this newer version of Chart.js.
Did this release introduce any new themes?
No, PrimeFaces 6.2 did not include any new themes. The focus was primarily on component functionality, improvements, and bug fixes rather than visual additions.
Should I expect any performance changes with this version?
Generally, yes, for the better. Many of the bug fixes, particularly around component rendering and AJAX updates, contribute to a more efficient and performant user experience by preventing unnecessary processing errors.