Troubleshooting Regions and Tabs

10-40 Oracle Fusion Middleware Users Guide for Oracle Portal I specified a region to be a particular width, but when I add content, the region is wider. Region widths and heights never cause content to truncate. No matter what values you set, regions always expand to accommodate content. If exacting region proportions matter to your portal, you must size content to fit your regions. If you cannot immediately see why the page content is expanding the width of the region, it might be helpful to look at the page source. I’m creating a translation in a language that reads left to right. How can I configure my page to accommodate this? Edit your page regions’ item alignment options. Item region alignment options include the values Start and End. Start and End work in conjunction with portals using bidirectional languages. For languages reading right to left, Start aligns items right and End aligns items left. For languages reading left to right, Start aligns items left and End aligns items right. Tab regions also include the Start and End alignment options. The Display Name I entered for a tab is not displaying on the tab. Are you using you own tab images, rather than those supplied by Oracle Portal? When you use your own tab images, the images themselves must include the text you want to display. In such cases, the Display Name you enter for the tab in tab properties is uses as the tab’s Alt text. It displays when users move their mouse pointers over the tab. I uploaded an image, and set Item Icon Height and Width values for the region, but this had no effect on the image. Item Icon Height and Width values do not affect image items, but rather Image attributes. That is, they apply to images uploaded in support of the item rather than images used as the item’s main content. For example, when you upload a file item, you have the option of providing a value for the file item’s Image attribute. This is the type of image that is affected by a region’s Item Icon Height and Width properties. The base item type Image, does not include the Image attribute. Though you could create a custom item type based on the Base Image item type, and include an Image attribute with that. When I add a tab to a region, it aligns Center, but when I edit the tab region, its alignment option is set to Left. Additionally, Center is not on the list of tab alignment options. When you add a tab to a center-aligned region, the tab is initially centered—even though Center is not a tab alignment option. To change the alignment of the tab, edit the tab region, select an alignment option, and click OK. If Left is already selected, though the tab is displaying Center, clicking OK will reset the tab alignment to Left. You may note that when you edit the tab region, left-alignment is already selected for the region. Nonetheless, the tab does not initially display left-aligned because it has taken its defaults from the region from which it was created. I cannot delete a tabregion from my Portal Template. You can delete tabs and regions from Portal Templates only if no users have added content to the tab or region on pages that are based on the template. This is to prevent users without the appropriate privileges from managing content. 11 Working with Colors and Fonts 11-1 11 Working with Colors and Fonts Oracle Portal provides a set of easy-to-use tools for specifying styles for your portal. Use styles to specify colors and fonts for elements related to portlets, items, tabs, and common elements, such as page backgrounds and region banner colors. Figure 11–1 Use Styles to Add Color and Text Design to a Page This chapter discusses how to create, delete, and apply styles. It contains the following sections: ■ Section 11.1, Understanding Style Basics ■ Section 11.2, Creating a Style ■ Section 11.3, Style Element Properties ■ Section 11.4, Defining Styles for Items ■ Section 11.5, Defining Styles for Portlets ■ Section 11.6, Defining Styles for Tabs 11-2 Oracle Fusion Middleware Users Guide for Oracle Portal ■ Section 11.7, Defining Common Style Elements ■ Section 11.8, Applying a Style ■ Section 11.9, Making a Style Available to Other Users ■ Section 11.10, Editing a Style ■ Section 11.11, Deleting a Style ■ Section 11.12, Using Portal Style Element Classes in HTML Templates and CSSs ■ Section 11.13, Troubleshooting Styles Intended Audience This chapter is intended for users who will work with styles. To apply a style to a page, you must have at least the page privilege Manage Style on the relevant page. Additionally, the option Allow Privileged Users to Manage Page Styles must be selected for the page’s page group. The page privilege Manage Style enables you to create and work with your own styles. To work with styles that you did not create, you must have at least the page group privilege Manage Styles on the relevant page group. With this privilege, you can create styles in any page group, but you can apply styles only to pages on which you have the page privilege Manage Style, and only when the option Allow Privileged Users to Manage Page Styles is selected for the relevant page group. If a particular task requires different privileges than those listed here, those privileges will be listed before the steps of that task.

