Repository navigation
Vaadin Flow Components V24.8.0.beta1
Pre-releaseVaadin Flow Components 24.8.0.beta1
This is a release of the Java integration for Vaadin Components to be used from the Java server side with Vaadin Flow.
New Features
-
Master Details Layout
Issue · Documentation
This release introduces a new layout component for building responsive master-detail UIs, such as list-detail views. The component supports horizontal and vertical orientations, with configurable sizing and containment to adapt to a variety of layout requirements.You can define an overlay breakpoint to switch between inline and overlay detail views and toggle between Stack and standard display modes for fine-tuned responsiveness.
The layout is designed to integrate with Flow and Hilla routing, enabling detail state management directly via the URL, supporting deep linking and improved navigation control.
Example of usage:
MasterDetailLayout layout = new MasterDetailLayout(); layout.setMaster(...); ...addValueChangeListener(event -> { if (event.getValue() != null) { layout.setDetail(...); } else { layout.setDetail(null); } });
Warning
This is a preview feature and is subject to change in future versions.
-
Markdown Support
Markdown issue · Message List issue · Markdown documentation · Message List documentation
A new Markdown component has been added to render Markdown content as HTML. This component is designed for seamless integration and provides safe, flexible content rendering.Example of usage:
String markdownText = ...; Markdown markdown = new Markdown(markdownText); add(markdown);
Additionally, the Message List component now supports Markdown rendering, enabling richer message formatting:
MessageList list = new MessageList(); list.setItems(..., new MessageListItem( """ ## Markdown """, "User")); list.setMarkdown(true);
All rendered content is sanitized by default to prevent XSS vulnerabilities, ensuring secure handling of user-generated input.
-
New Form Layout Model
Issue · Documentation
A new auto-responsive layout model has been introduced for form design, leveraging CSS Grid for native responsiveness. Instead of usingresponsiveSteps, layout behavior is now driven by columns and explicit field grouping, offering more predictable and flexible control.Key improvements include:
- Single-column layout by default, with multi-column rendering achieved by grouping fields into rows.
- Support for optional column and field expansion to optimize layout usage.
- Cleaner, more intuitive syntax in both Java and HTML templates for easier implementation and maintenance.
Example of usage:
FormLayout formLayout = new FormLayout(); formLayout.setAutoResponsive(true); formLayout.setColumnWidth("8em"); formLayout.setExpandColumns(true); formLayout.setExpandFields(true); formLayout.addFormRow(field1, field2); formLayout.addFormRow(field3);
-
Map Polygon Support
Issue · Documentation
The map component now supports Polygon features, enabling the highlighting of areas such as zones or regions.Key capabilities:
- Support for holes within polygons using multiple linear rings.
- Reuses familiar Marker feature behaviors, including:
- Text labels
- Click events
- Other interactive features
- Label rendering is limited based on zoom level
Example of usage
PolygonFeature polygon = new PolygonFeature(List.of( new Coordinate(...), ... )); map.getFeatureLayer().addFeature(polygon); PolygonFeature polygonWithHole = new PolygonFeature(); polygonWithHole.setCoordinates(new Coordinate[][]{ new Coordinate[]{ new Coordinate(...), ... }, ... }); map.getFeatureLayer().addFeature(polygonWithHole);
Noteworthy
-
Card
DocumentationThe feature flag has been removed and the Card component is stable starting from the 24.8 version.
Example of usage:
Card card = new Card(); card.setTitle(...); card.add(...); card.setMaxWidth(...);
-
Dashboard Updates
Documentation- Introduced a new
rootHeadingLevelAPI to improve accessible title structure. - Added elevated, flat, and shaded style variants for widgets.
- Widget titles now support text wrapping.
- New styling properties for padding and title behavior.
- Visual style updated to align with the Card component.
- Renamed CSS variables from
item-*towidget-*for consistency. - Removed the feature flag; dashboard updates are now stable as of version 24.8.
- Introduced a new
-
Date Time Picker validation updates
Issue- Replaced
validatedevent withunparsable-changefor more consistent feedback. - Validation now triggers on Enter key, blur, and outside clicks.
- Avoids redundant validation cycles to improve performance.
- Postpones validation during date/time picker navigation to enhance user experience.
- Adds error messages for incomplete input.
- Enforces min/max limits early in the input process.
- Replaced
-
Message List
-
Spreadsheet
-
Menu Bar
- Improvements to
MenuBarElementand introduce ofMenuBarItemElement. PR (#7435)
- Improvements to
Changes in Flow Components from 24.8.0.alpha8
Changes in All Components
- Chore:
- ⧉ Increase Web-Component version
Changes in vaadin-context-menu-flow
-
New Features:
-
Fixes:
- ⧉ Add missing import
Changes in vaadin-grid-flow
Changes in vaadin-spreadsheet-flow
- Breaking Changes:
Compatibility
- This release use Web Components listed in Vaadin Platform 24.8.0.beta1
- Tested with Vaadin Flow version 24.8.0.beta1