A page style is a JSPX page used for pages created at runtime. A page style describes the layout of a newly created page and may also dictate the type of content that the page supports.

When a user creates a page using a page style, the layout and initial content are copied from the page style to the newly created page. Unlike page templates, page styles are not reference-based. That is, if you change a page style, the change is not inherited in pages that use the style.

Typically, a page style contains components that enhance the usefulness and appearance of a given page. These include an in-place HTML text editor, images, layout boxes, hyperlinks, and so on. Content contributors can further populate the page with content. Figure 6-1 shows a sample portal page that is based on a page style.

Figure 6-1 Sample Page Using a Page Style

Description of "Figure 6-1 Sample Page Using a Page Style"

You can create page styles in either JDeveloper, or from the WebCenter Portal Shared Assets page (or Assets page for individual portals), to use at runtime to create pages. In the runtime, a user creates pages based on the available page styles. When they choose Add Page, the Select a Style dialog displays a set of predefined styles, as shown in Figure 6-2. The user chooses a style and creates a page based on that style. As the layout is already in place in the new page, the user only needs to add content to different areas of the page.

Figure 6-2 Select a Style Dialog

Description of "Figure 6-2 Select a Style Dialog"

The following prerequisites and guidelines may be helpful when developing page styles to be exposed as WebCenter Portal assets:

• If a page style is based on a page template, then while designing the page style JSF (.jspx) file, add the content facet, or any other facet defined in the page template, to contain page content.

• To make the page customizable, add a Page Customizable component within the content facet. As the Page Customizable contains a child panelCustomizable component by default, users can add content to the page at runtime.

• To enable dynamic selection of the page template to use for the page style, in the page style JSF (.jspx) file, specify that the page template is defined in the page style's page definition, as follows:

  <af:pageTemplate value="#{bindings.pageTemplateBinding.templateModel}" id="T">
  

  You can then specify an EL value in the page style page definition to retrieve the name of the page template from the default page template setting, as follows:

  <page viewId="#{preferenceBean.defaultPageTemplateViewId}" 
  id="pageTemplateBinding" Refresh="ifNeeded"/>
  

  At runtime, users with the appropriate permissions can switch to a different page template by selecting a new default page template in the runtime administration console. For more information, see Choosing a Default Page Template in Administering Oracle WebCenter Portal.

• You can create a managed bean that controls which page template to use, as shown in the following example:

  Example: Managed Bean to Control Page Template

  public class siteTemplatesManager {
  final private String templateA ="/templateA.jspx";
   final private String templateB ="/templateB.jspx";
   private String currentSiteTemplateViewId;
   
  public siteTemplatesManager() {
  super();
   currentSiteTemplateViewId =templateA;
   }
  public String gettemplateViewId() {
  return currentSiteTemplateViewId;
   }
  public void settemplateAViewId(ActionEvent ae) {
  currentSiteTemplateViewId =templateA;
   }
  public void settemplateBViewId(ActionEvent ae) {
  currentSiteTemplateViewId =templateB;
   }
  }

This section describes how to create a WebCenter Portal asset application for a new page style. Once the asset application with its associated artifacts has been created, you can continue by modifying the page style's JSPX file as described in Editing a Page Style.

This section includes the following topics:

• How to Create a Page Style

• What You May Need to Know About Page Style Artifacts

1. In the Application Navigator, right-click the page style's JSPX file, and choose Open (Figure 6-5).

   Figure 6-5 Page Style JSPX File

   
   Description of "Figure 6-5 Page Style JSPX File"
2. In the visual editor, make any changes to the layout of content of the page style in the same way as you would edit any page.
   For information about best practices for defining the content of the page style, see Best Practices for Creating Page Styles. For information about the files created for a page style asset application, see What You May Need to Know About Page Style Artifacts.
3. Save your changes.
4. Publish and test the page style as shown in Publishing a Page Style.