11.1 Understanding Style Basics

A style controls the colors and fonts used by pages and item regions and all the tabs, portlets, and items displayed within them. If you want a page or group of pages to use the same colors and fonts, apply a style. On the other hand, if you want to apply a consistent layout to a group of pages, use a template. Because you can apply a style to a template, you can use a template to provide a standard approach to layout, fonts, and colors. You can give all your pages a uniform appearance by applying a single style. This means that you can change the look of all your pages just by changing the style the pages use. If you prefer, you can apply different styles to give each page a distinct look. You can even apply different styles to the item regions within a page. Use care when editing a style: the changes you make affect the appearance of all pages and item regions that use the style. When you delete a style, all pages that use the style revert to the page group default style, or the system default style if the page group default style is None. The amount of control you have over the style of a page depends on your page and page group access privileges: ■ The portal administrator can perform any action on any style in any page group. Note: For information about choosing a default style for a page group, see Chapter 4, Working with Page Groups . For information on using templates with Oracle Portal, see Chapter 12, Providing a Standard Look and Feel . Working with Colors and Fonts 11-3 ■ If you have the page group privilege Manage Styles, you can perform any action on any style in the page group. ■ If you have the page privilege Manage or Manage Style and the Allow Privileged Users To Manage Page Style check box is selected for the page group, you can apply a different style to the page, edit existing styles to change the colors and fonts used, or create new styles. If Allow Privileged Users… is not selected, only portal administrators or users with the page group privilege Manage All or Manage Styles can apply a different style to pages in the page group. ■ If you have the page privilege Personalize Style or greater on a page and the Allow Privileged Users To Personalize Page Style check box is selected for the page group, you can apply a different style to your view of the page. If the Allow Privileged Users To Personalize Page Style check box is not selected, no user can apply a different style when personalizing a page.

11.2 Creating a Style

In just a few simple steps, you can create a style for your page group—or for all page groups if you create the style in the Shared Objects page group. Once the style is created, the next step is to define it. This section explains how to create a style; subsequent sections explain how to define it. To create a style: 1. Log in to Oracle Portal.

2. Click the Build tab to bring it forward.

3. From the Page Groups portlet Work In drop-down list, select a page group to own the style. By default, the Page Groups portlet is located on the Build tab of the Portal Builder page.

4. In the Layout Appearance section, click the Create link next to the Styles

heading.

5. In the Display Name field, enter a display name for the style.

Use up to 350 characters of any kind. The display name identifies the style in the Page Groups portlet and the Portal Navigator.

6. In the Copy From list, select a style that most closely matches the colors and fonts

to use in your new style. This list includes the styles to which you have access privileges, including shared styles and any styles you created. Tip: If you plan to use this style in more than one page group, create it in the Shared Objects page group. Note: In the Oracle Portal user interface, an asterisk indicates a field that requires a value. For a summary of the rules governing the naming of objects in Oracle Portal, see Appendix D, Object Naming Rules in Oracle Portal . 11-4 Oracle Fusion Middleware Users Guide for Oracle Portal

7. Optionally Select Make available for use in this page group to make this style

available for other users to apply to their own pages, or to use as a starting point for their own styles.

8. Click Create.

Section 11.3, Style Element Properties provides tables that list and describe the style element properties available for items, tabs, portlets, and common components. See the following subsections for specifics on designing a style: ■ Section 11.4, Defining Styles for Items ■ Section 11.5, Defining Styles for Portlets ■ Section 11.7, Defining Common Style Elements Additionally, see Section 11.10, Editing a Style for information on editing styles.

11.3 Style Element Properties

The tables in the following subsections list and describe the types of user interface elements to which you can apply a style. It is divided into the following subsections: ■ Section 11.3.1, Items ■ Section 11.3.2, Tabs ■ Section 11.3.3, Portlets ■ Section 11.3.4, Common

11.3.1 Items

Table 11–1 lists and describes style element properties that apply to items.

11.3.2 Tabs

