Release notes for Vaadin Designer

Vaadin Designer is available for both Vaadin Framework 7 and 8.

The latest Designer version for Framework 8 is Vaadin Designer 2.2.1

The latest Designer version for Framework 7 is Vaadin Designer 1.4.1

See the full list of releases

Please review the requirements below and the FAQ if you have problems.

Useful links

Vaadin Designer 2.x for Vaadin Framework 8

What's new in 2.2
  • Provide a way to access exported component through getter
  • Delay theme recompilation until save (IntelliJ)
What's new in 2.1

Support @PropertyId annotation for fields exported to Java companion file

  • Ability to set the PropertyId property for fields, and the value will be mapped into a @PropertyId annotation in the Java companion file

Replace layout with another layout in the outline

  • Replace with… added to context menu in the outline. Allows replacing any layout with another layout, preserving contents.

Copy size when wrapping

  • Copy size from wrapped components. For example, if you wrap a Component in a Layout, the size of the Component is copied to the Layout.

Icon preview

  • Show a preview of Vaadin Icons when editing the Icon property

Improved theme support

  • Support themes in resources folders.

Create Grid columns from bean

  • Automatically create Grid columns when item-type property is changed

Experimental embedded Chromium browser in Eclipse

  • Embedded Chromium browser can be enabled from plugin settings
What's new in 2.0

Requires Vaadin Framework 8 and Java 8. Does not support Vaadin Framework 7.

  • You can have both Designer 1 and 2 installed at the same time. Design files in Vaadin 7 project, will be opened in Designer 1.x and designs in Vaadin 8 project will be opened in Designer 2.x.
  • Generic types for selection components supported by ItemType property
  • Properties renamed to match new Vaadin 8 properties e.g. InputPrompt is now Placeholder
  • Stability improvements and bug fixes
Requirements
  • Windows 7 / OS X 10.9 / Ubuntu 14.04 LTS 1
  • Chrome / Safari / Firefox / IE 11+ 2
  • Java 8
  • Eclipse Luna SR2 (4.4.2)+, Java EE edition. Eclipse Neon 4.6 recommended 
  • JetBrains IntelliJ IDEA 15+ Community/Ultimate 
  • Vaadin 8.0+

1 In addition, libwebkitgtk 1.0 needs to be installed (libwebkitgtk 3 not sufficient).
Tested on Ubuntu 14.04 LTS, but other distributions known to work, as long as libwebkitgtk 1.0 is available for Eclipse.

2 Vaadin Designer makes use of your system browser to achieve real WYSIWYG. Note that security settings (particularly on Windows / IE) may in some instances interfere. IE8/9/10 not supported and results in designer not loading.

3 Eclipse IDE for Java EE Developers preferred. Vaadin Designer can be installed on other variants, but some update-site for dependencies might be missing. See the FAQ for more details.
Verified to work on STS 3.6.4.
Vaadin Designer can be installed on older Luna versions, but prior to SR2 there are serious bugs in Eclipse.

Limitations

Custom widgetsets and components

Custom widgetsets not used when designing. Custom (project) components and nested designs are shown as place holders when designing.

GridLayout column- and row-spanning

Limited support for GridLayout; no column- or row-spanning.

ClassResource not supported

The declarative format does not currently support ClassResource (e.g for icons and images). The supported resources are: ThemeResource (theme://), ExternalResource (http://), FileResource (file://) and (for icons only) FontIcon (fonticon://).

Using theme from separate project not supported

Using a theme from another project (e.g Maven multi-module project) is not supported.

Additional limitations for IntelliJ IDEA
  • Template filtering in the New Design wizard
  • Theme selection for imported template styles

Vaadin Designer 1.x for Vaadin Framework 7

What's new in 1.4
  • Provide a way to access exported component through getter
  • Delay theme recompilation until save (IntelliJ)
What's new in 1.3

Support @PropertyId annotation for fields exported to Java companion file

  • Ability to set the PropertyId property for fields, and the value will be mapped into a @PropertyId annotation in the Java companion file

Replace layout with another layout in the outline

  • Replace with… added to context menu in the outline. Allows replacing any layout with another layout, preserving contents.

Copy size when wrapping

  • Copy size from wrapped components. For example, if you wrap a Component in a Layout, the size of the Component is copied to the Layout.

Icon preview

  • Show a preview of FontAwesome icons when editing the Icon property

Improved theme support

  • Support themes in resources folders.
What's new in 1.2

New responsive templates available in "New Design" wizard for creating responsive application navigation and views. See more details and usage in: Designer 1.2 - Responsive templates user guide.

What's new in 1.1
  • No more static dummy content
    • The content for Grid, Table, Tree, TreeTable and MenuBar can be edited, and will appear when the application is run (unless replaced by java code).
    • Note the two important differences for 1.0 users:
      • When opening old designs, these components will appear empty
      • The pre-configured example content will actually end up in the design if you do not edit it.
    • The content can be edited in code-mode, or using the "Content"-property.
  • Improved Dark theme support
  • Improved GridLayout support
  • Copy&paste and drag&drop is now works with html snippets
  • Less external requirements (e.g JEE feature, Vaadin plug-in) = better compatibility
  • Custom content and attributes in the declarative file better preserved 
  • Properties re-ordered for better usability
  • Fixed multiple notorious error causes for "Could not retrieve controller for context path", "Failed to get component from mapper", "ConcurrentModificationException in ComponentModelMapper" and "No mapper contains the selected component".
Requirements
  • Windows 7 / OS X 10.9 / Ubuntu 14.04 LTS 1
  • Chrome / Safari / Firefox / IE 10+ 2
  • Java 7+ (Oracle Java 8 recommended)3
  • Eclipse Luna SR2 (4.4.2)+, Java EE edition 
  • JetBrains IntelliJ IDEA 15+ Community/Ultimate 
  • Vaadin 7.5+
  • Does not support Vaadin 8

1 In addition, libwebkitgtk 1.0 needs to be installed (libwebkitgtk 3 not sufficient).
Tested on Ubuntu 14.04 LTS, but other distributions known to work, as long as libwebkitgtk 1.0 is available for Eclipse.

2 Vaadin Designer makes use of your system browser to achieve real WYSIWYG. Note that security settings (particularly on Windows / IE) may in some instances interfere. IE8/9 not supported and results in designer not loading.

3 Java version used to run Eclipse - your project can still use any Java version supported by Vaadin. Refer to Eclipse documentation for more information about how to verify and change the version used by Eclipse (note that Eclipse might not use your system default).

4 Eclipse IDE for Java EE Developers preferred. Vaadin Designer can be installed on other variants, but some update-site for dependencies might be missing. See the FAQ for more details.
Verified to work on STS 3.6.4.
Vaadin Designer can be installed on older Luna versions, but prior to SR2 there were serious bugs in Eclipse.

Limitations

Custom widgetsets and components

Custom widgetsets not used when designing. Custom (project) components and nested designs are shown as place holders when designing.

GridLayout column- and row-spanning

Limited support for GridLayout; no column- or row-spanning.

ClassResource not supported

The declarative format does not currently support ClassResource (e.g for icons and images). The supported resources are: ThemeResource (theme://), ExternalResource (http://), FileResource (file://) and (for icons only) FontIcon (fonticon://).

Using theme from separate project not supported

Using a theme from another project (e.g Maven multi-module project) is not supported.

Additional limitations for IntelliJ IDEA
  • Template filtering in the New Design wizard
  • Theme selection for imported template styles

 

Releases

1.4.1 & 2.2.1

Released 2017-07-13

List of enhacements and bug fixes in issue tracker

Bug fixes:

  • Properties table sets property value to wrong component
  • Changing SplitPosition property's value causes error dialog.
  • Using a Tabsheet in a design might break the design until IntelliJ is (force)restarted 
  • Resource folder cannot be created in IntelliJ New Design Wizard 
  • Changing split position on the editor doesn't update SplitPosition property's value 

1.4.0 & 2.2.0

Released 2017-06-28

List of enhacements and bug fixes in issue tracker

Enhacements:

  • Companion file getters
  • Delay theme recompilation until save (IntelliJ)

Bug fixes:

  • Designer css classes no more visible
  • Modal Vaadin Designer license windows blocks Eclipse
  • Getting background "Timeout on Read" errors

1.3.4 & 2.1.4

Released 2017-06-13

List of enhacements and bug fixes in issue tracker

Enhacements:

  • Made opening designs in Eclipse faster
  • Create "~/.vaadin/designer/templates" if it does not exist

Bug fixes:

  • Templates in ~/.vaadin/designer/templates are not loaded
  • License dialog keeps showing with trial license

1.3.2 & 2.1.2

Released 2017-05-18

List of bug fixes and enhancement in issue tracker

Enhancement:

  • Allow unlimited offline usage with any license

Bug fixes:

  • Failed to update companion file if intellij project configuration files are inside custom folder 
  • Wrapping root component does not expand the new root
  • Project name is null in the external browser preview title in IntelliJ
  • Unable to set rows property for some components
  • Exception when inserting new design source with namespaces
  • Editor scaling issue with multi monitors configuration in macOS in IntelliJ
  • Can't scroll horizontally design in Windows
  • Missing icons for the Vaadin perspective in Eclipse
  • Designer crashing when design has empty user attributes
  • Proxy authorization header is not preserved on license check

1.3.1 & 2.1.1

Released 2017-05-04

List of bug fixes in issue tracker

  • Icon preview for property editor
  • Support themes in resource folder
  • Support SBT projects
  • Move palette mode buttons to tool window
  • Exception setting value after date field resolution was changed
  • Experimental Chromium browser for Eclipse

1.3.0 & 2.1.0

Released 2017-05-03

  • You can now set "PropertyId" in the properties panel for components, it will show up in java as @PropertyId on the field
  • You can now right-click on a layout in the outline, and choose "Replace with…" in the context menu, e.g to replace a Vertical layout with a Horizontal layout.

2.0.2

Released 2017-03-24

IntelliJ only.

List of bug fixes in issue tracker

  • Editing properties throws exception in IntelliJ 2017

2.0.1

Released 2017-03-20

List of bug fixes in issue tracker

  • Grid throws exception when item-type is not String

2.0.0

Released 2017-03-01

Vaadin Designer 2.0 for Vaadin 8. Requires Vaadin 8 and Java 8. Does not support Vaadin 7. You can have both Designer 1 and 2 installed at the same time. Design files in Vaadin 7 project, will be opened in Designer 1.x and designs in Vaadin 8 project will be opened in Designer 2.x.

2.0.0.beta3

Released 2017-02-27

Vaadin Designer 2.0 now supports the final version of Vaadin Framework 8.

2.0.0.beta2

Released 2017-02-09

Second beta version of Vaadin Designer 2.0 for Vaadin Framework 8 Beta. Contains bugfixes and improvements for working with Framework 8 projects.

2.0.0.beta1

Released 2017-01-03

First beta version of Vaadin Designer 2.0 for Vaadin Framework 8 Beta. Requires Vaadin Framework 8 and Java 8. Does not support Vaadin Framework 7. You can have both Designer 1 and 2 installed at the same time. Design files in Vaadin 7 project, will be opened in Designer 1.x and designs in Vaadin 8 project will be opened in Designer 2.x.

1.2.2

Released 2017-03-24

IntelliJ only.

List of bug fixes in issue tracker

  • Editing properties throws exception in IntelliJ 2017

1.2.1

Released 2017-02-23

List of fixed issues in the issue tracker

  • Double-click on palette now adds to components parent (#8)

1.2.0

Released 2016-12-30

New responsive templates available in "New Design" wizard for creating responsive application navigation and views. See more details and usage in: Designer 1.2 - Responsive templates user guide.

List of bug fixes in issue tracker

  • Fixed wrap With TabSheet throwing an Exception
  • Prevent dropping a component inside its own content
  • Fixed Designer failing silently when using Vaadin snapshots

1.1.2

Released 2016-12-12

List of bug fixes in issue tracker

In Eclipse and IntelliJ

  • Fix bug missing Designer's project properties (for ip/port configuration)
  • Fix bug when set margin property for Grid Layout
  • Fix unicode characters problem in editor (to display unicode characters in IDE UI e.g properties table, make sure that the font using for IDE appearance supports those characters)
  • Improve the design load performance in Windows and macOS
  • Fix the exception "Provider id not found" when closing Idea
  • Fix bug DomID property is missing in properties table

In IntelliJ only

  • Fix the palette issue in IntelliJ IC 2016.3
  • Fix bug "Write access failure" in IntelliJ IC 2016.3

1.1.1

Released 2016-11-24

List of bug fixes in issue tracker

  • Double click in Palette implemented [Intellij]
  • Use design icon for design components in Palette [Intellij]
  • Show custom component name in Outline [Intellij]
  • Fix Outline expansion and scrolling when model changes [Intellij]
  • Set default tab header link in Tabsheet

1.1.0.final

Released 2016-10-26

In Eclipse and IntelliJ

  • Fix NPE when dropping in panel child
  • Fix GridLayout unexpand child does not restore columnExpandRatio
  • Fix ColorPicker and ColorPickerArea throw exception on delete
  • Fix for Changing expandRatio does not move infobar
  • Fix session lock exception when adding GridLayout as root in Intellij
  • Lock session for error indicator removal
  • Prevent websocket from timing out
  • Fix provider not found when closing cloned editors
  • Improve prompt in error report email
  • Update client-side when palette drag is cancelled

In IntelliJ only

  • Fix double text editors when open java files
  • Fix bug cannot undo in source mode
  • Add context menu to outline
  • Prevent exceptions when closing editor during indexing
  • Update client-side when palette drag ends
  • Fix unregister provider issues
  • Improve prompt in error report email
  • Add scrollbar for content property editor
  • Fix image render off paper

1.1.0.beta3

Released 2016-10-06

In IntelliJ

  • Java companion file issues fixed
  • Settings dialog implemented
  • Custom components scanning improved
  • 3rd party browser component updated
  • Not working custom themes on Windows problem fixed
  • Designer module views misbehavior corrected
  • Numerous bug fixes which were gathered from different feedback channels

In Eclipse

  • Missing scrollbar was added to content property editor
  • User notification in case of invalid template introduced
  • DnD to panel child bug fixed
  • Bugfixes, small UX improvements

1.0.11

  • This maintenance release improves the New Design Wizard so that if you are using our new Maven archetypes which does not contain a src/main/resources folder the wizard will create one for you (if you want)!

1.0.10

1.0.9

  • #18931 GridLayout OOBE in some situations; was causing multiple problems

1.0.8

  • #19485 No more grid lines in preview mode
  • #19607 No more error messages if you mistype a source URL
  • #19762 No more vaadin-ui package mappings in design file when you mistype a Vaadin core component

1.0.7

  • #19195 Component Alignment in GridLayout doesn't work
  • #19551 Button to open external browser window does not work
  • #19614 Project name is null in the external browser preview title
  • #19666 Clicking on a link component in a design hangs editor
  • #19679 JavaScriptException in VEditorViewport.java
  • Fixed an issue opening the design when package declaration for custom component contains capital letters.

1.0.6

  • Fixed Panel replacing content when something is dropped on it
  • Fixed compilation problem in some environments due to non UTF-8 character in autogenerated code
  • Fix for "The Designer failed to load system browser"
  • Fix for multiple JavaScriptException(s) reported by users
  • Fix for "unable to set url for a Link"

1.0.5

  • Fixed a bug in opening context menu in Outline
  • Fixed designer styles not updating when a project has styles.css
  • Multiple other fixes. See the complete list of fixed defects here.

1.0.4

  • Multiple improvements to the UI look when using the Dark Eclipse theme
  • Improved drag&drop when layout has spacing turned on (#19379)
  • Fixed a rare situation when the Designer could overwrite the license file (#19373)
  • Fixed yet another case causing the context menu not to open
  • Styles from templates no longer imported multiple times (#19439)

1.0.3

  • Rulers now align properly  (#19029#19181)
  • Deleting a project with a design still open no longer causes problems (#19174#19175)
  • Updated to use Vaadin 7.5.10; previous releases could leave designs locked after reading (#19299)

1.0.2

  • It is now possible to use add-ons with themes packaged into a jar (#18951). For instance, you might have run into this issue if you use Vaadin Spreadsheet in your project.
  • The Designer no longer causes a unnecessary "com.vaadin.designer.prefs" to be added to all your projects' settings (#19196).
  • The Outline context menu now opens on Windows even if the clipboard contains binary data (#19202).
  • Two situations that could cause an exception when switching to Preview mode were identified and fixed (#19173#19279).

1.0.1

  • The companion Java file is now updated on disk when the design is saved (not while designing)
  • Adjusting viewport size no longer marks design as modified
  • Made external preview live-updating (push) more robust on slow connections/computers
  • Fixed missing/wrong texts in styling dialog
  • Rephrased confusing Vaadin version warning message
  • Fixed null pointer when invoking the top-level File->new->Vaadin Design menu item (#19165)
  • Some preferences moved from project to global scope

1.0.0

First stable release 2015.10.22

Issues

You can review closed issues in each milestone and currently open issues.