Creating a simple Guide layout

Creating a simple Guide layout is an easy way to get familiar with basic concepts, including the structure and MXML definition of a Guide layout.

Important: Try not to edit the Guide layout files that are included with LiveCycle ES2.5. Instead, make uniquely named copies of the content to help you get started creating Guide layout extensions.

Create a simple Guide layout

Start Flash Builder.
Create a Flex library project and configure it using the procedures in Creating Flex library Projects for Custom Guides . Ensure that you create the required folder structure in your Flex library project. Then, create Guide layouts in the wrappers folder. After you create the layouts, they are displayed in the list of Guide layouts in the Guide Design perspective of Workbench.
Right-click the wrappers folder and select New > MXML Component .
Type a unique filename. By default, the Guide Design perspective of Workbench adds a space immediately before each capital letter in the name of your component. For example, an MXML component named TabNav.mxml appears as Tab Nav in the Guide Design perspective of Workbench.
In the Based On list, select Wrapper .
(Optional) Set values for Width and Height .
Click Finish .

The MXML source for your new Guide layout looks like the following:

<?xml version="1.0" encoding="utf-8"?> 
<Wrapper xmlns="ga.controls.*" 
    xmlns:mx="http://www.adobe.com/2006/mxml" > 
     
</Wrapper>

Note the <Wrapper> element includes the namespace attribute xmlns="ga.controls.*" . It is considered good practice to provide namespaces when you reference objects from the Guide API. Providing namespaces reduces the amount of MXML code and makes the code more readable. Updating the MXML source for the blank panel layout, the panel layout source looks like the following:

<?xml version="1.0" encoding="utf-8"?> 
<gc:Wrapper xmlns:mx="http://www.adobe.com/2006/mxml" 
    xmlns:gc="ga.controls.*" > 
     
</gc:Wrapper>