Table 11–2 lists and describes style element properties that apply to tabs. Note: If you do not see this check box, you do not have style publishing privileges. Contact your portal administrator to request these privileges. Table 11–1 Style Element Properties that Apply to Items Property Description Group By Banner Determines the color, height, and alignment of text in the banners for each group of items in a page. Group By Text Determines the color, font face, font size, font style, and font decoration of regular text in the banners for each group of items in a page. Group By Link Determines the color, font face, font size, font style, and font decoration of links in the banners for each group of items in a page. Other Attributes These determine the color, font face, font size, font style, and font decoration of the attributes that appear next to items on the page. For example Category, Create Date, and so on. Working with Colors and Fonts 11-5

11.3.3 Portlets

Table 11–3 lists and describes style element properties that apply to portlets. Table 11–2 Style Element Properties that Apply to Tabs Property Description Active Tab Color Determines the color of the currently displayed tab the active tab. Active Tab Text Determines the color, font face, font size, font style, and font decoration of the text on the currently displayed tab the active tab. Inactive Tab Color Determines the color of tabs that are not currently selected inactive tabs. Inactive Tab Text Determines the color, font face, font size, font style, and font decoration of the text on tabs that are not currently selected inactive tabs. Table 11–3 Style Element Properties that Apply to Portlets Property Description Portlet Header Color Determines the color of portlet headers. Portlet Header Text Determines the color, font face, font size, font style, and font decoration of regular text in portlet headers. Portlet Header Link Determines the color, font face, font size, font style, and font decoration of links in portlet headers. Portlet Header Style Determines whether portlet headers have square or rounded edges. Portlet SubHeader Color Determines the color of portlet subheaders. Portlet SubHeader Text Determines the color, font face, font size, font style, and font decoration of regular text in portlet subheaders. Portlet SubHeader Link Determines the color, font face, font size, font style, and font decoration of links in portlet subheaders. Portlet Body Color Determines the color of the main body of portlets. Note: To ensure that a Page portlet, a navigation page, or a page that is published as a portlet uses its own background color, rather than the one specified for the portlet’s host page: 1. Ensure that the portlet or navigation page uses its own style when it is published as a portlet that is, do not select the option Use Style of Page on Which Portlet Is Placed in the portlet’s or navigation page’s properties, Optional tab. 2. In the style for the page where you place the portlet or navigation page, clear any value from the Portlet Body Color style element and click Apply. Portlet Headingn Determines the color, font face, font size, font style, and font decoration of text in portlets marked with the Portlet Headingn tag. The default list goes to heading level 4. Portlet Textn Determines the color, font face, font size, font style, and font decoration of text in portlets marked with the Portlet Textn tag. The default list goes to text level 4. 11-6 Oracle Fusion Middleware Users Guide for Oracle Portal

11.3.4 Common

Table 11–4 lists and describes style element properties that apply to item regions and pages.

11.4 Defining Styles for Items

You can change the colors and fonts used for item attributes for example, Display Name, Create Date, and any custom attributes by editing the style used by the page or item region that contains them. You can have different color and font settings for each attribute. Figure 11–2 shows the same item region with different item attribute color and font settings. Figure 11–2 Same Item Region with Different Styles Table 11–4 Style Element Properties Common to Item Regions and Pages Property Description Background Determines the color or image used for the background of the page or region. Notes: ■ When a page uses an HTML page skin template, the page background color is taken from the template and any background color specified in a defined style is ignored. An exception to this is when the page skin uses a class generated by an Oracle Portal style. For example, you can place an Oracle Portal style element class in the body HTML tag: BODY style=margin:0px class=Bodyid2siteid0. Should you change the style declaratively, through the Oracle Portal user interface, the change is reflected as well in the template that references the style class. This enables you to change the Background Color of all pages that use the page skin through the declarative style. For more information on Oracle Portal style element classes, see Section 11.12, Using Portal Style Element Classes in HTML Templates and CSSs . ■ If you enter a hexidecimal color value that does not also appear in the color palette, tabs and portlets do not display with rounded corners. Region Banner Determines the color, height, and alignment of text in the banners for each region in a page. Region Banner Text Determines the color, font face, font size, font style, and font decoration of regular text in the banners for each region in a page. Note: To change which attributes are displayed in a region, see Section 10.2.9, Changing the Attributes Displayed in a Region .