Skip to content

Vaadin Flow Components V24.8.0.beta1

Pre-release
Pre-release

Choose a tag to compare

@vaadin-bot vaadin-bot released this 28 May 14:28
· 87 commits to 24.8 since this release
00aecef

Vaadin 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 using responsiveSteps, 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
    Documentation

    The 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 rootHeadingLevel API 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-* to widget-* for consistency.
    • Removed the feature flag; dashboard updates are now stable as of version 24.8.
  • Date Time Picker validation updates
    Issue

    • Replaced validated event with unparsable-change for 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.
  • Message List

    • MessageListItem#appendText API to append text to a message . Issue (#4489)
    • Add convenience constructor to MessageListItem with user name and text. Issue (#7456)
  • Spreadsheet

    • Fix keyboard navigation in custom editors. PR (#7401)
    • Custom editor visible by default with API to revert previous behavior. PR (#7435)
  • Menu Bar

    • Improvements to MenuBarElement and introduce of MenuBarItemElement. PR (#7435)

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:

    • ⧉ Introduce addSeparatorAtIndex to provide an alternative

    • ⧉ Introduce addcomponent as add alternative

      ---------

  • Fixes:

    • ⧉ Add missing import

Changes in vaadin-grid-flow

  • Fixes:
    • ⧉ Set empty header until header component is visible (#7517). PR:7526

Changes in vaadin-spreadsheet-flow

  • Breaking Changes:
    • ⧉ Show custom editors by default (#7435). PR:7532. Ticket:6529

      Changes the behavior to always show custom editors in cells and adds a new API to change opt-out and restore the previous behavior where custom cells would only be visible when the cell where they are defined is selected.

Compatibility