What Is New in PrimeFaces 15.0
PrimeFaces 15.0 delivers a significant update focused on modernizing the UI and enhancing developer experience. This release aligns the framework with the latest web standards and introduces new components.
| Category | Summary |
|---|---|
| New Features | Introduction of the new Badge and Knob components, plus a modernized FileUpload. |
| Improvements | Major upgrade to PrimeIcons 6.0.0 and a full port of all components to the new Theme API. |
| Bug Fixes | Resolution of various issues across multiple components for improved stability. |
| Deprecated | Legacy ThemeRoller CSS and related components are now deprecated. |
What new components were added?
PrimeFaces 15.0 introduces two new components to extend your UI toolkit. The p:badge component displays labels, status indicators, or notification counts. The p:knob component is a dial input for selecting numeric values with a circular slider.
In practice, the new FileUpload is a major win. It's been completely rewritten to use the modern native HTML5 API, ditching the legacy iframe-based approach. This makes it more reliable and consistent across browsers.
How was the icon system improved?
The entire icon library was upgraded to PrimeIcons 6.0.0. This matters because it adds over 250 new icons, giving you a much larger set of modern glyphs to work with in your applications.
All component documentation has been updated to reflect these new icons. You can now use a wider variety of icon names directly in attributes like icon without any extra configuration.
What is the new Theme API?
Every single component has been ported to the new Theme API, which is a core structural change. This API provides a unified way to theme components, moving away from the old ThemeRoller method.
Because of this port, the legacy ThemeRoller CSS and components like p:theme and p:themeSwitcher are now deprecated. You should start planning to migrate your themes to the new system.
Were there any breaking changes?
Yes, the minimum requirement for Java is now JDK 11. This aligns the framework with the current long-term support release of Java and allows the use of newer language features.
For most developers, this won't be an issue if you're already on a modern JDK. However, if you're stuck on JDK 8, you'll need to upgrade your environment before using PrimeFaces 15.0.
FAQ
Is the old iframe-based FileUpload still available?
No, it has been completely removed and replaced with the new native HTML5 implementation. The component's client-side API remains similar, but the underlying technology is now modern and more reliable.
Can I still use my old ThemeRoller themes?
While the old themes are deprecated, they will still work in 15.0. However, you should begin migrating to the new Theme API, as support for the old system will be removed in a future release.
What is the benefit of the new Badge component?
It provides a standardized way to display notifications, statuses, and labels. Before this, you had to style a generic tag manually; now it's a first-class component with built-in themes.
Do I need to update my code for the PrimeIcons upgrade?
Only if you were using icon names that have been changed or removed in version 6.0.0. Most existing icon names remain the same, so your code should continue to work without modification.
Why was JDK 11 set as the minimum requirement?
It allows the PrimeFaces team to utilize modern Java features and ensures the framework is built on a platform with long-term support, improving maintainability and performance.