Layout Designer

Top  Previous  Next

 

The record layout designer allows you to create a HTML template with placeholders for dataset fields.  This way you can create you own custom layouts for your records.

 

Key Concepts

Custom layouts apply only to record display pages these include the Data (List) Page, and the More Page (record view).  Other form pages do not use custom layouts.

 

The layout designer is simply dbQwikSite's HTML editor with one additional button available in the QwikSite tab which allows you to link to fields in your dataset, so you can place them in your design.

btn_Layout_Field_001

 

Record layout template are reusable.  You may design a layout with your existing recordset, but also use this same template with another project or page group.  When you apply a template to a data page, you go through a process of mapping template field placeholders to

 

To access the Layout Designer:

 

1.Select the Data or More page you wish to work with.
2.Click the Layout btn_Layout_001 button on the main toolbar
3.You will be presented with the Layout Dialog.

 

dlg_Layout_001

4.Choose the Catalog Tab.
5.From here you can work with record layout templates.
6.You can select an existing template to apply to your page.  You can edit existing templates and you can create new templates.
7.If you select Edit or New you will open the Layout Designer.

 

 

Creating Record Layouts

 

You create record layouts using dbQwikSite's HTML Editor.  There is a special tools tab "Link to QwikSite" which allows you to access the fields of your page dataset and place them as placeholders in your layout design.

 

To insert a field placeholder into your design, place the cursor where you want to insert the field and click the Insert data field button (shown below).  You will presented with a dialog allowing you to pick a field from your data set to place into your record layout.  dbQwikSite will insert a special tag as the placeholder for your field.

 

There are two types of placeholders available:

1.Item Value place holder: this will display the data value of the mapped data item.  For example if the placeholder was for your PRICE field, it would display 99.95 (the actual price of from your record.
2.Name Place holder:  this will display the corresponding page item name rather than the data value, so in our above example, the word "Price" would appear in place a the Name placeholder.

 

dlg_Layout_Editor_001

 

Key Points to Remember

 

Remember that:

Your record layout is for ONE data record you do not have to design tables of records, and in fact, doing so will produce some very stange results.
Record layouts are reusable, so this is why you don't actually layout field names in the placeholder. you are simply telling dbQwikSite "This is where to put the value of the First field I map, and here is where to put the second field value... and so on."
When applying record templates to a page, you have to map your placeholders to your data fields.  dbQwikSite will try to map based on the field name, but if it cannot locate the designed name, you will need to map the field manually.  This is done in the page items properties dialog.  Where you can select the appropriate data field for each placeholder.