It’s good to keep your designs focused on one thing. When there are too many focus areas in one view, splitting them into smaller parts helps to keep things clear. You’ll create the form in its own design with a Form Layout for editing the information of a single contact in it.
In the Project tree, right click the
frontend/src/viewsfolder and select New > Vaadin 10+ Design.
In the Name field, type
Make sure that
the Create Java companion file checkbox is checked.
the Java package is
Click OK to generate the files.
The design opens in the IDE.
In the palette, search for "form" and drag
vaadin-form-layoutonto the drop section in the paper.
Your form component has two text fields for the first and last name, an email field, and two select fields: one to select the company; another to select the contact status.
To add two text fields for name, first find Vaadin Text Field in the palette and drag it twice onto
vaadin-form-layout. Then select the first
vaadin-text-field in the design.
In the properties view, go to the attributes panel. Find the label attribute and replace the text with "First name". Find the placeholder attribute and remove the value.
Next, select the second
vaadin-text-field in the design. In the properties view, go to the attributes panel. Find the label attribute and replace the text with "Last name". Find the placeholder attribute and remove the value.
If your paper is wide, the text fields line up horizontally. You can drag the left and right paper edges to make it narrower. This makes the form fields stack vertically. This behavior comes from
vaadin-form-layout by default, which arranges its fields into one or two columns depending on the width.
To add the email field, find in the palette
vaadin-email-field and drag it onto the
vaadin-form-layout. In the properties view, go to the attributes panel. Find the label attribute and type in "Email".
To add company and status fields, find in the palette
vaadin-combo-box and drag it onto the
vaadin-form-layout twice. Then select the first
vaadin-combo-box in the design.
In the properties view, go to the attributes panel. Find the label attribute and add the value "Company". Select the second
vaadin-combo-box in the design. In the properties view, go to the attributes panel. Find the label attribute and add the value "Status".
You need to add save, delete and close buttons to the form. Save is the primary action and should be highlighted. Delete can be a dangerous action and should be marked as an error. Close isn’t an important action and can be downplayed with a tertiary styling.
To do this, find in the palette Horizontal layout and drag it onto the
vaadin-form-layout. In the Vaadin button section of the palette, drag the following three buttons onto the horizontal layout: Primary Button; then Primary Error Button next to it; and Tertiary Button next to that.
Next, select the Primary button and change the button text to Save. Select the Primary Error button and change the button text to Delete. In the attributes panel, change the theme attribute from primary error to error. Then select the Tertiary button and change the button text to Close.
Once you’ve done all of this, the form is done.
You can now go back to your main view and add the contact form next to the Grid. The
main-view design should already be opened, but if it isn’t, open the
main-view.ts file again in IntelliJ IDEA.
In the palette, you should now see a section called Project Components that lists all designs you have created inside the project. By dragging items from this list, you can embed other designs into the one that’s currently open.
In the palette of the
main-view design, locate contact-form in Project Components. Drag contact-form onto the second
You’ll want to give most of the space to the grid. For this, you’d use flex sizing to set a 2:1 ratio between the grid and the form.
To do this, select the
vaadin-grid. In the properties view, find the style attribute in the attributes panel and add the value "flex: 2;" at the end.
contact-form. In the properties view, find the style attribute in the attributes panel and set the value to "flex: 1;". After doing that, the layout is finished.
Proceed to the next page to run your application: Get an Application Running.