What Is New in PrimeFaces 14.0
PrimeFaces 14.0 is a major release focused on modernization, introducing new components, significant upgrades to existing ones, and a strong push towards a more maintainable codebase. The key changes are summarized in the table below.
| Category | Key Highlights |
|---|---|
| New Features | New Signature and Dock components, CDI support for Websockets, new Chart.js exporter. |
| Improvements | Major upgrades to DataTable, TreeTable, and Diagram; new theming system; accessibility (a11y) enhancements. |
| Deprecations | Legacy Chart components, deprecated methods, and Internet Explorer support are now marked for removal. |
| Bug Fixes | Over 150 issues resolved across the component suite. |
What are the major component upgrades?
The DataTable and TreeTable components received the most significant upgrades. They now feature a refactored filtering and sorting implementation that is more robust and easier to maintain. This directly impacts performance and stability in data-heavy applications.
The Diagram component was also overhauled, moving to a new underlying library for better functionality and a more modern feature set.
Is there a new theming system?
Yes, the legacy Themes have been removed and replaced with a new theming architecture based on PrimeTheme. This new system uses CSS variables, making it significantly easier to create and manage custom themes.
In practice, this means you can now customize the look and feel of your application by simply overriding CSS variable values instead of writing complex, overriding CSS rules.
What new components were added?
Version 14.0 introduces the Signature component for capturing digital signatures and the Dock component, which creates a macOS-like application dock for navigation.
There's also a new Chart.js exporter, allowing you to export charts created with the Chart.js integration to image formats. For backend developers, the Websocket support now works with CDI, which is a much cleaner integration for modern Java EE and Jakarta EE applications.
What has been deprecated?
This release marks the end of the road for several legacy features. The old Chart components (e.g., p:chart) are now officially deprecated in favor of the more powerful Chart.js integration.
Various deprecated methods and attributes across the framework have been removed. Most notably, all remaining support and workarounds for Internet Explorer have been dropped, aligning with the modern web landscape.
FAQ
Is PrimeFaces 14.0 a breaking change?
Yes, it is a major version release. The removal of legacy themes and deprecated methods means you should thoroughly test your existing applications before upgrading. Check the release notes for a full list of breaking changes.
How do I migrate my old charts to Chart.js?
You will need to replace your existing p:chart components with the new p:chart component that uses the Chart.js API. The configuration and data binding are different, so some code changes are required.
What is the benefit of CDI Websockets?
CDI Websockets allow you to use @Inject to bring your CDI beans directly into your Websocket endpoints. This simplifies dependency management and makes your push code cleaner and more integrated with the rest of your application.
Are the new DataTable filters backwards compatible?
While the core functionality is the same, the internal implementation was refactored. For most use cases, it should work the same, but it's possible some edge-case behaviors or custom extensions might be affected.
Where can I find the new theme variables?
The new theme uses CSS variables. You can inspect the DOM or look at the PrimeTheme source to see all available variables (e.g., --primary-color). Overriding them in your own stylesheet is the recommended way to customize.