What Is New in PrimeFaces 13.0
| Category | Key Highlights |
|---|---|
| New Features | New components: Dock, Terminal, and Signature. New themes: Vela and Freya. |
| Improvements | Migrated to Jakarta EE 10, upgraded to jQuery 3.6, and enhanced accessibility. |
| Deprecations | Legacy themes (after-touch, afterdark, etc.) and barcode component are deprecated. |
| Bug Fixes | Numerous fixes across components like DataTable, Charts, and FileUpload. |
What are the new components in PrimeFaces 13.0?
PrimeFaces 13.0 introduces three brand-new components. The Dock is a navigation component resembling macOS, while the Terminal offers a command-line interface experience. The Signature component allows for capturing smooth, vector-based user signatures directly in the browser.
In practice, the Dock is great for building modern application launchers. The Terminal can be useful for admin panels where you need to simulate command execution.
How does the theme update improve my project?
This release adds two new themes, Vela and Freya, which are part of the modern PrimeOne Design 2022 suite. More importantly, the legacy themes (after-touch, afterdark, afterwork, aristocracy, and black-tie) are now deprecated and scheduled for removal in a future major version.
This matters because it signals a move towards a more modern and maintainable design system. You should start planning to migrate any applications still using the old themes to the newer ones like Saga or the new Vela/Freya.
What is the significance of the Jakarta EE 10 migration?
The core change in this release is the full migration from Java EE to Jakarta EE 10. This means all namespace references have been updated from javax.faces to jakarta.faces.
If you're upgrading an existing application, you must ensure your environment also runs on a Jakarta EE 10 compatible server and that all your dependencies are aligned. This is a necessary step for staying current with the Java ecosystem.
Were there any key dependency upgrades?
Yes, jQuery has been upgraded from version 3.5.1 to 3.6.0. This upgrade brings various bug fixes and minor improvements from the jQuery library itself.
For most developers, this is a transparent change, but it's good to be aware of it in case you have any custom jQuery plugins or scripts that might interact with the version.
FAQ
Is PrimeFaces 13.0 backwards compatible with Java EE 8?
No. The migration to Jakarta EE 10 means it requires a Jakarta EE 10 compatible environment. You cannot run it on older Java EE 8 servers.
I use a deprecated theme. What should I do?
Start planning a theme migration to a supported one like Saga, Vela, or Freya. The deprecated themes will be removed in a future major release, likely PrimeFaces 14.0.
What happened to the Barcode component?
The Barcode component is now deprecated in favor of the more modern and flexible QRCoder component for generating QR codes.
Does the FileUpload component have any new features?
While not a new feature, a significant bug was fixed where the native HTML5 uploader was not respecting the fileLimit setting, which is a crucial fix for many use cases.
Where can I find a detailed list of all changes?
The complete migration guide, including all breaking changes and detailed instructions, is available on GitHub at the PrimeFaces repository.