This document describes basic functions you can perform in the page editor and its modes. For details on what pages are for and what kind of widgets can be placed on them, see Pages.
2 Performing Basic Functions
You can perform the following basic function when working in the page editor:
- Open a page
- Create a page
- Delete a page
- Add elements on a page
- View element properties
- Arrange elements on a page
2.1 Opening a Page
To open a page in Studio Pro, do the following:
In the Project Explorer, open a module where this page is located.
Navigate to the page’s location inside the module. A page can be listed as an individual element or be included in the Pages folder:
Select a page you want to open and double-click it.
The selected page is opened.
2.2 Creating a Page
To create a new page, do the following:
In the Project Explorer, right-click the module or a folder you want to create a page in and select Add page:
In the Create Page dialog box, fill in the Page name and select a Navigation layout.
A new page is created.
2.3 Deleting a Page
To delete a page, do the following:
- In the Project Explorer, select a page you would like to delete and right-click it.
- In the displayed list, select Delete and confirm your choice by clicking Delete in the pop-up dialog.
The selected page is deleted.
2.4 Adding Elements on a Page
The way you can add an element on a page depends on a mode you are editing your page in. For more information on modes, see the Page Editor Modes section.
In Structure mode, there are several ways to add an element on a page:
Through the Toolbox:
Open the Toolbox and select Widgets or Building blocks tab there.
Select an element you would like to add and drag and drop this element on your page.
Through the menu at the top of the page:
Do one of the following:
i. Select frequently-used widgets (a data view, a data grid, a template grid, or a list view).
ii. Click Add widget or Add building block, find an element in a list and click Select.
Click a drop-zone on a page to position an element.
By right-clicking a drop-zone:
a. Right-click a drop-zone you want to insert an element in.
b. Select between adding a widget or a building block.
c. Select an element you would like to add and confirm your choice by clicking Select.
In Design mode, you can add elements though the Toolbox. Do the following:
- Open the Toolbox and select Widgets or Building blocks tab there.
- Select an element you would like to add and drag and drop this element on your page.
2.5 Viewing Element Properties
To view properties of an element, do one of the following:
- Select an element and open Properties pane to view its properties.
- Right-click an element and select Properties from the list of options that opens.
- Double-click an element.
2.6 Arranging Elements on a Page
To cut/copy/paste you can use the following shortcuts:
- Ctrl + Z / Ctrl + C / Ctrl + V
- Cmd + Z / Cmd + C / Cmd + V
You can cut/copy/paste elements on a page to different apps in Studio Pro if they have the same Mendix version. However, you cannot cut/copy/paste the whole page.
You cannot cut/copy/paste from Studio Pro to Studio.
To delete an element from a page, select this element and press Delete or right-click an element and select Delete in a drop-down menu.
3 Page Editor Modes
There are two different ways to edit your page:
- Structure Mode, the default editor which clearly shows the relationship between page elements, together with additional information about each element
- Design Mode, a WYSIWYG (What You See Is What You Get) editor which better reflects what the page will look like when it is published
You can switch to the WYSIWYG editor from the default editor by clicking the Design mode button in the page editor. You can return to the structural editor by clicking Structure mode.
Both modes allow you to edit your page by doing the following:
- Dragging widgets from the Toolbox pane onto the page
- Dragging widgets, and their contents, from one place on the page to another
- Viewing and editing properties of each widget in the Properties pane
- Opening a Properties dialog box from the menu you get when you right-click the widget
3.1 Structure Mode
In Structure mode, the page widgets are laid out so that it is easy to see the logical relationship between them. It has the following features which are not available in Design mode:
Widgets are shown with additional information easily visible – for example, data sources for data views and the width assigned to columns
Each widget has a drop-zone before/above and after/below it – this makes it easier to place widgets correctly when they appear close together in Design mode
Right-click a drop-zone allows you to insert a widget into it
There is a menu at the top of the page of data widgets – these cannot be dragged, but are positioned by clicking a drop-zone after selecting the widget
Widgets are shown without styling applied to them, but you can see which widgets do have styling applied via the class or style property by clicking the Show styles button.
3.2 Design Mode
In Design mode, the page is laid out as it will appear when published so that it is easy to see the spatial relationship between the elements.
For example, the example page shown in Structure Mode, above, will look like this in Design mode for a tablet:
It has the following features which are not available in Structure mode:
- The widgets are shown as they will be on the page – for example two text widgets which are laid out vertically in structural mode may actually be laid out horizontally when the app is published, and this will be reflected in Design mode
The page layout can be seen for different device modes – for example phone or browser by clicking the appropriate device mode button:
The widgets have design properties and CSS classes and styles applied to them so you can see what they will look like
Toggle showing conditionally-visible widgets in the top bar: